VOZEB PRO 图生视频公网配置

适用场景：VOZEB PRO 运行在本机或内网，但图生视频上游模型需要从公网读取站内参考图片。

VOZEB PRO 会把站内参考图片转换为带签名和有效期的公网地址，再提交给视频模型。localhost、127.0.0.1 和私有网段不能被上游模型直接访问，因此需要配置一个可公开访问的 HTTPS 根地址。

本文以临时 Cloudflare Tunnel（trycloudflare.com）为例，适合本地测试，不建议作为长期生产方案。

一、开始前先了解风险

临时隧道会把 整个 VOZEB PRO 站点暴露到公网，而不仅是图片接口。

启用前请确认：

站点已经设置强管理员密码。

不把 .env、安装令牌、API Key、数据库密码和截图公开。

测试结束后及时关闭隧道。

生产环境使用固定域名、访问控制和正式的 Cloudflare Named Tunnel。

二、占位符说明

占位符	说明	示例
`<项目目录>`	VOZEB PRO 所在文件夹	`D:\软件\vozeb pro`
`<cloudflared路径>`	`cloudflared.exe` 的完整路径	`C:\Program Files (x86)\cloudflared\cloudflared.exe`
`<本地端口>`	VOZEB PRO 使用的本地端口	`3000`
`<公网地址>`	Cloudflare 生成的 HTTPS 地址	`https://example.trycloudflare.com`

使用时必须将整个占位符替换成真实内容，包括 < 和 >。

例如：

Set-Location '<项目目录>'

如果项目目录为 D:\软件\vozeb pro，实际命令为：

Set-Location 'D:\软件\vozeb pro'

三、确认本地服务正常

先在浏览器打开：

http://127.0.0.1:<本地端口>

默认端口为 3000：

http://127.0.0.1:3000

进一步检查完整就绪状态：

Invoke-WebRequest http://127.0.0.1:3000/api/health/ready

返回状态码 200 后再继续。/api/health/live 只证明应用进程存活，/api/health/ready 才会检查数据库、安装状态和生成 Worker 心跳。

四、准备 cloudflared

1. 安装或确认 cloudflared

如果尚未安装，请从 Cloudflare 官方渠道安装 cloudflared，并记住可执行文件的完整路径。

2. 检查版本

& '<cloudflared路径>' --version

示例：

& 'C:\Program Files (x86)\cloudflared\cloudflared.exe' --version

能够正常输出版本号后再启动隧道。

五、启动临时 Cloudflare Tunnel

打开一个新的 PowerShell 窗口，执行：

& '<cloudflared路径>' tunnel --url http://127.0.0.1:<本地端口>

示例：

& 'C:\Program Files (x86)\cloudflared\cloudflared.exe' tunnel --url http://127.0.0.1:3000

启动成功后，窗口中会出现类似下面的地址：

https://example.trycloudflare.com

这个地址就是后续使用的 <公网地址>。

注意事项

必须复制完整的 https://...trycloudflare.com 地址。

不要复制地址后面的日志文字。

不要关闭运行 cloudflared 的 PowerShell 窗口。

关闭窗口后，公网地址会立即失效。

每次重新启动临时隧道，公网地址通常都会变化。

隧道窗口是一个持续运行的前台进程，测试期间必须保持运行。

六、修改 `.env` 配置

打开项目根目录的 .env。VM Compose 部署通常位于项目根目录，而不是 deployment 子目录：

<项目目录>\.env

示例：

D:\软件\vozeb pro\.env

找到：

NEXT_PUBLIC_SITE_URL=http://localhost:3000

修改为：

NEXT_PUBLIC_SITE_URL=<公网地址>

如果 Cloudflare 生成的地址是：

https://example.trycloudflare.com

实际配置为：

NEXT_PUBLIC_SITE_URL=https://example.trycloudflare.com

地址格式要求

正确：

NEXT_PUBLIC_SITE_URL=https://example.trycloudflare.com

错误：

NEXT_PUBLIC_SITE_URL=<公网地址>
NEXT_PUBLIC_SITE_URL=https://example.trycloudflare.com/
NEXT_PUBLIC_SITE_URL=https://example.trycloudflare.com/api
NEXT_PUBLIC_SITE_URL=https://github.com/example/image.png
NEXT_PUBLIC_SITE_URL=C:\Users\用户名\Pictures\image.png

NEXT_PUBLIC_SITE_URL 必须是 VOZEB PRO 的公网根地址，不能填写：

本地图片路径

GitHub 图片页面

图片直链

API 接口路径

带额外路径的地址

七、重新创建主应用容器

修改 .env 后，主应用需要重新创建才能加载新变量。生成 Worker 不读取该公网地址，因此只需重建 app：

Set-Location '<项目目录>'
docker compose up -d --force-recreate app

例如：

Set-Location 'D:\软件\vozeb pro'
docker compose up -d --force-recreate app

该操作会重新创建主应用容器，不会主动删除：

数据库

用户资料

画布

历史生成记录

已上传素材

如果项目使用了自行维护的 Compose 文件或服务名，请以实际服务名为准。

八、检查环境变量和公网访问

1. 检查变量

docker exec vozeb-pro printenv NEXT_PUBLIC_SITE_URL

输出必须是刚才填写的公网地址：

https://example.trycloudflare.com

如果输出仍是旧地址，重新执行：

Set-Location '<项目目录>'
docker compose up -d --force-recreate app
docker exec vozeb-pro printenv NEXT_PUBLIC_SITE_URL

2. 检查公网健康接口

Invoke-WebRequest '<公网地址>/api/health/live'

示例：

Invoke-WebRequest 'https://example.trycloudflare.com/api/health/live'

预期返回状态码 200。

进一步检查完整就绪状态：

Invoke-WebRequest '<公网地址>/api/health/ready'

/api/health/ready 返回 200，说明数据库、安装和生成 Worker 状态正常。若只检查 /api/health/live，只能确认应用进程仍在运行。

也可以直接在浏览器打开：

<公网地址>/api/health/ready

九、使用本地图片生成视频

公网配置完成后，返回 VOZEB PRO：

打开或新建一个画布。

将本地图片上传到画布。

创建视频节点。

将图片节点连接到视频节点。

填写视频生成描述。

选择支持图生视频的模型。

设置画面比例、分辨率和时长。

点击“生成”。

本地图片路径仅用于上传，例如：

C:\Users\用户名\Pictures\cat.png

不要把本地图片路径填入 NEXT_PUBLIC_SITE_URL。

图片上传后，VOZEB PRO 会根据公网根地址生成模型服务可读取的签名图片地址。源码中的签名地址有效期为 15 分钟，有效期内上游需要完成参考图片读取。

画布中的“文本 → 生成配置 → 图片 → 视频”链路及视频播放时间轴。该截图展示生成结果，不单独证明公网隧道状态。

十、任务一直显示“生成中”

按以下顺序排查：

确认运行 cloudflared 的 PowerShell 窗口仍然打开。

检查公网健康接口：

Invoke-WebRequest '<公网地址>/api/health/ready'

检查 NEXT_PUBLIC_SITE_URL：

docker exec vozeb-pro printenv NEXT_PUBLIC_SITE_URL

确认修改 .env 后已经重建 app。

检查公网地址是否仍有效。

如果隧道已经失效，请重新启动：

& '<cloudflared路径>' tunnel --url http://127.0.0.1:<本地端口>

获得新的公网地址后，依次执行：

更新 .env。

重新创建主应用容器。

检查新的公网地址和健康状态。

重新提交视频任务。

已经失败的旧任务不会因为配置修复而自动恢复。

十一、界面显示红色 `success`

红色 success 不代表视频一定生成成功。部分模型服务可能返回类似下面的结构：

{
  "message": "success",
  "data": {
    "status": "failed",
    "error": {
      "message": "实际错误原因"
    }
  }
}

此时：

message: success 只表示查询接口调用成功。

data.status: failed 才表示视频任务本身失败。

如果出现红色 success，重点检查：

公网隧道是否在线

NEXT_PUBLIC_SITE_URL 是否为公网根地址

参考图片公网地址是否可以访问

主应用容器是否已经重新创建

模型服务是否成功读取参考图片

不同上游返回结构可能不同，应以实际响应体为准。

十二、电脑重启后的操作

临时 Cloudflare Tunnel 不会永久保存。电脑重启后需要：

启动 Docker Desktop。

启动 VOZEB PRO。

重新运行 cloudflared tunnel。

复制新生成的公网地址。

修改 .env 中的 NEXT_PUBLIC_SITE_URL。

重新创建 app 容器。

检查环境变量。

检查公网健康接口。

重新提交视频任务。

十三、临时隧道的限制

临时 trycloudflare.com 隧道适合测试，但存在以下限制：

每次启动的域名可能不同。

cloudflared 进程必须持续运行。

关闭 PowerShell 窗口后域名立即失效。

域名变化后需要修改 .env。

修改 .env 后必须重新创建主应用容器。

图片签名地址有效期约为 15 分钟。

整个站点会被公开访问，存在安全暴露面。

长期使用 VOZEB PRO 时，建议配置 Cloudflare Named Tunnel 并绑定固定域名，同时使用访问控制、备份和 HTTPS 安全策略。

VOZEB 图生视频公网配置

VOZEB PRO 图生视频公网配置

一、开始前先了解风险

二、占位符说明

三、确认本地服务正常

四、准备 cloudflared

1. 安装或确认 cloudflared

2. 检查版本

五、启动临时 Cloudflare Tunnel

注意事项

六、修改 `.env` 配置

地址格式要求

七、重新创建主应用容器

八、检查环境变量和公网访问

1. 检查变量

2. 检查公网健康接口

九、使用本地图片生成视频

十、任务一直显示“生成中”

十一、界面显示红色 `success`

十二、电脑重启后的操作

十三、临时隧道的限制

相关教程

VOZEB 图生视频公网配置

VOZEB PRO 图生视频公网配置#

一、开始前先了解风险#

二、占位符说明#

三、确认本地服务正常#

四、准备 cloudflared#

1. 安装或确认 cloudflared#

2. 检查版本#

五、启动临时 Cloudflare Tunnel#

注意事项#

六、修改 .env 配置#

地址格式要求#

七、重新创建主应用容器#

八、检查环境变量和公网访问#

1. 检查变量#

2. 检查公网健康接口#

九、使用本地图片生成视频#

十、任务一直显示“生成中”#

十一、界面显示红色 success#

十二、电脑重启后的操作#

十三、临时隧道的限制#

相关教程#

VOZEB PRO 图生视频公网配置

一、开始前先了解风险

二、占位符说明

三、确认本地服务正常

四、准备 cloudflared

1. 安装或确认 cloudflared

2. 检查版本

五、启动临时 Cloudflare Tunnel

注意事项

六、修改 `.env` 配置

地址格式要求

七、重新创建主应用容器

八、检查环境变量和公网访问

1. 检查变量

2. 检查公网健康接口

九、使用本地图片生成视频

十、任务一直显示“生成中”

十一、界面显示红色 `success`

十二、电脑重启后的操作

十三、临时隧道的限制

相关教程