# 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` 会自动安装并配置国内镜像加速）

---

### 0. 配置 SSH 密钥认证（必须）

`sync.ps1` 每次执行会调用多次 `scp` / `ssh`，如果未配置密钥认证，每条命令都会弹出密码提示导致脚本中断。以下步骤在 **Windows PowerShell** 中完成（Windows 10/11 内置 OpenSSH 客户端，无需额外安装）。

#### 第一步：检查是否已有 SSH 密钥

```powershell
# 默认密钥路径
Test-Path "$env:USERPROFILE\.ssh\id_ed25519"
# 输出 True 表示已有密钥，可跳到第三步
```

如果已有 RSA 旧密钥（`id_rsa`），同样可用，把下面命令中的 `id_ed25519` 替换为 `id_rsa`。

#### 第二步：生成密钥对

```powershell
# 生成 Ed25519 密钥（更安全、更短）
ssh-keygen -t ed25519 -C "youle-deploy" -f "$env:USERPROFILE\.ssh\id_ed25519"
# 提示 passphrase 时直接回车两次（不设密码，脚本才能自动运行）
```

执行后生成两个文件：

| 文件 | 说明 |
|------|------|
| `~/.ssh/id_ed25519` | **私钥**，绝不上传服务器，本地保管 |
| `~/.ssh/id_ed25519.pub` | **公钥**，要发给服务器 |

#### 第三步：将公钥上传到服务器

> 此步骤会要求输入一次密码，之后不再需要。

```powershell
# 一行命令：读取公钥 → 追加到服务器 authorized_keys
cat "$env:USERPROFILE\.ssh\id_ed25519.pub" | ssh root@47.98.203.17 `
  "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys"
```

#### 第四步：验证免密登录

```powershell
# 直接登录，不弹密码提示则成功
ssh root@47.98.203.17 "echo 'SSH key auth OK'"
```

输出 `SSH key auth OK` 即表示配置成功，`sync.ps1` 可正常使用。

#### 可选：配置 SSH 别名（简化命令）

在 `C:\Users\<你的用户名>\.ssh\config`（文件不存在则新建）中添加：

```
Host youle
    HostName 47.98.203.17
    User root
    IdentityFile ~/.ssh/id_ed25519
    ServerAliveInterval 60
```

配置后可使用短名称操作：

```powershell
ssh youle                           # 直接登录
# sync.ps1 使用别名
.\sync.ps1 -Server youle
```

#### 可选：多台电脑共用同一台服务器

把每台电脑生成的 `id_ed25519.pub` 内容都追加到服务器的 `~/.ssh/authorized_keys`（一行一个），不需要删除旧的公钥：

```powershell
# 在第二台电脑上执行同样的上传命令即可（>> 追加而不是覆盖）
cat "$env:USERPROFILE\.ssh\id_ed25519.pub" | ssh root@47.98.203.17 `
  "cat >> ~/.ssh/authorized_keys"
```

---

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

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

```powershell
# 推荐：使用 sync.ps1（tar 压缩单连接，比 scp -r 快约 10-50 倍）
# 首次部署用 full 模式，上传全部文件（约 10 MB 压缩包）
.\sync.ps1 -Mode full

# 日常代码更新用 app 模式（排除文档/测试，约 7 MB）
.\sync.ps1

# 仅更新 Docker 配置文件（docker-compose.yml、deploy.sh 等，不到 1 MB）
.\sync.ps1 -Mode config
```

> **前提：** 已完成步骤 0 的 SSH 密钥认证配置，否则 `sync.ps1` 会反复弹密码提示。

`sync.ps1` 会自动在服务器上创建 `/opt/youle/game-docker/` 目录（如不存在）。

如不使用 `sync.ps1`，也可手动上传：

```bash
# 从 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
# 父域名（三个子域名自动推导，无需单独配置）
# 将自动生成: api.<ROOT_DOMAIN>  dlapi.<ROOT_DOMAIN>  wxapi.<ROOT_DOMAIN>
ROOT_DOMAIN=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） |
| `ROOT_DOMAIN` | 父域名（自动推导 3 个子域名 + 所有派生 URL） |
| `SITE_*` | PHP 后端各站点域名 |
| `DLWEB_*_URL` | 前端 JS/HTML 硬编码域名替换 |
| `SYNC_INTERVAL` / `SYNC_PROCESSCOUNT` | syncjob 同步参数 |
| `CRON_SCHEDULE` | cronjob 执行时间 |
| `GAME_SERVER_QUERY_URL` | 游戏服务器查询地址 |
| `INTERNAL_WHITELIST` | IP 白名单（逗号分隔） |

### 域名配置关系

```
.env 配置            │  自动推导结果
─────────────────────┼──────────────────────────────────────────────────────
ROOT_DOMAIN          │  API_DOMAIN    = api.<ROOT_DOMAIN>     → Nginx 网站1
（唯一必填）          │  DLWEB_DOMAIN  = dlapi.<ROOT_DOMAIN>   → Nginx 网站2
                     │  WX_DOMAIN     = wxapi.<ROOT_DOMAIN>   → Nginx 网站3
                     │  SITE_API_URL  = https://api.<ROOT_DOMAIN>
                     │  SITE_PAY_NOTIFY_URL = https://api.<ROOT_DOMAIN>
                     │  SITE_OPEN_URL = http://open.<ROOT_DOMAIN>
                     │  DLWEB_DL_API_V3_URL = https://dlapi.<ROOT_DOMAIN>
```

> 推导由 `docker-compose.yml` 的 `environment:` 块完成，容器内所有派生变量均无需手动配置。如子域名不符合 `<前缀>.<ROOT_DOMAIN>` 规律，可在 `.env` 中单独覆盖对应变量。

---

## 环境变量加载机制

### 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`） |

---

## 常见运维操作

### 场景一：更换域名

当需要将服务迁移到新域名时（例如 `daoqijuyou.cn` → `newdomain.com`），只需改一个变量：

**1. 修改 `.env` 中的 `ROOT_DOMAIN`**

```bash
vim .env
```

```bash
# 改成新父域名，三个子域名自动跟随
ROOT_DOMAIN=newdomain.com
```

`docker-compose.yml` 将自动推导：

| 推导变量 | 结果 |
|---------|------|
| `API_DOMAIN` | `api.newdomain.com` |
| `DLWEB_DOMAIN` | `dlapi.newdomain.com` |
| `WX_DOMAIN` | `wxapi.newdomain.com` |
| `SITE_API_URL` | `https://api.newdomain.com` |
| `SITE_PAY_NOTIFY_URL` | `https://api.newdomain.com` |
| `SITE_OPEN_URL` | `http://open.newdomain.com` |
| `DLWEB_DL_API_V3_URL` | `https://dlapi.newdomain.com` |

> **子域名不符合标准规律时**（如使用完全不同的前缀），在 `.env` 中单独覆盖对应变量即可，优先级高于自动推导：
> ```bash
> DLWEB_DOMAIN=dl-manage.newdomain.com   # 覆盖单个子域名
> ```

> **其他独立 URL 变量**（`DLWEB_SETTLE_URL`、`DLWEB_PROXY_URL`、`QQ_CALLBACK_URL` 等）仍需在 `.env` 中手动配置，详见 `.env.example` 中的注释。

**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`。

---

### 场景五：单独开启 / 关闭特定服务

所有服务均可独立启停，不影响其他运行中的容器。

#### 服务清单与依赖关系

| 服务名 | 容器名 | 说明 | 依赖 |
|--------|--------|------|------|
| `nginx` | `youle-nginx` | 反向代理 + SSL | api / dlweb / wxserver |
| `api` | `youle-api` | 游戏核心 API | — |
| `dlweb` | `youle-dlweb` | 代理管理后台 | redis |
| `wxserver` | `youle-wxserver` | 微信小程序后端 | — |
| `syncjob` | `youle-syncjob` | 每 30s 数据同步 | dlweb（内网） |
| `cronjob` | `youle-cronjob` | 每日凌晨报表任务 | dlweb（内网） |
| `redis` | `youle-redis` | 缓存 | — |
| `certbot` | `youle-certbot` | 证书自动续签 | — |

#### 开启单个服务

```bash
cd /opt/youle/game-docker

# 启动某个服务（若镜像不存在会自动构建）
docker compose up -d api
docker compose up -d dlweb
docker compose up -d wxserver
docker compose up -d syncjob
docker compose up -d cronjob
docker compose up -d redis
docker compose up -d nginx
docker compose up -d certbot
```

#### 关闭单个服务

```bash
# 停止并移除容器（数据 volume 不受影响）
docker compose stop api
docker compose stop syncjob
docker compose stop cronjob

# 或者 stop + 移除容器（等效于 stop + rm）
docker compose rm -sf syncjob
```

> **注意：** `stop` 只停止容器，不删除；`rm -sf` 停止并删除容器（下次 `up` 会重新创建）。两种方式均不会丢失数据 volume。

#### 常见场景

**临时关闭同步任务（维护数据库时）：**
```bash
docker compose stop syncjob cronjob
# 维护完成后恢复
docker compose up -d syncjob cronjob
```

**只重建并重启某个业务服务（代码更新后）：**
```bash
# 重新构建镜像并重启，其他服务不受影响
docker compose up -d --build api
docker compose up -d --build dlweb
docker compose up -d --build wxserver
```

**关闭 certbot 自动续签（调试期间避免请求频率限制）：**
```bash
docker compose stop certbot
# 调试完毕后恢复
docker compose up -d certbot
```

**仅重启 nginx（修改配置后生效）：**
```bash
docker compose restart nginx
# 或热重载（不中断连接）
docker exec youle-nginx nginx -s reload
```

**查看所有服务当前状态：**
```bash
docker compose ps
# 或
./deploy.sh status
```

---

### 操作速查表

| 变更内容 | 修改 `.env` 中的变量 | 重启命令 | 额外操作 |
|---------|---------------------|---------|---------|
| 更换域名 | `ROOT_DOMAIN`（子域名不标准时单独覆盖） | `./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 白名单 |

### 场景七：查看日志

本项目日志分为两类：**Docker 容器标准输出日志**（`docker logs`）和**业务调试日志**（写入 Docker Volume 的文件）。

#### 日志位置总览

| 日志类型 | 来源容器 | 查看方式 | 说明 |
|---------|---------|---------|------|
| Nginx 访问/错误日志 | `youle-nginx` | `docker logs` | HTTP 请求记录、SSL 错误 |
| API Apache 错误日志 | `youle-api` | `docker logs` | PHP Fatal Error、Apache 500 |
| API PHP 错误日志 | `youle-api` | `docker logs` | PHP Warning/Notice（写入 Apache 错误流）|
| API 业务日志 | `youle-api` | Volume 文件 | `/var/www/html/logs/YYYY-MM-DD.log` |
| API source 模块日志 | `youle-api` | Volume 文件 | `/var/www/html/source/logs/` |
| DLWEB Apache 错误日志 | `youle-dlweb` | `docker logs` | PHP Fatal Error、Apache 500 |
| DLWEB 业务日志 | `youle-dlweb` | Volume 文件 | `/var/www/html/api/logs/` |
| 同步任务调试日志 | `youle-dlweb` | Volume 文件 | `/var/www/html/api/ext/debug/synchronize/YYYY-MM-DD.log` |
| 报表同步调试日志 | `youle-dlweb` | Volume 文件 | `/var/www/html/api/ext/debug/SynchronizeReportData/YYYY-MM-DD.log` |
| 自动任务调试日志 | `youle-dlweb` | Volume 文件 | `/var/www/html/api/ext/debug/autotask/YYYY-MM-DD.log` |
| syncjob 运行日志 | `youle-syncjob` | `docker logs` | curl 请求结果，每 30s 一条 |
| cronjob 调度日志 | `youle-cronjob` | `docker logs` | cron 触发记录 |
| wxserver 运行日志 | `youle-wxserver` | `docker logs` | Node.js 标准输出 |

---

#### 1. 查看容器标准输出日志（docker logs）

```bash
# 查看最近 50 行（快速概览）
docker logs --tail 50 youle-nginx
docker logs --tail 50 youle-api
docker logs --tail 50 youle-dlweb
docker logs --tail 50 youle-syncjob
docker logs --tail 50 youle-cronjob
docker logs --tail 50 youle-wxserver

# 实时跟踪日志（Ctrl+C 退出）
docker logs -f youle-api
docker logs -f youle-syncjob

# 查看最近 100 行并实时跟踪
docker logs --tail 100 -f youle-dlweb

# 查看带时间戳的日志
docker logs -t --tail 50 youle-nginx

# 查看某时间段之后的日志（ISO 8601 格式）
docker logs --since 2026-04-13T10:00:00 youle-api
docker logs --since 1h youle-syncjob   # 最近 1 小时
```

> **提示：** `docker logs` 查看的是容器的 stdout/stderr 输出，PHP Fatal Error 和 Apache 错误均会出现在这里。

---

#### 2. 查看业务调试日志文件（Volume 文件）

业务调试日志写入 Docker Volume，按日期分文件（`YYYY-MM-DD.log`）。

```bash
# --- API 业务日志 ---

# 列出所有日志文件
docker exec youle-api ls -lh /var/www/html/logs/

# 查看今天的 API 业务日志（末尾 50 行）
docker exec youle-api tail -50 /var/www/html/logs/$(date +%Y-%m-%d).log

# 实时跟踪今天的 API 日志
docker exec youle-api tail -f /var/www/html/logs/$(date +%Y-%m-%d).log

# 查看完整内容
docker exec youle-api cat /var/www/html/logs/$(date +%Y-%m-%d).log

# --- API source 模块日志 ---
docker exec youle-api ls -lhR /var/www/html/source/logs/
docker exec youle-api tail -50 /var/www/html/source/logs/$(date +%Y-%m-%d).log


# --- DLWEB 业务日志 ---

# 列出所有日志文件
docker exec youle-dlweb ls -lh /var/www/html/api/logs/

# 查看今天的 DLWEB 业务日志
docker exec youle-dlweb tail -50 /var/www/html/api/logs/$(date +%Y-%m-%d).log


# --- 同步任务调试日志（Synchronize.php）---

# 列出日志文件
docker exec youle-dlweb ls -lh /var/www/html/api/ext/debug/synchronize/

# 查看今天的同步日志（最近 50 行）
docker exec youle-dlweb tail -50 /var/www/html/api/ext/debug/synchronize/$(date +%Y-%m-%d).log

# 实时跟踪同步日志（每 30s 刷新）
docker exec youle-dlweb tail -f /var/www/html/api/ext/debug/synchronize/$(date +%Y-%m-%d).log


# --- 报表同步调试日志（SynchronizeReportData.php）---

docker exec youle-dlweb ls -lh /var/www/html/api/ext/debug/SynchronizeReportData/
docker exec youle-dlweb tail -50 /var/www/html/api/ext/debug/SynchronizeReportData/$(date +%Y-%m-%d).log


# --- 自动任务调试日志（autotask）---

docker exec youle-dlweb ls -lh /var/www/html/api/ext/debug/autotask/
docker exec youle-dlweb tail -50 /var/www/html/api/ext/debug/autotask/$(date +%Y-%m-%d).log
```

---

#### 3. 一键查看所有关键日志（汇总命令）

```bash
# 快速健康检查：同时查看 syncjob 状态 + 今天的同步调试日志末尾
echo '=== syncjob 容器日志（最近20行）==='
docker logs --tail 20 youle-syncjob
echo
echo '=== 同步调试日志（最近20行）==='
docker exec youle-dlweb tail -20 /var/www/html/api/ext/debug/synchronize/$(date +%Y-%m-%d).log
echo
echo '=== API 业务日志（最近20行）==='
docker exec youle-api tail -20 /var/www/html/logs/$(date +%Y-%m-%d).log
```

---

#### 4. 查看 Nginx 访问日志（请求排查）

```bash
# Nginx 访问日志（最近 100 条请求）
docker logs --tail 100 youle-nginx

# 过滤 HTTP 500 错误
docker logs youle-nginx 2>&1 | grep ' 500 '

# 过滤特定 IP 的请求
docker logs youle-nginx 2>&1 | grep '客户端IP地址'

# 过滤 SSL/TLS 握手错误（客户端发送了非 HTTPS 请求到 80 端口）
docker logs youle-nginx 2>&1 | grep 'SSL_do_handshake\|no required SSL'
```

---

#### 5. 使用 deploy.sh 快捷查看

```bash
# 等效于 docker logs --tail 100 + 实时跟踪
./deploy.sh logs api
./deploy.sh logs dlweb
./deploy.sh logs syncjob
./deploy.sh logs cronjob
./deploy.sh logs nginx
./deploy.sh logs wxserver

# 加 -f 实时跟踪
./deploy.sh logs -f api
./deploy.sh logs -f syncjob
```

### 调整同步频率

```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
```

---

### 场景六：卸载和清理

根据需求选择卸载范围，操作不可逆，请提前备份重要数据。

#### 卸载前：备份关键数据

```bash
cd /opt/youle/game-docker

# 1. 备份 .env（包含所有密钥，不在版本库中）
cp .env ~/youle-env-backup.env

# 2. 备份 Redis 数据（如有业务数据存储在 Redis 中）
docker exec youle-redis redis-cli -a "${REDIS_PASSWORD}" BGSAVE
# 或直接备份 volume
docker run --rm -v game-docker_redis-data:/data -v ~/:/backup alpine \
    tar czf /backup/redis-data-backup.tar.gz /data

# 3. 备份日志（按需）
docker cp youle-api:/var/www/html/logs ~/api-logs-backup
docker cp youle-dlweb:/var/www/html/api/logs ~/dlweb-logs-backup
```

---

#### 仅停止所有容器（保留镜像和数据，可随时恢复）

```bash
cd /opt/youle/game-docker
docker compose stop

# 验证
docker compose ps
```

恢复运行：

```bash
docker compose start
```

---

#### 停止并删除容器（保留镜像、volumes 和项目文件）

```bash
cd /opt/youle/game-docker
docker compose down

# 验证容器已删除
docker ps -a | grep youle
```

> 此操作不会删除数据 volume 和已构建的镜像，再次 `docker compose up -d` 可快速恢复，无需重新构建。

---

#### 完全卸载（删除容器 + volumes + 镜像）

> **警告：** 以下操作将删除 Redis 缓存和所有日志数据，不可恢复。

```bash
cd /opt/youle/game-docker

# 停止并删除容器 + 所有相关 volumes
docker compose down -v

# 删除本项目构建的镜像
docker rmi game-docker-api game-docker-dlweb game-docker-wxserver 2>/dev/null || true

# 验证
docker volume ls | grep game-docker
docker images | grep game-docker
```

---

#### 彻底清理（删除容器 + volumes + 镜像 + 项目目录 + SSL 证书）

> **警告：** SSL 证书删除后需重新申请（Let's Encrypt 有频率限制，每 7 天最多 5 次）。

```bash
cd /opt/youle/game-docker

# 1. 停止并删除容器 + volumes
docker compose down -v

# 2. 删除构建镜像
docker rmi game-docker-api game-docker-dlweb game-docker-wxserver 2>/dev/null || true

# 3. 清理 Docker 悬空资源（可选）
docker system prune -f

# 4. 删除 SSL 证书（Let's Encrypt）
docker run --rm -v game-docker_certbot-certs:/etc/letsencrypt certbot/certbot delete \
    --cert-name "${API_DOMAIN}" --non-interactive 2>/dev/null || true
docker run --rm -v game-docker_certbot-certs:/etc/letsencrypt certbot/certbot delete \
    --cert-name "${DLWEB_DOMAIN}" --non-interactive 2>/dev/null || true
docker run --rm -v game-docker_certbot-certs:/etc/letsencrypt certbot/certbot delete \
    --cert-name "${WX_DOMAIN}" --non-interactive 2>/dev/null || true
# 或直接删除证书 volume
docker volume rm game-docker_certbot-certs game-docker_certbot-webroot 2>/dev/null || true

# 5. 删除项目目录
rm -rf /opt/youle/game-docker
```

---

#### 删除单个服务的容器和镜像

```bash
cd /opt/youle/game-docker

# 以 dlweb 为例
docker compose stop dlweb
docker compose rm -sf dlweb
docker rmi game-docker-dlweb

# 下次启动时会重新构建
docker compose up -d --build dlweb
```

---

#### 清理定时任务残留

```bash
# 停止并删除 syncjob / cronjob 容器
docker compose stop syncjob cronjob
docker compose rm -sf syncjob cronjob

# 清理共享信号 volume（如有残留暂停文件）
docker run --rm -v game-docker_shared-signal:/shared alpine rm -f /shared/syncjob.pause

# 如需完全删除共享 volume
docker volume rm game-docker_shared-signal
```

---

#### 卸载操作速查

| 目标 | 命令 | 保留内容 |
|------|------|----------|
| 临时停止（可恢复） | `docker compose stop` | 容器 / 镜像 / volumes / 文件 |
| 删除容器 | `docker compose down` | 镜像 / volumes / 文件 |
| 删除容器 + volumes | `docker compose down -v` | 镜像 / 文件 |
| 删除容器 + volumes + 镜像 | `docker compose down -v` + `docker rmi ...` | 文件 |
| 完全清理 | 上述全部 + `rm -rf /opt/youle/game-docker` | 无 |

---

### 场景八：清除日志

> **说明：** Volume 文件日志（业务调试日志）和 Docker 容器日志（stdout）需要分别清理。清理前建议先备份或确认不再需要这些日志。

#### 1. 清除 Docker 容器日志（stdout/stderr）

Docker 容器的标准输出日志存储在宿主机 `/var/lib/docker/containers/<容器ID>/<容器ID>-json.log`，直接清空该文件即可。

```bash
# 清空单个容器的 docker logs（容器保持运行，不中断服务）
truncate -s 0 $(docker inspect --format='{{.LogPath}}' youle-syncjob)
truncate -s 0 $(docker inspect --format='{{.LogPath}}' youle-api)
truncate -s 0 $(docker inspect --format='{{.LogPath}}' youle-dlweb)
truncate -s 0 $(docker inspect --format='{{.LogPath}}' youle-nginx)
truncate -s 0 $(docker inspect --format='{{.LogPath}}' youle-cronjob)
truncate -s 0 $(docker inspect --format='{{.LogPath}}' youle-wxserver)

# 一键清空所有 youle-* 容器的 docker logs
for name in youle-nginx youle-api youle-dlweb youle-wxserver youle-syncjob youle-cronjob youle-redis youle-certbot; do
    logpath=$(docker inspect --format='{{.LogPath}}' $name 2>/dev/null)
    [ -n "$logpath" ] && truncate -s 0 "$logpath" && echo "Cleared: $name"
done
```

> **注意：** `truncate -s 0` 清空文件内容，不删除文件，容器无需重启，后续日志正常写入。

---

#### 2. 清除业务调试日志文件（Volume 内的按日期文件）

```bash
# --- 清除 API 业务日志 ---

# 删除所有历史日志（保留今天）
docker exec youle-api sh -c "
    find /var/www/html/logs/ -name '*.log' ! -name '$(date +%Y-%m-%d).log' -delete
"

# 清空今天的日志文件（保留文件，清空内容）
docker exec youle-api truncate -s 0 /var/www/html/logs/$(date +%Y-%m-%d).log

# 删除全部日志文件（含今天）
docker exec youle-api sh -c 'rm -f /var/www/html/logs/*.log'


# --- 清除 DLWEB 业务日志 ---

# 删除所有历史日志（保留今天）
docker exec youle-dlweb sh -c "
    find /var/www/html/api/logs/ -name '*.log' ! -name '$(date +%Y-%m-%d).log' -delete
"

# 删除全部日志文件
docker exec youle-dlweb sh -c 'rm -f /var/www/html/api/logs/*.log'


# --- 清除同步任务调试日志 ---

# 删除 30 天前的旧日志
docker exec youle-dlweb find /var/www/html/api/ext/debug/ -name '*.log' -mtime +30 -delete

# 删除所有历史日志（保留今天）
docker exec youle-dlweb sh -c "
    find /var/www/html/api/ext/debug/ -name '*.log' ! -name '$(date +%Y-%m-%d).log' -delete
"

# 清空今天的同步日志（保留文件）
docker exec youle-dlweb truncate -s 0 /var/www/html/api/ext/debug/synchronize/$(date +%Y-%m-%d).log

# 删除全部调试日志（所有子目录）
docker exec youle-dlweb sh -c '
    rm -f /var/www/html/api/ext/debug/synchronize/*.log
    rm -f /var/www/html/api/ext/debug/SynchronizeReportData/*.log
    rm -f /var/www/html/api/ext/debug/autotask/*.log
'
```

---

#### 3. 一键清理所有日志（docker logs + 业务日志）

> **警告：** 以下脚本将清空所有容器日志和全部业务日志文件，执行前请确认不需要保留现有日志。

```bash
#!/bin/bash
# 一键清理所有日志（在服务器 /opt/youle/game-docker/ 目录下执行）

echo '=== 清空 Docker 容器日志 ==='
for name in youle-nginx youle-api youle-dlweb youle-wxserver youle-syncjob youle-cronjob youle-redis youle-certbot; do
    logpath=$(docker inspect --format='{{.LogPath}}' $name 2>/dev/null)
    if [ -n "$logpath" ] && [ -f "$logpath" ]; then
        truncate -s 0 "$logpath"
        echo "  Cleared docker log: $name"
    fi
done

echo '=== 清空业务日志文件 ==='
# API 业务日志
docker exec youle-api sh -c 'rm -f /var/www/html/logs/*.log /var/www/html/source/logs/*.log 2>/dev/null; echo "  Cleared api logs"'

# DLWEB 业务日志 + 调试日志
docker exec youle-dlweb sh -c '
    rm -f /var/www/html/api/logs/*.log 2>/dev/null
    rm -f /var/www/html/api/ext/debug/synchronize/*.log 2>/dev/null
    rm -f /var/www/html/api/ext/debug/SynchronizeReportData/*.log 2>/dev/null
    rm -f /var/www/html/api/ext/debug/autotask/*.log 2>/dev/null
    echo "  Cleared dlweb logs"
'

echo '=== 完成 ==='
```

将以上内容保存为服务器上的 `/opt/youle/game-docker/clear-logs.sh`，赋予执行权限后使用：

```bash
chmod +x /opt/youle/game-docker/clear-logs.sh
/opt/youle/game-docker/clear-logs.sh
```

---

#### 4. 日志清理速查

| 目标 | 命令 |
|------|------|
| 清空某容器 docker logs | `truncate -s 0 $(docker inspect --format='{{.LogPath}}' 容器名)` |
| 清空今天 API 业务日志 | `docker exec youle-api truncate -s 0 /var/www/html/logs/$(date +%Y-%m-%d).log` |
| 清空今天同步调试日志 | `docker exec youle-dlweb truncate -s 0 /var/www/html/api/ext/debug/synchronize/$(date +%Y-%m-%d).log` |
| 删除所有调试历史日志 | `docker exec youle-dlweb find /var/www/html/api/ext/debug/ -name '*.log' -mtime +30 -delete` |
| 一键清理全部日志 | `./clear-logs.sh` |
```

---

### 场景九：从 Windows 本地查看和删除业务日志

> 以下命令在 **Windows PowerShell** 中执行，通过 SSH 直接读取服务器上的业务日志文件。  
> 日志来源目录（本地代码映射到容器的 Volume）：  
> - `api/logs/` → 容器内 `/var/www/html/logs/`  
> - `dlweb/api/ext/debug/` → 容器内 `/var/www/html/api/ext/debug/`

---

#### 查看日志

```powershell
# ── 获取今天的日期字符串 ──────────────────────────────────────────
$today = (Get-Date -Format "yyyy-MM-dd")

# ── api/logs ─────────────────────────────────────────────────────

# 列出所有日志文件
ssh root@47.98.203.17 "docker exec youle-api ls -lh /var/www/html/logs/"

# 查看今天的 API 业务日志（末尾 50 行）
ssh root@47.98.203.17 "docker exec youle-api tail -50 /var/www/html/logs/$today.log"

# 查看今天的 API 业务日志（完整内容）
ssh root@47.98.203.17 "docker exec youle-api cat /var/www/html/logs/$today.log"

# 实时跟踪今天的 API 业务日志（Ctrl+C 停止）
ssh root@47.98.203.17 "docker exec youle-api tail -f /var/www/html/logs/$today.log"


# ── dlweb/api/ext/debug/synchronize ──────────────────────────────

# 列出所有同步调试日志文件
ssh root@47.98.203.17 "docker exec youle-dlweb ls -lh /var/www/html/api/ext/debug/synchronize/"

# 查看今天的同步调试日志（末尾 50 行）
ssh root@47.98.203.17 "docker exec youle-dlweb tail -50 /var/www/html/api/ext/debug/synchronize/$today.log"

# 查看今天的同步调试日志（完整内容）
ssh root@47.98.203.17 "docker exec youle-dlweb cat /var/www/html/api/ext/debug/synchronize/$today.log"

# 实时跟踪同步调试日志（Ctrl+C 停止）
ssh root@47.98.203.17 "docker exec youle-dlweb tail -f /var/www/html/api/ext/debug/synchronize/$today.log"


# ── dlweb/api/ext/debug/SynchronizeReportData ────────────────────

ssh root@47.98.203.17 "docker exec youle-dlweb ls -lh /var/www/html/api/ext/debug/SynchronizeReportData/"
ssh root@47.98.203.17 "docker exec youle-dlweb tail -50 /var/www/html/api/ext/debug/SynchronizeReportData/$today.log"


# ── dlweb/api/ext/debug/autotask ─────────────────────────────────

ssh root@47.98.203.17 "docker exec youle-dlweb ls -lh /var/www/html/api/ext/debug/autotask/"
ssh root@47.98.203.17 "docker exec youle-dlweb tail -50 /var/www/html/api/ext/debug/autotask/$today.log"


# ── 一键汇总：同时查看两个目录今天的日志末尾 ─────────────────────

$today = (Get-Date -Format "yyyy-MM-dd")
ssh root@47.98.203.17 @"
echo '=== api/logs/$today.log ==='
docker exec youle-api tail -30 /var/www/html/logs/$today.log
echo
echo '=== synchronize/$today.log ==='
docker exec youle-dlweb tail -30 /var/www/html/api/ext/debug/synchronize/$today.log
echo
echo '=== SynchronizeReportData/$today.log ==='
docker exec youle-dlweb tail -30 /var/www/html/api/ext/debug/SynchronizeReportData/$today.log
"@
```

---

#### 删除日志

```powershell
# ── 获取今天的日期字符串 ──────────────────────────────────────────
$today = (Get-Date -Format "yyyy-MM-dd")

# ── api/logs ─────────────────────────────────────────────────────

# 清空今天的 API 业务日志（保留文件，清空内容）
ssh root@47.98.203.17 "docker exec youle-api truncate -s 0 /var/www/html/logs/$today.log"

# 删除今天的 API 业务日志文件
ssh root@47.98.203.17 "docker exec youle-api rm -f /var/www/html/logs/$today.log"

# 删除所有 API 业务日志（保留今天）
ssh root@47.98.203.17 "docker exec youle-api sh -c `"find /var/www/html/logs/ -name '*.log' ! -name '$today.log' -delete`""

# 删除全部 API 业务日志（含今天）
ssh root@47.98.203.17 "docker exec youle-api sh -c 'rm -f /var/www/html/logs/*.log'"


# ── dlweb/api/ext/debug ──────────────────────────────────────────

# 清空今天的同步调试日志（保留文件，清空内容）
ssh root@47.98.203.17 "docker exec youle-dlweb truncate -s 0 /var/www/html/api/ext/debug/synchronize/$today.log"

# 删除今天的同步调试日志文件
ssh root@47.98.203.17 "docker exec youle-dlweb rm -f /var/www/html/api/ext/debug/synchronize/$today.log"

# 删除 30 天前的旧调试日志（三个子目录）
ssh root@47.98.203.17 "docker exec youle-dlweb find /var/www/html/api/ext/debug/ -name '*.log' -mtime +30 -delete"

# 删除所有调试日志（保留今天，三个子目录）
ssh root@47.98.203.17 "docker exec youle-dlweb sh -c `"find /var/www/html/api/ext/debug/ -name '*.log' ! -name '$today.log' -delete`""

# 删除全部调试日志（含今天，三个子目录）
ssh root@47.98.203.17 @"
docker exec youle-dlweb sh -c '
  rm -f /var/www/html/api/ext/debug/synchronize/*.log
  rm -f /var/www/html/api/ext/debug/SynchronizeReportData/*.log
  rm -f /var/www/html/api/ext/debug/autotask/*.log
'
"@


# ── 一键清理：api/logs + dlweb/api/ext/debug 全部日志 ────────────

ssh root@47.98.203.17 @"
docker exec youle-api sh -c 'rm -f /var/www/html/logs/*.log'
docker exec youle-dlweb sh -c '
  rm -f /var/www/html/api/ext/debug/synchronize/*.log
  rm -f /var/www/html/api/ext/debug/SynchronizeReportData/*.log
  rm -f /var/www/html/api/ext/debug/autotask/*.log
'
echo "Done"
"@
```

---

#### 快捷速查表

| 操作 | PowerShell 命令 |
|------|----------------|
| 查看 api/logs 今天日志 | `ssh root@47.98.203.17 "docker exec youle-api cat /var/www/html/logs/$(Get-Date -Format 'yyyy-MM-dd').log"` |
| 查看同步调试日志 | `ssh root@47.98.203.17 "docker exec youle-dlweb tail -50 /var/www/html/api/ext/debug/synchronize/$(Get-Date -Format 'yyyy-MM-dd').log"` |
| 实时跟踪同步日志 | `ssh root@47.98.203.17 "docker exec youle-dlweb tail -f /var/www/html/api/ext/debug/synchronize/$(Get-Date -Format 'yyyy-MM-dd').log"` |
| 清空 api/logs 今天日志 | `ssh root@47.98.203.17 "docker exec youle-api truncate -s 0 /var/www/html/logs/$(Get-Date -Format 'yyyy-MM-dd').log"` |
| 清空同步调试日志 | `ssh root@47.98.203.17 "docker exec youle-dlweb truncate -s 0 /var/www/html/api/ext/debug/synchronize/$(Get-Date -Format 'yyyy-MM-dd').log"` |
| 删除全部调试日志 | `ssh root@47.98.203.17 "docker exec youle-dlweb sh -c 'rm -f /var/www/html/api/ext/debug/synchronize/*.log /var/www/html/api/ext/debug/SynchronizeReportData/*.log /var/www/html/api/ext/debug/autotask/*.log'"` |