部署与配置 AngeMedia Gateway
部署时先保证凭据和数据能持久化，再考虑新增 Provider、队列并发和外部访问。
推荐部署方式
长期运行优先使用仓库提供的 Docker Compose。它将 Gateway、队列和依赖服务放在同一套可复现配置中。
export ADMIN_USERNAME=admin
export ADMIN_DEFAULT_PASSWORD='换成足够长的随机密码'
export GATEWAY_API_KEY='换成足够长的随机网关密钥'
docker compose up -d --build
最低必要配置
| 变量 | 用途 | 建议 |
|---|---|---|
ADMIN_USERNAME | Web Studio 管理员用户名 | 使用非默认用户名 |
ADMIN_DEFAULT_PASSWORD | 首次管理员密码 | 使用长随机密码，不提交仓库 |
GATEWAY_API_KEY | API 模式和受保护媒体访问 | 与管理员密码分开保存 |
Provider 配置
SILICONFLOW_API_KEY=
MODELSCOPE_API_KEY=
POLLINATIONS_API_KEY=
AGNES_API_KEY=
OPENAI_IMAGE_API_KEY=
OPENAI_IMAGE_BASE_URL=https://api.openai.com/v1
OPENAI_IMAGE_MODEL=gpt-image-2
只填写实际使用的 Provider。空白 Provider 不应影响其他渠道。
超时
IMAGE_PROVIDER_TIMEOUT=300
VIDEO_PROVIDER_TIMEOUT=900
视频任务通常比图片任务更久。先保持默认值；只有确认 Provider 正常但任务在网关端提前超时时再调整。
持久化内容
- 数据库：任务、事件、尝试和去重状态。
- 上传目录：参考图片和临时输入。
- 生成目录：已经本地化的图片和视频。
- 本地配置：管理员、Gateway Key 和 Provider 设置。
启动后验证
- 检查
/health。 - 登录 Studio，确认 Dashboard 能读取任务和存储状态。
- 连接测试一个 Provider。
- 生成一张图片并确认资产页可打开结果。
- 重启容器，确认管理员配置、任务和资产仍在。