docs(deploy): DEPLOY.md 对齐 2026-09-03 实测落地(NAT 端口模式)

- 拓扑现实:服务器在路由器 NAT 后,公网 80 被其他设备占用
- 对外访问实测:1Panel 域名管理加 公网IP:32002 + 路由器转发,零配置直访
- 修媒体解压路径 bug:包内根是 media/,须 -C yunke-server
- HTTPS 改为将来项:域名 + 1Panel DNS 验证(绕开被占的 80)

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-03 14:35:00 +08:00
parent 284cecfcd9
commit 0a5eb49359
+21 -13
View File
@@ -1,7 +1,9 @@
# 云客数据镜像 — 服务器部署 runbook(阿里云 ECS + 1Panel)
# 云客数据镜像 — 服务器部署 runbook(1Panel 服务器,2026-09-03 实测落地版)
> 2026-09-01 v2|形态:1Panel 管理,OpenResty 单站点反代,复用 1Panel MySQL,
> 形态:1Panel 管理,OpenResty 站点 + 公网高位端口,复用 1Panel MySQL,
> 数据从本地整体搬迁。本地开发栈(五服务 docker-compose.yml)不在本文范围。
> **实测拓扑**:服务器在路由器 NAT 后(网卡 192.168.100.x,公网 IP 为路由器,
> 公网 80 端口被同网其他设备占用)。
## 架构
@@ -30,9 +32,9 @@
- [ ] 1Panel 应用商店已装 **OpenResty**(建站依赖)
- [ ] 1Panel MySQL 版本 **8.x**;已建库 `yunke` + 专用用户,库权限设
「**所有区域(%)**」(容器从 docker 网段连入;3306 不对公网开,无风险)
- [ ] 域名已解析到 ECS 公网 IP,大陆区域已**备案**(80/443 必须)
- [ ] 阿里云安全组:公网只开 **80/443**;SSH 与 1Panel 面板端口限源 IP;
**3306 / 5173 / 8000 不对公网开**
- [ ] 对外访问走「1Panel 域名管理加 `公网IP:高位端口`(实测 32002)+
路由器端口转发到本机同端口」;**3306 / 5173 / 8000 不对公网开**
(公网 80 已被其他设备占用,域名+HTTPS 为将来可选项)
- [ ] Docker Hub 镜像加速:1Panel「容器→设置」里配加速器(拉 python/node/nginx
基础镜像用);apt/pip/npm/playwright 源已在 Dockerfile 内置国内镜像
- [ ] 服务器可访问 `crm2.yunkecn.com` 和 `*.oss.yunkecn.com`(抓取+媒体下载)
@@ -130,8 +132,9 @@ docker exec -i <1Panel-mysql容器名> mysql -uyunke -p<密码> \
# ⚠️ 86 万行 message 的 ngram 全文索引导入时重建,约 12 分钟——慢是正常,
# 不要中断;期间导入脚本看似卡在索引阶段属预期。
# 媒体:解到 bind mount 目录(compose 已挂 ./yunke-server/media)
tar xzf media.tar.gz # 解出 yunke-server/media/
# 媒体:解到 bind mount 目录(compose 已挂 ./yunke-server/media)。
# 包内根目录是 media/(打包时 -C yunke-server),必须 -C 解到 yunke-server 下
tar xzf media.tar.gz -C yunke-server
# 数据自带 alembic_version=head,不需要跑 alembic upgrade。
```
@@ -148,13 +151,18 @@ docker compose -f docker-compose.server.yml exec scheduler \
python scripts/scrape_via_page.py --entity messages --max-conversations 200
```
## 5. 站点 + HTTPS(1Panel)
## 5. 站点与对外访问(实测:1Panel 端口模式)
1. 「网站→创建网站→反向代理」:主域名填**真实域名**,代理地址
`127.0.0.1:5173`(已建好站点的话跳过)
2. 「网站→证书」:Let's Encrypt 申请该域名证书 → 网站设置里开启 HTTPS
3. 打不开/502 时排查:栈是否 Up(`docker compose -f docker-compose.server.yml ps`)、
`curl 127.0.0.1:5173` 是否通、OpenResty 是否 host 网络(1Panel 默认是)
1. 1Panel「网站→创建网站→反向代理」:代理地址 `127.0.0.1:5173`(已建则跳过)
2. 1Panel「网站→设置→域名管理」添加一条 `公网IP:高位端口`(实测
`219.157.255.213:32002`)→ 站点多监听该端口
3. 路由器端口转发:`外部 32002 → 192.168.100.132:32002`
4. 访问 `http://219.157.255.213:32002`,别人零配置直接用
5. 502 排查:栈是否 Up、`curl 127.0.0.1:5173` 是否通(OpenResty 是 host 网络,
1Panel 默认)
将来要 HTTPS:买真实域名 → 1Panel 证书走 **DNS 验证**(HTTP 验证需要 80,
已被占)→ 路由器加 443 转发。
前端登录鉴权即 `.env` 的 `API_TOKEN`(`Authorization: Bearer <token>` 或
`?token=`;**公网部署绝不能留空**)。