跳转到主要内容
上线前一定要替换默认密钥。 .env.example 里的 JWT 密钥、SuperAdmin 密码和 API key 都只是占位值，不能直接暴露到公网。
1

复制环境变量文件

克隆仓库后，在项目根目录复制示例配置：
至少修改这些值：
如果你需要 MCP 或脚本访问，再额外启用 API key：
2

启动容器

在仓库根目录执行：
默认会启动以下服务：
3

验证后端是否可用

先检查健康状态：
再查看运行时引导信息：
bootstrap 端点会返回 apiKeyRequired、maxUploadSizeBytes 和 allowedContentTypes。它用于让前端了解当前运行配置，不用于确认 SuperAdmin 是否已经创建。
4

登录管理后台

打开 http://localhost:5173/login。使用你在 .env 中设置的 Auth__BootstrapSuperAdmin__Username 和 Auth__BootstrapSuperAdmin__Password 登录。注意：只有在数据库里尚不存在 SuperAdmin 时，首次启动才会自动创建该账号。如果你换了一套新环境变量但沿用了旧数据库，旧账号不会被覆盖。
5

上传第一张图片

打开 http://localhost:5173/assets，点击 Upload 上传图片。上传后你可以：
  • 切换 isPublic 让它出现在公开画廊
  • 在资产详情页运行 AI 技能
  • 进入 /workflows 配置可复用 workflow，并决定是否在上传后自动运行
  • 复制公开地址或受保护内容地址
6

浏览公开画廊

打开 http://localhost:5173/gallery。只有 isPublic=true 且状态为 ready 的资产会展示在这里。

​
接下来做什么

部署说明

查看反向代理、域名、HTTPS、分域部署和生产注意事项。

工作流

了解如何配置 workflow profile、自动运行和资产详情页手动触发。

存储 Provider

了解如何从默认本地存储切换到 S3 兼容存储或 GitHub Repo。