first

2026-05-11 15:28:27 +08:00
commit 9aac78b8da
289 changed files with 67193 additions and 0 deletions
--- a/docs/deploy/backend-api-online-deploy.md
+++ b/docs/deploy/backend-api-online-deploy.md
@@ -0,0 +1,157 @@
+# 安心验后端 API 线上部署说明
+
+## 1. 当前部署目标
+
+- API 域名：`api.anxinjianyan.com`
+- 项目目录建议：`/www/wwwroot/anxinyan-api`
+- 服务监听端口：`8787`
+
+当前后端基于 `webman`，推荐部署方式：
+
+1. 代码上传到服务器
+2. 使用 `php start.php start -d` 启动常驻进程
+3. 使用 `Nginx` 反向代理到 `127.0.0.1:8787`
+4. 用 `systemd` 管理进程自启动
+
+## 2. 本次已准备好的发布包
+
+发布包路径：
+
+- [/Users/wushumin/www/biyou/anxinyan/releases/anxinyan-server-api-20260422.zip](/Users/wushumin/www/biyou/anxinyan/releases/anxinyan-server-api-20260422.zip)
+
+建议上传后解压到：
+
+```bash
+mkdir -p /www/wwwroot/anxinyan-api
+unzip anxinyan-server-api-20260422.zip -d /www/wwwroot/anxinyan-api
+```
+
+## 3. 服务器要求
+
+- PHP 8.1+
+- 扩展：
+  - `pdo`
+  - `pdo_mysql`
+  - `pcntl`
+  - 建议 `opcache`
+- MySQL 8+
+- Redis 6/7
+- `Nginx`
+- `systemd`
+
+## 4. 部署步骤
+
+### 4.1 上传并解压
+
+```bash
+cd /www/wwwroot
+mkdir -p anxinyan-api
+tar -xzf /path/to/anxinyan-server-api-20260422.tar.gz -C anxinyan-api
+cd anxinyan-api
+```
+
+### 4.2 检查目录权限
+
+```bash
+mkdir -p runtime/logs storage/payment-certs
+chmod -R 775 runtime storage
+```
+
+### 4.3 确认环境变量
+
+发布包中已包含当前 `.env`，但上线前仍需人工确认：
+
+- `APP_ENV=production`
+- `APP_DEBUG=false`
+- 数据库连接是否为正式库
+- Redis 连接是否为正式实例
+
+## 5. 启动命令
+
+### 首次启动
+
+```bash
+cd /www/wwwroot/anxinyan-api
+php start.php start -d
+```
+
+### 重载
+
+```bash
+cd /www/wwwroot/anxinyan-api
+php start.php reload -d
+```
+
+### 停止
+
+```bash
+cd /www/wwwroot/anxinyan-api
+php start.php stop
+```
+
+## 6. Nginx 配置
+
+示例文件：
+
+- [api.anxinjianyan.com.nginx.conf.example](/Users/wushumin/www/biyou/anxinyan/docs/deploy/api.anxinjianyan.com.nginx.conf.example)
+
+核心逻辑：
+
+- 对外监听 `80/443`
+- 反向代理到 `127.0.0.1:8787`
+- 保留真实 IP、协议头和 Host
+
+## 7. systemd 配置
+
+示例文件：
+
+- [anxinyan-api.service.example](/Users/wushumin/www/biyou/anxinyan/docs/deploy/anxinyan-api.service.example)
+
+放置路径建议：
+
+```bash
+/etc/systemd/system/anxinyan-api.service
+```
+
+启用命令：
+
+```bash
+systemctl daemon-reload
+systemctl enable anxinyan-api
+systemctl start anxinyan-api
+systemctl status anxinyan-api
+```
+
+## 8. 上线后立即检查
+
+### 接口联通
+
+```bash
+curl http://127.0.0.1:8787/
+curl https://api.anxinjianyan.com/
+```
+
+### 冒烟验证
+
+```bash
+cd /www/wwwroot/anxinyan-api
+php tools/smoke_check.php
+php tools/release_audit.php
+```
+
+## 9. 当前仍需人工确认的阻塞项
+
+- 小程序正式配置：
+  - `mini_program.app_id`
+  - `mini_program.app_secret`
+  - `mini_program.original_id`
+
+## 10. 特别说明
+
+- 当前数据库中的支付证书路径仍是本机绝对路径，若线上要用微信支付，建议在服务器后台重新上传：
+  - `apiclient_key.pem`
+  - `apiclient_cert.pem`
+- 后台系统配置中的支付回调地址已调整为：
+  - `https://api.anxinjianyan.com`
+- H5 页面根地址已调整为：
+  - `https://m.anxinjianyan.com`