storyforge/deploy/STORYFORGE_PUBLIC_GATEWAY.md

StoryForge storyforge.hyzq.net 公网入口

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

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

端口映射

• 云服务器 127.0.0.1:18181 -> 本机 127.0.0.1:8081
• 云服务器 127.0.0.1:19191 -> 云服务器本地 StoryForge Web V4 静态服务

本机常驻服务

• com.storyforge.collector
• com.storyforge.cloud-bridge
• 本机 com.storyforge.web-v4 仍可保留为本地预览，不再是公网必需项

云服务器 nginx 路由

• / -> 127.0.0.1:19191
• /v2/* -> 127.0.0.1:18181
• /openapi.json -> 127.0.0.1:18181/openapi.json
• /healthz -> 127.0.0.1:18181/healthz
• /downloads/* -> 127.0.0.1:18181/downloads/*

当前优点

• 不需要把 cutvideo / huobao / NAS live-recorder / 本机模型 全部搬上云
• 公网入口统一
• 前端静态页不再依赖本机桥接
• 本机现网能力不需要改造即可对外开放

当前限制

• 本机 API 桥接断开时，登录和业务 API 不可用
• 这是公网 staging / 私有运营入口，更接近“公网可访问的现网桥接”，不是最终完全云原生部署