# 宝塔 + 宿主机 MySQL + Docker 应用（内网 30327）

与查价项目同一套模式：**MySQL 在宝塔，应用在 Docker**。

适用于：

- MySQL：**宝塔面板**，库名 `email_forecast`
- 应用：**Docker 容器**（web + worker）
- 代码目录：`/home/project/yubao`
- 访问：内网 `http://服务器IP:30327`

---

## 一、宝塔 MySQL 准备

1. 创建数据库 **`email_forecast`**
   - 字符集：**utf8mb4**
   - 校对规则：**utf8mb4_unicode_ci**（与 SQL 一致；选错会出现「字符集不一致可能导致恢复失败」）
2. 创建用户 **`email_forecast`**，赋予该库全部权限
3. 授权 Docker 网段（容器经 `host.docker.internal` 连宿主机）：

```sql
-- 在宝塔 phpMyAdmin 或终端执行（按实际密码改）
CREATE USER 'email_forecast'@'172.%' IDENTIFIED BY '你的强密码';
GRANT ALL PRIVILEGES ON email_forecast.* TO 'email_forecast'@'172.%';
FLUSH PRIVILEGES;
```

4. **推荐**：导入 `数据库/email_forecast.sql`（本机完整数据）；也可不导入，由 install 脚本 `prisma db push` + seed

### 测试（在服务器上）

```bash
mysql -h 127.0.0.1 -u email_forecast -p email_forecast
```

---

## 二、开发机打包

```powershell
cd X:\work\yx
powershell -ExecutionPolicy Bypass -File deploy\pack-server-upload.ps1
# 可选压缩便于上传
Compress-Archive -Path "上传到服务器\代码\*" -DestinationPath "yubao-code.zip" -Force
```

将 **`上传到服务器/代码/`** 解压到服务器 `/home/project/yubao/`。

---

## 三、配置 .env

```bash
cd /home/project/yubao
cp deploy/.env.bt-host-mysql.example .env
nano .env
```

必改项：

| 变量 | 说明 |
|------|------|
| `APP_PORT` | 对外端口，默认 `30327`（勿与 chajia 30325 冲突） |
| `PUBLIC_HOST` | 服务器内网 IP |
| `MYSQL_PASSWORD` | 宝塔里 email_forecast 用户密码 |
| `DATABASE_URL` | `mysql://email_forecast:密码@host.docker.internal:3306/email_forecast` |
| `SESSION_SECRET` | ≥32 字符随机串 |
| `APP_ADMIN_PASS` / `APP_OPS_PASS` | **不能**用 admin123/ops123，且二者须不同 |
| `OAUTH_PUBLIC_BASE_URL` | `http://内网IP:30327` |
| `CC_MOCK` | 无 CC 账号时 `true`；有账号改 `false` 并在设置页填凭据 |

密码含 `@`、`#` 等需 [URL 编码](https://www.urlencoder.org/)。

---

## 四、首次启动

```bash
chmod +x deploy/install-bt-host-mysql.sh
bash deploy/install-bt-host-mysql.sh
```

脚本会：校验 MySQL → 构建 web/worker → `prisma db push` → seed 账号 → 健康检查。

**不要**用根目录 `docker-compose.yml` 里的容器 MySQL（那是本地开发用的 7023 端口）。

---

## 五、更新代码

```bash
bash deploy/update-code-only-bt-host-mysql.sh
# Prisma schema 有变更时：
bash deploy/update-code-only-bt-host-mysql.sh --db-push
```

---

## 六、内网访问

| 用途 | 地址 |
|------|------|
| 登录 | `http://192.168.x.x:30327/login` |
| 邮件 | `http://192.168.x.x:30327/mails` |
| 健康检查 | `http://192.168.x.x:30327/api/health` |

---

## 七、宝塔防火墙

- 放行 **30327**（内网即可）
- **不要**对公网开放 3306

---

## 八、架构示意

```
内网浏览器 ──HTTP:30327──► [Docker] web (Next.js :3100)
                              │
                              ├──► [Docker] worker (IMAP 拉取 + 解析)
                              │
                              └──► host.docker.internal:3306
                                        │
                                   [宝塔] MySQL email_forecast
```

---

## 九、故障排查

| 现象 | 处理 |
|------|------|
| `Can't connect to MySQL` | 用户是否授权 `172.%`；`DATABASE_URL` 是否用 `host.docker.internal` |
| 生产启动报 SESSION_SECRET / 弱口令 | 改 `.env` 中 `SESSION_SECRET`、`APP_*_PASS` |
| Worker 不拉信 | `docker compose -f deploy/docker-compose.bt-host-mysql.yml logs -f worker`；检查设置页邮箱绑定 |
| 端口不通 | 宝塔防火墙、安全组是否放行 30327 |
| API 404（带 `[id]` 的路由） | Windows 打包方括号路径丢失；重新 `pack-server-upload.ps1` 并核对 RequiredRoutes |

---

## 十、导出本机库

```bash
# 本机（需 MySQL 客户端 + 本地 docker mysql 在跑）
bash deploy/database/export-local.sh
# 或直接：
# docker exec yx-mysql-1 mysqldump -uapp -papp email_forecast > deploy/database/email_forecast.sql
```