# 安心验后端 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`