# YouleGames Docker 部署版

> 原项目 `codes/agent/game` 的 Docker 化改造，所有硬编码域名/IP/密码已外部化为环境变量，通过单一 `.env` 文件控制所有配置。

---

## 目录结构

```
game-docker/
├── .env.example                # 环境变量模板（部署时复制为 .env）
├── docker-compose.yml          # Docker Compose 编排（8 个服务）
├── deploy.sh                   # 一键部署脚本
├── init-ssl.sh                 # SSL 证书首次申请脚本
├── env_config.php              # PHP 环境变量加载器（api/ 和 dlweb/ 共用）
├── api/                        # 网站1: 游戏核心 API 服务源码
├── dlweb/                      # 网站2: 代理管理后台源码
├── wxserver_daoqi/             # 网站3: 微信小程序后端源码
├── docker/
│   ├── nginx/
│   │   ├── default.conf.template   # Nginx 配置模板（envsubst 动态域名注入）
│   │   └── ssl-params.conf         # SSL 安全参数
│   ├── api/
│   │   ├── Dockerfile              # API 镜像（PHP 8.1 + Apache）
│   │   └── docker-entrypoint.sh    # 启动时 sed 替换 JS 中硬编码域名
│   ├── dlweb/
│   │   ├── Dockerfile              # DLWEB 镜像（PHP 8.1 + Apache + Redis ext）
│   │   └── docker-entrypoint.sh    # 启动时 sed 替换 JS/HTML 中硬编码域名
│   ├── wxserver/
│   │   └── Dockerfile              # wxserver 镜像（Node.js 18 Alpine）
│   ├── syncjob/
│   │   └── sync.sh                 # Synchronize.php 轮询脚本（每 30s）
│   ├── cronjob/
│   │   ├── entrypoint.sh           # cron 容器入口
│   │   └── daily-task.sh           # 每日定时任务（替代 autorun.cmd）
│   └── certbot/                    # SSL 证书相关
└── game/                           # 原始未修改代码备份（不参与部署）
```

---

## 整体架构

```
                         互联网
                           │
                    ┌──────┴──────┐
                    │    Nginx    │ ← SSL 终端 + 域名路由
                    │  :80 :443  │   域名通过 .env 注入
                    └──┬───┬───┬─┘
           ┌───────────┤   │   ├───────────┐
           ▼           ▼   │   ▼           │
    ┌────────────┐ ┌────────┴──┐ ┌──────────┐
    │    API     │ │   DLWEB   │ │ wxserver │
    │  PHP 8.1   │ │  PHP 8.1  │ │ Node.js  │
    │  Apache    │ │  Apache   │ │  :3000   │
    └─────┬──────┘ └─────┬─────┘ └──────────┘
          │              │
          │    ┌─────────┤ Docker 内网 (youle-net)
          │    │         │
          │    ▼         │
          │ ┌──────────┐ │     ┌───────────┐     ┌───────────┐
          │ │ syncjob  │◄┼────►│  cronjob  │     │  certbot  │
          │ │ 每30s轮询 │ │     │ 每日4:00  │     │ 12h续签   │
          │ └──────────┘ │     └───────────┘     └───────────┘
          │              │
          ▼              ▼
    ┌──────────────────────────┐     ┌──────────┐
    │   MySQL (阿里云 RDS)      │     │  Redis   │
    │   多实例：agent_db /      │     │  :6379   │
    │   game_db / grade_db     │     └──────────┘
    └──────────────────────────┘
```

### 服务清单（8 个容器）

| 容器名 | 镜像 | 作用 | 端口 |
|--------|------|------|------|
| `youle-nginx` | nginx:alpine | SSL 终端 + 域名路由反向代理 | 80, 443 |
| `youle-api` | php:8.1-apache (自定义) | 游戏核心 API（登录/支付/SDK） | 8081 (内部) |
| `youle-dlweb` | php:8.1-apache (自定义) | 代理管理后台 | 8082 (内部) |
| `youle-wxserver` | node:18-alpine (自定义) | 微信小程序后端 | 3000 (内部) |
| `youle-syncjob` | alpine:3.19 | 每 30s POST `Synchronize.php`（数据同步） | 无 |
| `youle-cronjob` | alpine:3.19 | 每日凌晨 4:00 执行报表同步 | 无 |
| `youle-redis` | redis:7-alpine | 缓存服务（可选） | 6379 (内部) |
| `youle-certbot` | certbot/certbot | Let's Encrypt SSL 证书自动续签 | 无 |

---

## 快速部署

### 前置要求

- Linux 服务器（推荐 Ubuntu 22.04 / CentOS 8+，最低 2C 2G）
- 域名已解析到服务器 IP（3 个域名：API / DLWEB / wxserver）
- 服务器 80 和 443 端口可用
- Docker 和 Docker Compose（如未安装，`deploy.sh` 会自动安装并配置国内镜像加速）

### 1. 上传项目到服务器

将 `game-docker` 目录上传到服务器 `/opt/youle/` 下：

```bash
# 方式一：从本地直接上传（Windows 使用 scp / WinSCP / SFTP）
scp -r game-docker/ root@your-server-ip:/opt/youle/

# 方式二：从 Git 仓库拉取
ssh root@your-server-ip
mkdir -p /opt/youle
cd /opt/youle
git clone <仓库地址> game-docker
```

上传后服务器上的目录结构：

```
/opt/youle/game-docker/
├── .env.example
├── docker-compose.yml
├── deploy.sh
├── init-ssl.sh
├── api/
├── dlweb/
├── wxserver_daoqi/
└── docker/
```

### 2. 准备环境变量

```bash
cd /opt/youle/game-docker
cp .env.example .env
vim .env
```

**必须修改的关键配置：**

```bash
# 域名（用于 Nginx SSL 和 certbot）
API_DOMAIN=api.yourdomain.com
DLWEB_DOMAIN=dlapi.yourdomain.com
WX_DOMAIN=wxapi.yourdomain.com

# 数据库（各服务数据库连接）
API_DB_HOST=your-rds-host
API_DB_PASSWORD=your-password
DLWEB_DB_HOST=your-rds-host
DLWEB_DB_PASSWORD=your-password
# ... 其他数据库配置

# 微信配置
WX_MINI_APPID=your-appid
WX_MINI_APPSECRET=your-secret
WX_PAY_MCHID=your-mchid
WX_PAY_KEY=your-key

# SSL 邮箱
SSL_EMAIL=your-email@example.com
```

### 3. 首次申请 SSL 证书

```bash
chmod +x deploy.sh init-ssl.sh

# 先测试（不真正申请，验证域名解析是否正确）
./deploy.sh ssl-init --dry-run

# 正式申请
./deploy.sh ssl-init
```

### 4. 启动所有服务

```bash
./deploy.sh up
```

启动后验证：

```bash
# 查看所有容器状态
./deploy.sh status

# 查看特定服务日志
./deploy.sh logs api
./deploy.sh logs dlweb
./deploy.sh logs syncjob
./deploy.sh logs cronjob
```

### 5. 部署命令速查

| 命令 | 说明 |
|------|------|
| `./deploy.sh up` | 构建并启动所有服务 |
| `./deploy.sh down` | 停止并移除所有容器 |
| `./deploy.sh restart` | 重启所有服务 |
| `./deploy.sh rebuild` | 无缓存重建所有镜像 |
| `./deploy.sh rebuild api` | 只重建指定服务 |
| `./deploy.sh logs [service]` | 查看日志（支持 `-f` 实时跟踪） |
| `./deploy.sh status` | 查看容器运行状态 |
| `./deploy.sh ssl-init` | 首次申请 SSL 证书 |
| `./deploy.sh ssl-init --staging` | 用 Let's Encrypt 测试环境申请 |
| `./deploy.sh ssl-renew` | 手动续签证书 |
| `./deploy.sh ssl-status` | 查看证书到期时间 |

---

## 定时任务说明

Docker 部署包含两个定时任务容器，替代原 Windows 环境的 `HttpRequestService.exe` 和 `autorun.cmd`。

### syncjob — 实时同步任务

**替代：** Windows `HttpRequestService.exe`（通过 `HttpRequest.exe.json` 配置）

**作用：** 每 30 秒 POST 请求 `dlweb/ext/Synchronize.php`，从游戏数据库 `ct_user_process_log` 表消费未处理日志，将玩家/代理数据同步到代理后台数据库。

**运行方式：** 通过 Docker 内网直连 `http://dlweb/ext/Synchronize.php`，不经过公网域名，零流量消耗。

**可配置项（`.env`）：**

```bash
# 轮询间隔（秒），默认 30
SYNC_INTERVAL=30

# 每次处理的日志条数，默认 200
SYNC_PROCESSCOUNT=200
```

**查看同步日志：**

```bash
./deploy.sh logs syncjob
# 或实时查看
docker logs -f youle-syncjob
```

### cronjob — 每日定时任务

**替代：** Windows 计划任务调用的 `tools-docker/autorun.cmd`

**作用：** 每日凌晨 4:00 执行以下流程（与原 `autorun.cmd` 完全一致）：

| 步骤 | 原 autorun.cmd | Docker cronjob |
|------|---------------|----------------|
| 1. 停止同步服务 | `net stop HttpRequestService` | 创建 `/shared/syncjob.pause` 信号文件 |
| 2. 等待当前请求完成 | （Windows 服务立即停止） | `sleep 5` |
| 3. 同步报表数据 | `HttpRequest.exe POST SynchronizeReportData.php` | `curl POST http://dlweb/ext/SynchronizeReportData.php` |
| 4. 恢复同步服务 | `net start HttpRequestService` | 删除 `/shared/syncjob.pause` 信号文件 |

> **暂停机制：** `syncjob` 和 `cronjob` 通过共享 Docker volume（`shared-signal`）通信。`cronjob` 创建 `/shared/syncjob.pause` 文件时，`syncjob` 会自动跳过轮询，报表同步完成后删除该文件恢复。

**可配置项（`.env`）：**

```bash
# cron 表达式，默认凌晨 4:00
CRON_SCHEDULE=0 4 * * *
```

**修改执行时间示例：**

```bash
# 凌晨 3:30 执行
CRON_SCHEDULE=30 3 * * *

# 每天凌晨 2:00 和 14:00 各执行一次
CRON_SCHEDULE=0 2,14 * * *
```

**查看执行日志：**

```bash
./deploy.sh logs cronjob
# 或实时查看
docker logs -f youle-cronjob
```

**手动触发（测试用）：**

```bash
docker exec youle-cronjob /bin/sh /app/daily-task.sh
```

---

## 环境变量说明

所有硬编码的域名、数据库地址、密钥都已外部化为环境变量。**修改配置不再需要改代码，只需改 `.env` 文件。**

### 变量分组总览

| 变量分组 | 说明 |
|---------|------|
| `API_DB_*` | 游戏核心 API 数据库 |
| `DLWEB_DB_*` | 代理后台主库 |
| `DLWEB_SLAVE_DB_*` | 代理后台从库 |
| `EXT_GAME_DB_*` | 外部游戏数据库（Synchronize / SynchronizeReportData） |
| `EXT_GRADE_DB_*` | 战绩数据库（game.php） |
| `EXT_DEV_DB_*` | 开发数据库（DEBUG 模式） |
| `REDIS_*` | Redis 配置 |
| `WX_MINI_*` | 微信小程序 AppID / Secret |
| `WX_OA_*` | 微信公众号 AppID / Secret |
| `WX_PAY_*` | 微信支付商户配置 |
| `REMOTE_CONFIG_*` | 远程配置（Gitee） |
| `API_DOMAIN` / `DLWEB_DOMAIN` / `WX_DOMAIN` | 3 个服务域名（Nginx + SSL + 前端 JS 自动推导） |
| `SITE_*` | PHP 后端各站点域名 |
| `DLWEB_*_URL` | 前端 JS/HTML 硬编码域名替换 |
| `SYNC_INTERVAL` / `SYNC_PROCESSCOUNT` | syncjob 同步参数 |
| `CRON_SCHEDULE` | cronjob 执行时间 |
| `GAME_SERVER_QUERY_URL` | 游戏服务器查询地址 |
| `INTERNAL_WHITELIST` | IP 白名单（逗号分隔） |

### 域名配置关系

```
.env 域名            │  用途
─────────────────────┼──────────────────────────────────
API_DOMAIN           │  Nginx server_name（网站1）+ 自动推导 DLWEB_API_BASE_URL
DLWEB_DOMAIN         │  Nginx server_name（网站2）+ 自动推导 DLWEB_SDK_API_URL
WX_DOMAIN            │  Nginx server_name（网站3）
```

---

## 环境变量加载机制

### PHP 服务（env_config.php）

所有 PHP 文件通过 `env($key, $default)` 函数读取配置：

```php
// 优先读 OS 环境变量（Docker 场景），回退读 .env 文件
$host = env('API_DB_HOST', 'localhost');
```

加载优先级：Docker 容器环境变量（`docker-compose env_file`）> `.env` 文件 > 代码默认值。

### Node.js 服务（wxserver_daoqi）

直接使用 `process.env.VARIABLE_NAME`，由 `docker-compose env_file` 注入。

### 前端 JS / HTML

前端静态文件无法读取环境变量，通过 Docker entrypoint 脚本在容器启动时用 `sed` 替换硬编码域名：

- `docker/api/docker-entrypoint.sh` — 替换 API 服务中的 JS 文件
- `docker/dlweb/docker-entrypoint.sh` — 替换 DLWEB 服务中的 30+ 个 JS/HTML 文件

### Nginx 域名注入

`default.conf.template` 使用 `${API_DOMAIN}` / `${DLWEB_DOMAIN}` / `${WX_DOMAIN}` 占位符，Nginx 容器启动时通过 `envsubst` 自动替换。

---

## SSL 证书管理

使用 Let's Encrypt 免费证书，由 `certbot` 容器自动管理。

```bash
# 首次申请（必须先确保域名已解析）
./deploy.sh ssl-init

# 用测试环境验证（不消耗申请限额）
./deploy.sh ssl-init --staging

# 手动续签
./deploy.sh ssl-renew

# 查看证书状态
./deploy.sh ssl-status
```

`certbot` 容器每 12 小时自动检查续签，证书到期前 30 天自动更新，无需人工干预。

---

## 数据持久化

以下 Docker volume 用于持久化存储：

| Volume | 挂载点 | 说明 |
|--------|--------|------|
| `api-logs` | /var/www/html/logs | API 服务日志 |
| `api-source-logs` | /var/www/html/source/logs | API source 模块日志 |
| `dlweb-logs` | /var/www/html/api/logs | DLWEB 服务日志 |
| `dlweb-debug` | /var/www/html/api/ext/debug | DLWEB 同步/报表调试日志 |
| `redis-data` | /data | Redis 持久化数据 |
| `shared-signal` | /shared | syncjob ↔ cronjob 暂停信号文件 |
| `certbot-webroot` | /var/www/certbot | ACME 域名验证文件 |
| `certbot-certs` | /etc/letsencrypt | SSL 证书文件 |

---

## 与原版（Windows 部署）的区别

| 项目 | 原版 Windows | Docker 版 |
|------|-------------|-----------|
| 环境 | Windows + Apache/XAMPP + Node.js | Docker 容器化 |
| 配置方式 | 硬编码在 PHP/JS/HTML 中 | 统一 `.env` 文件 |
| 域名切换 | 需改 30+ 个文件 | 只改 `.env` 的 3 个域名变量 |
| 数据库密码 | 明文散布在多个配置文件 | 集中在 `.env`（不进版本库） |
| SSL | 手动申请/部署证书 | certbot 自动申请 + 12h 自动续签 |
| Synchronize 轮询 | `HttpRequestService.exe`（Windows 服务） | `syncjob` 容器（Alpine + curl） |
| 每日定时任务 | Windows 计划任务 → `autorun.cmd` | `cronjob` 容器（Alpine crond） |
| 内网请求 | `localhost:80`（同机 Apache） | Docker 内网 `http://dlweb`（零公网流量） |
| PHP 环境变量 | `env_config.php` `env()` 函数 | `env()` 优先读容器环境变量，回退 `.env` 文件 |
| 微信支付配置 | 硬编码在 `WxPay.Config.php` | `define()` + class const，由 `env()` 动态读取 |
| 游戏服务器列表 | 硬编码在 `game.config.php` | 支持外部 JSON 文件覆盖（`GAME_SERVERS_CONFIG_FILE`） |

---

## 常见运维操作

### 场景一：更换域名

当需要将服务迁移到新域名时（例如 `daoqijuyou77.cn` → `newdomain.com`），操作步骤：

**1. 修改 `.env` 中的域名变量**

```bash
vim .env
```

需要修改的变量（按影响范围分类）：

| 变量 | 说明 | 示例 |
|------|------|------|
| **Nginx 路由（必改）** | | |
| `API_DOMAIN` | 网站1 域名 | `api.newdomain.com` |
| `DLWEB_DOMAIN` | 网站2 域名 | `dlapi.newdomain.com` |
| `WX_DOMAIN` | 网站3 域名 | `wxapi.newdomain.com` |
| **PHP 后端域名（按需）** | | |

> **前端 JS 请求地址无需单独配置：** `DLWEB_API_BASE_URL`（= `https://` + `API_DOMAIN`）和 `DLWEB_SDK_API_URL`（= `https://` + `DLWEB_DOMAIN`）由 entrypoint 脚本自动推导。

| `SITE_API_URL` | API 服务完整 URL | `https://api.newdomain.com` |
| `SITE_API2_URL` | API2 服务完整 URL | `https://api2.newdomain.com` |
| `SITE_SDK_DOMAIN` | SDK 域名（不带协议） | `sdk.newdomain.com` |
| `SITE_OPEN_URL` | 开放平台 URL | `http://open.newdomain.com` |
| `SITE_PAY_NOTIFY_URL` | 支付回调通知 URL | `http://api.newdomain.com` |
| `QQ_CALLBACK_URL` | QQ 登录回调 | `http://syhd.newdomain.com` |
| **DLWEB 前端域名（按需）** | | |
| `DLWEB_SETTLE_URL` | 结算后台地址 | `http://dlsettle.newdomain.com/mobile/` |
| `DLWEB_SETTLE_FULL_URL` | 结算后台完整地址 | `http://dlsettle.newdomain.com` |
| `DLWEB_PROXY_URL` | 代理测试地址 | `https://proxytest.newdomain.com` |
| `DLWEB_PROXY_77_URL` | 代理测试地址（77） | `https://proxytest.newdomain.com` |
| `DLWEB_DL_API_V3_URL` | V3 API 地址 | `https://dlapiv3.newdomain.com` |
| `DLWEB_OPERATE_URL` | 运营后台地址 | `https://operate.newdomain.com` |
| `DLWEB_AVATAR_URL` | 默认头像地址 | `https://dlwebv3.newdomain.com/images/noavatar.png` |
| `DLWEB_SDK_API2_URL` | SDK API2 地址 | `https://api2.newdomain.com` |
| `DLWEB_DOWNLOAD_CDN_URL` | 下载页 CDN | `http://cdn.newdomain.com` |
| `DLWEB_GAME_IMAGE_URL` | 游戏图片地址 | `http://games.newdomain.com` |
| `DLWEB_SKYGAMES_URL` | Skygames 地址 | `https://skygames.newdomain.com` |
| `SITE_GAME_SERVICE_URL` | 游戏服务查询 | `http://service.newdomain.com:1089/index.html` |

> **注意：** 注释掉的变量（`#` 开头）表示使用代码中的默认值。如果新域名与默认值不同，需要取消注释并修改。

**2. DNS 解析**

确保新域名已指向服务器 IP：

```bash
# 验证 DNS 解析
nslookup api.newdomain.com
nslookup dlapi.newdomain.com
nslookup wxapi.newdomain.com
```

**3. 重新申请 SSL 证书**

```bash
# 测试验证（不消耗申请限额）
./deploy.sh ssl-init --staging

# 正式申请
./deploy.sh ssl-init
```

**4. 重启所有服务**

```bash
./deploy.sh restart
```

重启时会自动完成：
- Nginx 使用新域名的 `server_name` 和 SSL 证书
- `docker-entrypoint.sh` 用新域名替换 JS/HTML 中的硬编码 URL
- PHP `env()` 读取新的环境变量值

**5. 更新微信后台配置**

| 微信后台 | 配置项 | 新值 |
|---------|--------|------|
| 小程序后台 | request 合法域名 | `https://wxapi.newdomain.com` |
| 小程序后台 | 业务域名 | `wxapi.newdomain.com` |
| 公众号后台 | 业务域名 / JS接口安全域名 | `api.newdomain.com` |
| 公众号后台 | 网页授权域名 | `wxapi.newdomain.com` |
| 微信支付后台 | 支付授权目录 | `https://dlapi.newdomain.com/` |

---

### 场景二：更换数据库地址

当数据库实例迁移（例如 RDS 升级、切换区域）时：

**1. 修改 `.env` 中对应的数据库变量**

```bash
vim .env
```

按数据库分组：

| 数据库 | 需修改的变量 | 使用者 |
|--------|-------------|--------|
| API 主库 | `API_DB_HOST`, `API_DB_PORT`, `API_DB_USER`, `API_DB_PASSWORD` | api 服务 |
| 代理后台主库 | `DLWEB_DB_HOST`, `DLWEB_DB_PORT`, `DLWEB_DB_USER`, `DLWEB_DB_PASSWORD` | dlweb 服务 |
| 代理后台从库 | `DLWEB_SLAVE_DB_HOST`, `DLWEB_SLAVE_DB_PORT`, `DLWEB_SLAVE_DB_USER`, `DLWEB_SLAVE_DB_PASSWORD` | dlweb 读操作 |
| 外部游戏库 | `EXT_GAME_DB_HOST`, `EXT_GAME_DB_PORT`, `EXT_GAME_DB_USER`, `EXT_GAME_DB_PASSWORD` | Synchronize.php / SynchronizeReportData.php |
| 战绩库 | `EXT_GRADE_DB_HOST`, `EXT_GRADE_DB_PORT`, `EXT_GRADE_DB_USER`, `EXT_GRADE_DB_PASSWORD` | game.php 查询战绩 |
| 开发库 | `EXT_DEV_DB_HOST`, `EXT_DEV_DB_PORT`, `EXT_DEV_DB_USER`, `EXT_DEV_DB_PASSWORD` | DEBUG 模式 |

**2. 重启受影响的服务**

```bash
# 如果只改了 API 数据库
docker compose restart api

# 如果只改了 DLWEB 数据库
docker compose restart dlweb

# 如果改了外部游戏库（影响同步任务）
docker compose restart dlweb syncjob cronjob

# 如果改了多个，直接全部重启
./deploy.sh restart
```

**3. 验证连接**

```bash
# 查看 API 日志是否有数据库连接错误
docker logs --tail 20 youle-api

# 查看 DLWEB 日志
docker logs --tail 20 youle-dlweb

# 查看同步任务是否正常
docker logs --tail 10 youle-syncjob
```

> **提示：** 如果新数据库有 IP 白名单限制，需要将 Docker 宿主机的公网 IP 加入 RDS 白名单。

---

### 场景三：更换服务器（整体迁移）

将整个 Docker 部署迁移到新服务器：

**1. 打包项目文件**

```bash
# 在旧服务器上
cd /path/to/game-docker
# 排除不必要文件
tar czf game-docker.tar.gz --exclude='.env' --exclude='game/' .
```

**2. 传输到新服务器**

```bash
scp game-docker.tar.gz newserver:/opt/
```

**3. 在新服务器上部署**

```bash
cd /opt
tar xzf game-docker.tar.gz -C game-docker
cd game-docker

# 复制并修改配置（新服务器 IP 可能不同）
cp .env.example .env
vim .env
```

**4. 确认修改项**

| 检查项 | 是否需要改 | 说明 |
|--------|-----------|------|
| 域名（`*_DOMAIN`） | 域名不变则不改 | DNS 需指向新服务器 IP |
| 数据库地址（`*_DB_HOST`） | 通常不改 | RDS 地址不变，但需将新服务器 IP 加入白名单 |
| Redis 地址 | 不改 | Docker 内置 Redis，随容器迁移 |
| 微信/支付配置 | 不改 | AppID/Secret 与服务器无关 |
| 游戏服务器查询地址 | 看情况 | `GAME_SERVER_QUERY_URL` 如果游戏服务器也迁移了需改 |
| IP 白名单 | 可能需改 | `INTERNAL_WHITELIST` 加入新 IP |

**5. 启动服务**

```bash
chmod +x deploy.sh init-ssl.sh

# 域名未变：DNS 改指向后直接启动
./deploy.sh ssl-init   # 新服务器需重新申请证书
./deploy.sh up

# 域名变了：参照「场景一：更换域名」
```

**6. 验证所有服务**

```bash
# 容器状态
./deploy.sh status

# 各服务健康检查
curl -k https://api.yourdomain.com/
curl -k https://dlapi.yourdomain.com/
curl -k https://wxapi.yourdomain.com/

# 定时任务运行正常
docker logs --tail 5 youle-syncjob
docker logs --tail 5 youle-cronjob
```

---

### 场景四：仅更改 Redis 配置

```bash
vim .env
# 修改以下变量：
# REDIS_HOST=new-redis-host
# REDIS_PORT=6379
# REDIS_PASSWORD=new-password

# 重启受影响的服务
docker compose restart dlweb redis
```

> **注意：** 如果使用 Docker 内置 Redis（默认），`REDIS_HOST` 应设为 `redis`（Docker 服务名），不是 `localhost`。

---

### 操作速查表

| 变更内容 | 修改 `.env` 中的变量 | 重启命令 | 额外操作 |
|---------|---------------------|---------|---------|
| 全部域名 | `*_DOMAIN` + `DLWEB_*_URL` + `SITE_*` | `./deploy.sh ssl-init && ./deploy.sh restart` | DNS 解析 + 微信后台 |
| 单个域名 | 对应的 `*_DOMAIN` + 关联 URL 变量 | `./deploy.sh ssl-init && ./deploy.sh restart` | DNS 解析 |
| API 数据库 | `API_DB_*` | `docker compose restart api` | RDS 白名单 |
| DLWEB 数据库 | `DLWEB_DB_*` | `docker compose restart dlweb` | RDS 白名单 |
| 游戏数据库 | `EXT_GAME_DB_*` | `docker compose restart dlweb syncjob cronjob` | RDS 白名单 |
| 战绩数据库 | `EXT_GRADE_DB_*` | `docker compose restart dlweb` | RDS 白名单 |
| Redis | `REDIS_*` | `docker compose restart dlweb redis` | — |
| 微信密钥 | `WX_*` | `docker compose restart api dlweb wxserver` | 微信后台 |
| 整体迁移 | 视情况 | `./deploy.sh ssl-init && ./deploy.sh up` | DNS + RDS 白名单 |

### 查看定时任务执行情况

```bash
# syncjob 实时同步状态
docker logs --tail 50 youle-syncjob

# cronjob 每日报表执行记录
docker logs --tail 50 youle-cronjob

# dlweb 容器内的同步调试日志
docker exec youle-dlweb ls /var/www/html/api/ext/debug/synchronize/
docker exec youle-dlweb ls /var/www/html/api/ext/debug/SynchronizeReportData/
```

### 调整同步频率

```bash
# 修改 .env
SYNC_INTERVAL=15        # 15 秒一次
SYNC_PROCESSCOUNT=500   # 每次处理 500 条

# 重启 syncjob
docker compose restart syncjob
```

### 调整每日任务执行时间

```bash
# 修改 .env
CRON_SCHEDULE=30 3 * * *   # 改为凌晨 3:30

# 重启 cronjob
docker compose restart cronjob
```