添加测试环境

README.md

@@ -2,16 +2,39 @@
 
 单机部署的全局反向代理服务，统一管理 HTTPS 入口。
 
+## 环境说明
+
+生产与测试是**两台隔离的服务器**，各自部署一套网关。两套配置同仓库、同分支，按文件名区分，证书共用泛域名 `*.offerpai.com.cn`。
+
+| 环境 | 配置文件 | 编排文件 | 容器名 |
+|------|----------|----------|--------|
+| 生产 | `nginx.conf` | `docker-compose.yml` | `global-nginx` |
+| 测试 | `nginx.test.conf` | `docker-compose.test.yml` | `global-nginx-test` |
+
+两套配置除 `server_name`（域名）外完全一致，proxy_pass 都指向本机 `172.17.0.1:端口`，因此各自打到所在服务器的本地服务。
+
 ## 域名映射
 
+### 生产环境
+
 | 域名 | 端口 | 说明 |
 |------|------|------|
 | www.offerpai.com.cn | 10302 | OfferPie 前端 |
 | api.offerpai.com.cn | 10202 | OfferPie Java 后端 API |
 | ai.offerpai.com.cn | 10502 | OfferPie Python AI 服务 |
 
+### 测试环境
+
+| 域名 | 端口 | 说明 |
+|------|------|------|
+| test.offerpai.com.cn | 10302 | OfferPie 前端 |
+| test-api.offerpai.com.cn | 10202 | OfferPie Java 后端 API |
+| test-ai.offerpai.com.cn | 10502 | OfferPie Python AI 服务 |
+
 未匹配的域名或 IP 访问返回 444（直接断开连接）。
 
+> 注意：测试域名的 DNS 解析需在域名服务商处指向测试服务器 IP，此步骤不在本仓库管理范围内。
+
 ## 首次部署（Ubuntu 24）
 
 ### 1. 更新系统并安装 Docker
@@ -69,27 +92,42 @@ git checkout master
 
 ### 7. 启动服务
 
+生产服务器：
+
 ```bash
 docker compose up -d --build
 ```
 
+测试服务器：
+
+```bash
+docker compose -f docker-compose.test.yml up -d --build
+```
+
 ## 日常操作
 
 ### 更新配置
 
-修改 `nginx.conf` 后重新构建：
+修改对应环境的配置文件后重新构建：
 
 ```bash
+# 生产：修改 nginx.conf 后
 docker compose up -d --build
+
+# 测试：修改 nginx.test.conf 后
+docker compose -f docker-compose.test.yml up -d --build
 ```
 
 ### 证书更新
 
-替换 `certificate/` 目录下的证书文件后重新构建。
+替换 `certificate/` 目录下的证书文件后重新构建（两套环境共用同一泛域名证书）。
 
 ## 文件说明
 
-- `nginx.conf` - Nginx 主配置
-- `dockerfile` - 镜像构建文件
-- `docker-compose.yml` - 容器编排配置
-- `certificate/` - SSL 证书目录
+- `nginx.conf` - 生产环境 Nginx 主配置
+- `nginx.test.conf` - 测试环境 Nginx 主配置（仅域名不同）
+- `dockerfile` - 生产镜像构建文件
+- `Dockerfile.test` - 测试镜像构建文件
+- `docker-compose.yml` - 生产容器编排配置
+- `docker-compose.test.yml` - 测试容器编排配置
+- `certificate/` - SSL 证书目录（泛域名，两套环境共用）