# api开发-更优雅的[规范响应数据]

## 统一响应函数
```node
function sendResponse(res, status, message, data = {}, error = {}) {
    res.json({
        status: status === 200 ? 'success' : 'error',
        code: status,
        message: message,
        data: data,
        error: error
    });
}
```
```node
{
    "status": "success",
    // 描述 HTTP 响应结果：HTTP 状态响应码在 500-599 之间为”fail”，在 400-499 之间为”error”，其它均为”success”
    "code": 200,
    // 包含一个整数类型的 HTTP 响应状态码，也可以是业务描述操作码，比如 200001 表示注册成功
    "message": "操作成功",
    // 多语言的响应描述
    "data": {
    // 实际的响应数据
        "nickname": "Joaquin Ondricka",
        "email": "lowe.chaim@example.org"
    },
    "error": {}
    // 异常时的调试信息
}
```
- 统一的数据响应格式，固定包含：code、status、data、message、error
- 内置 Http 标准状态码支持，同时支持扩展 ResponseCodeEnum 来根据不同业务模块定义响应码
- 响应码 code 对应描述信息 message 支持本地化，支持配置多语言
- 合理地返回 Http 状态码
- 根据 debug 开关，合理返回异常信息、验证异常信息等

## 调用方法
```node
// 处理GET请求，获取用户信息
app.get('/api/sql/', async (req, res) => {
    const userId = req.query.id;
    try {
        const userInfo = await userModule.getUserInfo(userId);
        sendResponse(res, 200, "操作成功", userInfo);
    } catch (error) {
        console.error('Error fetching user info:', error);
        sendResponse(res, 500, "服务器错误", {}, { message: error.message });
    }
});
```

getUserInfo函数是一个SQL查询的函数，返回一个数组
将响应码 描述 数据 都通过通用操作函数来处理，达到规范化的效果

api开发-更优雅的[规范响应数据]

sqli 1-7关

# Nginx Proxy Manager 安装与使用指南

## 前言

这篇文章介绍了如何安装 **Nginx Proxy Manager**，一款基于 Nginx 的反向代理管理工具，以及在使用过程中可能遇到的问题和解决方法。文章提供了安装和配置 Nginx Proxy Manager 的简要步骤，并详细介绍了如何避免常见问题，例如无法反代某些网站、SSL 证书配置错误等。通过本文提供的避坑指南，你可以更轻松地使用 Nginx Proxy Manager，享受更好的反向代理体验。
## 使用`Docker`安装
### 拉取镜像
```bash
docker pull jc21/nginx-proxy-manager:latest
```
### 使用镜像构建容器
```bash
docker run -d -p 80:80 -p 81:81 -p 443:443 --restart=always -v ~/data:/data -v ~/letsencrypt:/etc/letsencrypt jc21/nginx-proxy-manager:latest
```
- docker run：这是 Docker 用来创建和启动容器的命令。
- -d：表示以守护进程模式运行容器，即在后台运行。
- -p 80:80：将容器内部的 80 端口映射到宿主机的 80 端口，通常用于 HTTP 服务。
- -p 81:81：将容器内部的 81 端口映射到宿主机的 81 端口，可能用于其他服务或管理界面。
- -p 443:443：将容器内部的 443 端口映射到宿主机的 443 端口，通常用于 HTTPS 服务。
- --restart=always：设置容器的重启策略为始终尝试重启容器。
- -v ~/data:/data：将宿主机的 ~/data 目录挂载到容器的 /data 目录，用于持久化存储数据。
- -v ~/letsencrypt:/etc/letsencrypt：将宿主机的 ~/letsencrypt 目录挂载到容器的 /etc/letsencrypt 目录，用于存储 Let's Encrypt 证书。
- jc21/nginx-proxy-manager:latest：指定要运行的 Docker 镜像名称和标签，这里是 nginx-proxy-manager 的最新版本。
## 使用`Docker Compose`安装

### 安装 Docker 和 Docker Compose

Nginx Proxy Manager 是通过 **Docker** 部署的，因此首先需要在你的服务器上安装 **Docker** 和 **Docker Compose**

对于大多数 Linux 发行版，可以使用以下命令安装 Docker：

```bash
curl -fsSL https://get.docker.com > get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable docker
sudo systemctl start docker
sudo usermod -aG docker $USER
```

### 接下来，安装 Docker Compose：
```bash
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
```

### 配置 Nginx Proxy Manager
创建一个新目录来存放 Nginx Proxy Manager 的配置文件和数据：

```bash
mkdir nginx-proxy-manager
cd nginx-proxy-manager
```
在该目录下创建一个名为 **docker-compose.yml** 的文件，并添加以下内容：
```bash
version: '3'
services:
  app:
    image: jc21/nginx-proxy-manager:latest
    restart: always
    ports:
      - "80:80"
      - "81:81"
      - "443:443"
    environment:
      - DB_MYSQL_HOST=db
      - DB_MYSQL_PORT=3306
      - DB_MYSQL_USER=npm
      - DB_MYSQL_PASSWORD=npm
      - DB_MYSQL_NAME=npm
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
  db:
    image: yobasystems/alpine-mariadb:latest
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=npm
      - MYSQL_DATABASE=npm
      - MYSQL_USER=npm
      - MYSQL_PASSWORD=npm
    volumes:
      - ./data/mysql:/var/lib/mysql
   ```
   
### 启动 Nginx Proxy Manager
在包含 **docker-compose.yml** 文件的目录中，运行以下命令启动 Nginx Proxy Manager 和数据库容器：
```bash
docker-compose up -d
```
### 访问 Nginx Proxy Manager 管理界面
等待几分钟，让容器启动并初始化。然后在浏览器中访问服务器的 IP 地址或域名，端口为 81。例如：http://your-server-ip:81。默认的管理员用户名和密码分别为 admin@example.com 和 changeme。首次登录后，请确保更改默认密码。

## 避坑
### 检查目标服务器
确保你反代的网站可以正常访问。在浏览器或使用 curl 命令检查目标网站是否正常运行。

### 检查 Nginx Proxy Manager 的反向代理设置
登录到 Nginx Proxy Manager 管理界面，然后依次点击 "Proxy Hosts" > "Add Proxy Host"。确保以下设置正确：

- 域名：在 "Domain Names" 区域中输入你要使用的域名。
- 协议：在 "Scheme" 区域选择 "https"。
- 转发主机名和端口：在 "Forward Hostname / IP" 区域中输入目标服务器的地址，并在 "Forward Port" 区域中输入端口号，例如：443。
- WebSocket 支持：如果目标网站使用了 WebSocket，确保勾选 "Websockets"。
- 检查 SSL 证书
由于目标网站使用了 HTTPS，你可能需要为反向代理域名配置 SSL 证书。在 Nginx Proxy Manager 的 "Proxy Hosts" 选项卡中，找到刚刚创建的反向代理条目，然后点击右侧的绿色 "Edit" 图标。切换到 "SSL" 选项卡，选择 "Request a new SSL Certificate"，勾选 "Force SSL" 和 "HTTP/2 Support"，然后点击 "Save"。

### 检查 Nginx 配置
如果问题仍然存在，可以查看 Nginx Proxy Manager 生成的 Nginx 配置文件。在你创建的 "nginx-proxy-manager" 目录中，找到 "data/nginx/proxy_host" 目录。在这个目录下，找到与你的域名相关的配置文件（例如，2.conf），检查其中的反向代理设置是否正确。

### 重启 Nginx Proxy Manager
在某些情况下，重启 Nginx Proxy Manager 可能有助于解决问题。在包含 docker-compose.yml 文件的目录中，运行以下命令：
```bash
docker-compose down
docker-compose up -d
```
### 修改 Nginx 配置以传递主机头
尝试修改 Nginx Proxy Manager 生成的配置文件，以将原始主机头传递给目标服务器。在 2.conf 文件中找到以下行：
```bash
include conf.d/include/proxy.conf;
```
然后将其替换为以下内容：
```bash
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $http_host;
proxy_set_header X-Forwarded-Port $server_port;
proxy_pass $forward_scheme://$server:$port;
```
保存更改后，需要重启 Nginx Proxy Manager 以使更改生效。

### 检查网络连接和防火墙设置
确保没有任何网络连接问题或防火墙设置阻止了请求。检查服务器上的防火墙规则，确保允许通过 80、443 和 81 端口的传入连接。同时，确认目标服务器的防火墙设置允许从 Nginx Proxy Manager 发起的连接。

使用ubuntu默认的**ufw**防火墙来开放端口
```bash
sudo ufw allow 80/tcp
sudo ufw allow 81/tcp
sudo ufw allow 443/tcp
```

Nginx Proxy Manager安装及避坑指南

https://github.com/CasearF/Xiaomi-Mall-Home
小米商城首页（Someone's practical training assignment）

Xiaomi-Mall-Home

# 安装及配置容器

**拉取镜像**，这里使用的是[OWASP Mutillidae II 靶场](https://github.com/webpwnized/mutillidae)
```bash
docker pull citizenstig/nowasp
```
**启动容器**，在启动容器的时候要使用`-p`参数来提前映射好所需的端口。这里映射了正常的80端口和额外的10008端口，10008端口用来充当docker内部的ssh的端口
```bash
docker run -d -p 80:80 -p 10008:10008 citizenstig/nowasp
```
**查看容器状态**，使用`docker ps`或`docker ps -a`

![image.png](https://img.casear.net/img/7f2b480b164190ea541be9c9c1d3323e.image.webp)

**设置docker和指定容器自启动**

```bash
#设置docker自启动
systemctl enable docker
#设置容器自启动
docker update --restart=always <容器id>
```
**进入容器**,`docker exec -it <容器id> /bin/bash`

![image.png](https://img.casear.net/img/6fe80b960cde1d1f372e95407fded586.image.webp)

**安装ssh**,更新软件包和安装ssh
```bash
apt-get update
apt-get install openssh-server openssh-client ssh vim
```
**修改ssh信息**，以对应启动容器时映射的端口
```bash
#修改ssh的配置文件
vim /etc/ssh/sshd_config
```
在**sshd_config**修改以下内容
```bash

#修改端口为映射的端口
Port 10008
#允许root用户使用ssh登录
PermitRootLogin yes
```
**重启ssh服务**
```bash
/etc/init.d/ssh restart
```
**设置密码**
```bash
passwd root
```
**设置自启动ssh**

打开文件/root/.bashrc`vim /root/.bashrc`<br>
在`.bashrc`末尾添加`service ssh start`
# 使用vscode配置
在vscode主页面 $\color{red}{ctrl}$ + $\color{red}{shift}$  + $\color{red}{p}$
![image.png](https://img.casear.net/img/37f90406c69c35f7351a01974a213587.image.webp)
选择自己的配置文件，不知道选哪个就第一个

![image.png](https://img.casear.net/img/a1f71ce8f0fcac4462556671ea8fb518.image.webp)

在文件中添加

![image.png](https://img.casear.net/img/25b759358dd7aa0c43b4274d8c5db5b5.image.webp)
```模板
Host <name>
  HostName <服务器IP>
  Port 10008
  User root
  ForwardAgent yes
```
完成后即可正常使用

![image.png](https://img.casear.net/img/7bdab04446443d1a853530c48e2143f2.image.webp)

vscode连接docker查看代码

如果你有机会到好望角，请在海边的石头上刻下我的故事👨‍💻