EZ 加密中间件教程 (简易版 + 进阶版)

本教程以 中间件和 V2Board 管理员后端在同一服务器 (宝塔面板) 搭建为例。
如果你的后端和中间件在不同服务器上，方法类似。

一、新手小白：直接下载 Release 产物 (推荐)

无需安装 Go 环境，直接使用作者编译好的二进制文件即可。

1. 下载 Release 产物 (以 AMD64 为例)

Releases · Mtoly/EZ-Encrypt-Middleware

EZ-开源加密中间件. Contribute to Mtoly/EZ-Encrypt-Middleware development by creating an account on GitHub.

GitHub

BASH

# 切换到 root 目录
cd /root

# 赋予执行权限 ez-api 为可执行文件名，你可以随意修改
chmod 777 ez-api

⚠️ 注意：如果你的服务器是 ARM 架构，请在 Release 页面选择对应的 arm64 版本。

2. 配置 `.env` 文件

进入目录并编辑配置文件：

BASH

nano .env

参考配置：

BASH

# 1. 基础服务器设置
PORT=3939                                  # 中间件监听端口
BACKEND_API_URL=https://api.xxx.com        # 后端真实 API 根地址 (不带 /api/v1，无尾斜杠)
PATH_PREFIX=/ez/ez                         # 路径前缀；为空 "" 则处理所有请求

# 2. CORS / 安全设置
CORS_ORIGIN=*                              # 允许的 CORS 源
ALLOWED_ORIGINS=*                          # 请求来源白名单
REQUEST_TIMEOUT=30000                      # 请求超时(ms)
ENABLE_LOGGING=false                       # 是否输出请求日志
DEBUG_MODE=false                           # 是否输出调试日志

# 3. 支付回调免验证路径 (可选)
ALLOWED_PAYMENT_NOTIFY_PATHS=

# 4. AES 加解密配置
AES_KEY=4c6f8e5f9467dc71                   # 必须与前端一致 (16 位 16进制字符串)

3. 宝塔进程守护管理器

添加进程守护，让中间件常驻运行：

BASH

# Name
ez-api

# Run User
root

# Process directory
/root/

# Start command
/root/ez-api

4. 宝塔反向代理

新建站点 (域名如 ez.api)，解析到 VPS，并配置反向代理：

BASH

Target URL: http://127.0.0.1:3939

并申请 SSL 证书。

5. 修改前端配置 `/src/config/index.js`

API_MIDDLEWARE_URL: "https://ez.api"
API_MIDDLEWARE_KEY: "4c6f8e5f9467dc71"

EZ中间件搭建

EZ 加密中间件教程 (简易版 + 进阶版)

一、新手小白：直接下载 Release 产物 (推荐)

1. 下载 Release 产物 (以 AMD64 为例)

2. 配置 `.env` 文件

3. 宝塔进程守护管理器

4. 宝塔反向代理

5. 修改前端配置 `/src/config/index.js`

二、进阶高手：自行编译

EZ中间件搭建

EZ 加密中间件教程 (简易版 + 进阶版)

一、新手小白：直接下载 Release 产物 (推荐)

1. 下载 Release 产物 (以 AMD64 为例)

2. 配置 .env 文件

3. 宝塔进程守护管理器

4. 宝塔反向代理

5. 修改前端配置 /src/config/index.js

二、进阶高手：自行编译

2. 配置 `.env` 文件

5. 修改前端配置 `/src/config/index.js`