storyforge/deploy/STORYFORGE_PUBLIC_GATEWAY.md

StoryForge storyforge.hyzq.net 公网入口

当前公网接入不是把执行链整体迁到云服务器，而是：

1. 云服务器 nginx 提供 https://storyforge.hyzq.net/
2. 云服务器本地 storyforge-web-v4.service 承接静态前端
3. 云服务器本地 collector-service 直接承接业务 API 与数据库
4. 本机通过 SSH 反向隧道只桥接本地和局域网执行引擎到云服务器

端口映射

• 云服务器 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:18317 -> 本机模型网关 :8317
• 云服务器 127.0.0.1:18088 -> 本机 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 仍可用
• 这仍是混合部署测试架构，不是最终完全云原生部署