安装 EZ-Encrypt 中间件 教程

既然你已经下载了 proxy-server-amd64 文件，那么你不需要编译。这个文件已经是作者针对 Linux AMD64 架构编译好的“成品”，直接运行即可。

以下是结合你 aaPanel（宝塔面板）环境的详细部署步骤：

第一步：文件准备与授权

1. 上传文件：通过 aaPanel 的“文件”管理，在 /www/wwwroot/ 下新建一个目录（例如 /www/wwwroot/ez-api），把 proxy-server-amd64 上传进去。
2. 重命名（可选）：为了方便命令输入，建议把文件改名为简短的名字，比如 ez-api。
3. 赋予执行权限：打开 aaPanel 的终端（Terminal），进入该目录并授权：Bashcd /www/wwwroot/ez-api chmod +x ez-api

第二步：创建配置文件 .env

在 /www/wwwroot/ez-api 目录下新建一个名为 .env 的文件，并参考以下内容填写：

代码段

# 1. 基础服务器设置
PORT=20008                                  # 服务器监听端口
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. 支付回调免验证路径
# 多条用英文逗号分隔，须写完整路径（含前缀）
# 例如: /api/v1/guest/payment/notify/EPay/12345, /api/v1/guest/payment/notify/Alipay/ABC123
ALLOWED_PAYMENT_NOTIFY_PATHS=

# 5. AES 加解密配置
# 中间件加密KEY必须是16位的16进制字符串，必须和前端key保持一致
AES_KEY=4c6f8e5f9467dc71