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

复制环境变量文件

克隆仓库后，在项目根目录复制示例配置：
cp .env.example .env
至少修改这些值：
Auth__Jwt__Secret=replace-with-a-strong-random-secret-32chars-min
Auth__BootstrapSuperAdmin__Username=admin
Auth__BootstrapSuperAdmin__Password=replace-with-a-strong-password
FRONTEND_VITE_API_BASE_URL=http://localhost:5121
如果你需要 MCP 或脚本访问，再额外启用 API key：
Auth__ApiKey__Enabled=true
Auth__ApiKey__Keys__0=replace-with-a-strong-random-api-key
2

启动容器

在仓库根目录执行：
docker compose up -d --build
默认会启动以下服务：
服务默认地址
前端http://localhost:5173
后端 APIhttp://localhost:5121
PostgreSQLlocalhost:5432
3

验证后端是否可用

先检查健康状态：
curl http://localhost:5121/api/v1/system/ping
再查看运行时引导信息：
curl http://localhost:5121/api/v1/system/bootstrap
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 技能
  • 复制公开地址或受保护内容地址
6

浏览公开画廊

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

​
接下来做什么

部署说明

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

存储 Provider

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