Waline 是一个基于 LeanCloud 的评论系统，它是 Valine 的一个分支，提供了一些改进和新功能。Waline 旨在为博客、网站和其他在线平台提供简洁、安全的评论服务。



# 准备工作
[Waline官网独立部署文档](https://waline.js.org/guide/deploy/vps.html)，官网采用docker独立部署，更为方便快捷。本文讲述在服务器或者自己电脑上用node包的样式来运行（虽然不知道为什么要在自己电脑上运行，但我5点爬起来就这么干了）

Waline的数据库文件 [waline.sql](https://github.com/walinejs/waline/blob/main/assets/waline.sql)
## 环境变量配置参考表

| 环境变量名称 |必填|默认值|备注|
| ---         | --- | --- | --- |
|MYSQL*HOST   |     | 127.0.0.1 | MySQL 服务的地址 |
| MYSQL_PORT    |     | 3306 | MySQL 服务的端口 |
|   MYSQL_DB |   √  |  | MySQL 数据库库名 |
|  MYSQL_USER  |  √   |  | MySQL 数据库的用户名 |
|  MYSQL_PASSWORD  | √    |  | MySQL 数据库的密码 |
|  MYSQL_PREFIX  |     | wl* | MySQL 数据表的表前缀 |
|  MYSQL_CHARSET  |     | utf8mb4	 | MySQL 数据表的字符集 |
|  MYSQL_SSL  |     |  |  是否使用 SSL MYSQL 连接数据库|

## 方法1

在linux操作系统下，可以直接修改主目录下的.bashrc文件
写入

```bash
export MYSQL_HOST=12.12.12.12
export MYSQL_PORT=3306
export MYSQL_DB=waline
```
填写完成后保存文件并执行以下命令刷新：

```bash
source ~/.bashrc
```
该方法是直接导出系统级的环境变量，使waline 服务端可以从process.env对象中顺利读取到，而这样定义的全局环境变量存在一个弊端，就是会污染到全局，可能会干预到其他项目，而且 windows 与 linux 的配置方法各不相同。所以这里并不推荐，而是更推荐使用方案二

## 方法2
在使用Node.js进行项目开发时，可以通过`process.env`对象访问环境变量。而`dotenv`是一个流行的Node.js库，它允许你将环境变量配置在一个`.env`文件中，这个文件通常位于项目的根目录下。使用`dotenv`的好处是不会污染全局环境变量，并且可以使配置和代码分离，便于管理和维护。

1. **安装dotenv**：首先，需要在你的Node.js项目中安装`dotenv`库。
   ```sh
   npm install dotenv
   ```

2. **创建.env文件**：在项目的根目录下创建一个`.env`文件，并在其中定义所需的环境变量。
   ```env
   # .env 文件示例
   MYSQL_HOST=127.0.0.1
   MYSQL_PORT=3306
   MYSQL_DB=waline
   MYSQL_USER=root
   MYSQL_PASSWORD=yourpassword
   ```

3. **创建入口文件**：在入口文件`main.js`顶部引入并配置`dotenv`。
   ```javascript
    / 引入dotenv
    const dotenv = require('dotenv')
    // 调用config方法合并.env环境变量
    dotenv.config()
    // 引入并执行该文件
    require('@waline/vercel/vanilla.js')   ```

使用`dotenv`的好处是，它只在当前项目中有效，不会影响到其他项目或全局环境。此外，`.env`文件通常不会被加入到版本控制系统（如git），这样可以避免敏感信息（如数据库密码）泄露。


至此，项目构建完成，可以在本地启动进行测试

![image.png](/static/img/c49acb7177df380decd914cca8d96957.image.webp)

Waline 服务端独立部署解决方案

![xfsd (1).jpg](/static/img/2f980a5a771e834cf68b88b918fdee0e.xfsd%20(1).webp)



![xfsd (2).jpg](/static/img/bf81aa6936c6c3426d0ef6c33b2c0317.xfsd%20%282%29.webp)

![](/static/img/670e6c89ad08ccbda540d7325ae6a9c1.xfsd%286%29.webp)

![](/static/img/74fcce2a70daaf554db84bafb8f8e75f.xfsd%287%29.webp)

![xfsd (4).jpg](/static/img/b3aed9c29475955b4d9caf761ffac1a4.xfsd%20%284%29.webp)

![xfsd (5).jpg](/static/img/62cfcda455e61c0dd5795922365654d3.xfsd%20%285%29.webp)

![xfsd (5).jpg](/static/img/7aa7087a408053489f2cddd2e30371c8.xfsd%20%283%29.webp)

记-先锋书店

# 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安装及避坑指南

script

msvalidate.01

link

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