# 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 / 私有运营入口，更接近“公网可访问的现网桥接”，不是最终完全云原生部署