71 lines
2.8 KiB
Markdown
71 lines
2.8 KiB
Markdown
# StoryForge `storyforge.hyzq.net` 公网入口
|
|
|
|
当前公网接入不是把执行链整体迁到云服务器，而是：
|
|
|
|
1. 云服务器 `nginx` 提供 `https://storyforge.hyzq.net/`
|
|
2. 云服务器本地 `storyforge-web-v4.service` 承接静态前端
|
|
3. 云服务器本地 `collector-service` 直接承接业务 API 与数据库
|
|
4. 本机通过 SSH 反向隧道只桥接本地和局域网执行引擎到云服务器
|
|
|
|
当前已验证的 SSH 维护入口：
|
|
|
|
- `ubuntu@111.231.132.51`
|
|
- 公网部署目录：`/home/ubuntu/storyforge`
|
|
- systemd 服务：
|
|
- `storyforge-web-v4`
|
|
- `storyforge-collector`
|
|
- `nginx`
|
|
|
|
## 端口映射
|
|
|
|
- 云服务器 `127.0.0.1:8081` -> 云服务器本地 `collector-service`
|
|
- 云服务器 `127.0.0.1:19191` -> 云服务器本地 `StoryForge Web V4` 静态服务
|
|
- 云服务器 `127.0.0.1:15670` -> 本机 `n8n :5670`
|
|
- 云服务器不再默认依赖本机模型网关
|
|
- 云服务器 `127.0.0.1:28088` -> Windows `ASR :8088`
|
|
- 云服务器 `127.0.0.1:15678` -> 本机 `huobao :5678`
|
|
- 云服务器 `127.0.0.1:17860` -> 局域网 Windows `cutvideo :7860`
|
|
- 云服务器 `127.0.0.1:19106` -> 局域网 NAS `live-recorder :19106`
|
|
|
|
## 本机常驻服务
|
|
|
|
- `com.storyforge.cloud-bridge`
|
|
- 本机 `com.storyforge.collector` 可保留为本地开发，不再是公网必需项
|
|
- 本机 `com.storyforge.web-v4` 仍可保留为本地预览，不再是公网必需项
|
|
|
|
## 云服务器 `nginx` 路由
|
|
|
|
- `/` -> `127.0.0.1:19191`
|
|
- `/v2/*` -> `127.0.0.1:8081`
|
|
- `/openapi.json` -> `127.0.0.1:8081/openapi.json`
|
|
- `/healthz` -> `127.0.0.1:8081/healthz`
|
|
- `/downloads/*` -> `127.0.0.1:8081/downloads/*`
|
|
|
|
## 当前优点
|
|
|
|
- `collector-service` 和数据库已经上云，公网主链不再依赖本机业务 API
|
|
- 不需要把 `cutvideo / huobao / NAS live-recorder / 本机模型` 全部搬上云
|
|
- 公网入口统一
|
|
- 前端静态页不再依赖本机桥接
|
|
- 本地和局域网执行层不需要迁移即可继续提供能力
|
|
|
|
## 当前限制
|
|
|
|
- 本地桥接断开时，相关执行引擎会不可用，但登录和基础业务 API 仍可用
|
|
- 这仍是混合部署测试架构，不是最终完全云原生部署
|
|
|
|
## 标准化发布与回归
|
|
|
|
仓库内已经补了两个标准脚本：
|
|
|
|
```bash
|
|
./scripts/deploy_public_storyforge.sh
|
|
./scripts/smoke_public_storyforge.sh
|
|
```
|
|
|
|
说明：
|
|
|
|
- `deploy_public_storyforge.sh` 会备份远端 `web/storyforge-web-v4`，同步当前仓库的前端和 `collector-service/app`，重启 `storyforge-web-v4` / `storyforge-collector`，最后做公网 smoke。
|
|
- `smoke_public_storyforge.sh` 会检查公网 `/healthz`、`/`、`/assets/app.js` 和 `/openapi.json`，确认最新 Web bundle 与多平台路由都已经对外可见。
|
|
- 默认 SSH 口令可通过 `STORYFORGE_PUBLIC_PASSWORD` 传入，或从 macOS Keychain 的 `STORYFORGE_PUBLIC_KEYCHAIN_SERVICE` 读取；当前本机可沿用现有 `ai-glasses-debug-ssh` 条目。
|