药材谷 · 服务器与端口部署规划
冻结版本：2026-10-06 ｜ 口径来源：王先生语音指令 ｜ 性质：长期有效，服务器更换/迁移时必读
最高保护令（王先生 2026-10-06 原话口径）："外部项目那个你不要动啊，那个已经上服务器了，在香港的服务器上。你把外部项目的啥东西挤掉了……你不要动它。"
外部项目（情怀陪伴服务，端口 8000）为独立项目，已部署香港服务器 + APK 挂 (外部项目域名)。本地 8000 端口只是它的遗留进程——任何情况下：不修改、不重启、不挤占、不合并。药材谷的一切部署永远绕开 8000。
实测存证（2026-10-06）：/health → {"ok":true,"model":"ext-model","pwm_model":"pwm-evo-r1","corpus_files":121,"version":"1.1.0"} 全绿，从未被动过。
一、端口冻结表（本地开发机 · 记死）
| 端口 | 归属 | 服务内容 | 入口 / 说明 | 状态 |
|---|
| 80 | 药材谷 网页端 | _serve_web.py 静态服务，根目录=正式代码_2026-10-06 | http://127.0.0.1/ → 直达板块总汇（302），王先生的日常入口 | 药材谷专用 |
| 8979 | 药材谷 后端 API | FastAPI 24 模块 / 180 接口，含 /portal 中文导航、本地化 /docs | /portal（技术联调用） | 药材谷专用 |
| 8000 | 外部项目（勿动） | 情怀陪伴服务 v1.1.0，独立项目 | 已上香港服务器，本地仅遗留进程 | 勿动 |
✅ 端口整合完成（2026-10-06）：药材谷已收敛为 两服务模型 —— 80 网页端 + 8979 后端。
· 8978 老原型：23 个独有设计稿已并入 80 端口服务范围（现可达），其余 225 页已无损归档至 原稿留底/8978并入_20261006/
· 4000 老 demo 后端：经全站扫描，零业务页依赖（业务页全部调用 8979 模块命名接口），且含金融类接口（撞死命令②），已判定为僵尸服务并停机
· 口径统一：全站地图、部署规划、页面调用全部收敛为「80 + 8979」，不再有这里一个东、那里一个西
二、药材谷挂香港服务器 · 重点分析（王先生点名）
结论先行：能挂，而且现阶段挂香港是最合适的选择。理由与注意事项逐条如下，不藏着掖着。
✅ 有利条件（为什么能挂）
- 技术栈零改造：药材谷三件套 = 静态 HTML 页面（80 网页端）+ FastAPI（8979 后端）+ Node.js（4000 主服务），全是标准 Linux 应用，香港服务器（Ubuntu/Debian）原生支持，代码一行不用改。
- 免备案，域名即买即用：香港服务器绑域名不需要 ICP 备案。王先生"买个域名还得放上去"——注册完域名、加一条 A 记录解析到服务器 IP，当天就能访问。这是对比国内服务器最大的优势（国内必须备案，周期 2~4 周，且要企业主体）。
- 当前阶段合规压力小：药材谷现在处于演示 + 原型阶段，无支付、无实名认证、无敏感个人信息收集（页面数据均为示例数据），展示类业务跨境托管没有实质障碍。
- 境外客户访问友好：若后续有港/澳/海外药材商客户，香港节点访问反而比内地服务器更快。
⚠️ 注意事项（诚实暴露，不吹）
- 延迟：内地访问香港约 30~80ms（视线路），比国内服务器高。网页浏览、点单操作无感；行情 WebSocket 推送（45s 周期）完全够用。属可接受范围。
- 跨境数据合规：现在是示例数据无风险；将来正式运营若收集境内用户个人信息，需按《个人信息保护法》及出境相关规定评估（标准合同 / 安全评估）。这正是王先生定的三段式——手续办妥迁国内——的原因，方向完全正确。
- 带宽：香港轻量机常见 5~30Mbps，跑当前规模（静态页 + 24 模块 API）绰绰有余；将来上线图片/视频密集板块需升级带宽或加 CDN。
- 可靠性：服务器选主流云服务商的香港轻量机型，避开小作坊 NAT 机，IP 被墙风险低且支持换 IP。
三、香港部署清单（到时照单执行）
| 层次 | 方案 | 说明 |
|---|
| 系统 | Ubuntu 22.04 LTS | 与本地开发环境最接近，教程最多 |
| Web 层 | Nginx（80/443） | 托管静态页（板块总汇+各板块 HTML）；反代 /api → uvicorn 8979、/main → node 4000 |
| 应用层 | Python 3.11+ / Node 18+ | uvicorn 跑 main.py（24 模块）；node 跑 server.js |
| 进程守护 | systemd × 3 | yaocaigu-web / yaocaigu-api / yaocaigu-node，开机自启、崩溃自动拉起 |
| HTTPS | Let's Encrypt (certbot) | 域名解析生效后一条命令签发，自动续期免费 |
| 数据 | SQLite 随代码 + cron 每日备份 | 备份保留 7 天滚动 |
| 安全 | ufw 只开 22/80/443 | 8979/4000 只监听 127.0.0.1，由 Nginx 反代对外，不裸奔 |
四、三段式部署路线（王先生冻结口径）
王先生原话："还得还要走香港的服务器，暂时啊，等国内的公司和其他手续办下来了之后，才咱们才要放国内的服务器。"
| 阶段 | 载体 | 动作 | 状态 |
|---|
| 第一段 · 现在 | 本地开发机 | 80 网页端 + 8979 后端 + 4000 主服务 + 8978 老原型，功能联调、页面收编、数据准备 | 进行中 |
| 第二段 · 注册域名后 | 香港服务器 | 注册域名 → A 记录解析 → 照第三节清单部署 → HTTPS → 药材谷正式对外演示，发给客户/合伙人看 | 待域名 |
| 第三段 · 手续办妥后 | 国内服务器 | ICP 备案（需公司主体，2~4 周）→ 数据库/文件迁移 → 域名解析切换到国内 IP；香港服务器保留作回退，不退租 | 待手续 |
域名计划
- 选型口径：.com / .cn / .net 任一；注册商不限，选解析管理一体化的即可。
- 名称候选（待王先生拍板）：
yaocaigu.com（第一优先）＞ yaocaigu.cn ＞ ycgu.com 等，先查可注册性。
- 解析：A 记录 → 香港服务器 IP；将来迁国内只改 A 记录指向，域名不变、用户无感。
五、本文件的地位
本文件 = 药材谷部署的口径基准。以后凡是换服务器、注册域名、上线上架，先读这里对齐口径再动手；端口表与三段式未经王先生同意不得变更。同步已写入 WorkBuddy 长期记忆（8000 勿动 + 三段式），每次会话我都会记得。