First deploy checklist

阿里云 OSS 设置

本应用使用阿里云 OSS 存储上传/生成的图片和应用状态数据。

1. 配置阿里云 OSS

  • 在阿里云控制台创建 OSS Bucket。
  • 获取 AccessKey ID 和 AccessKey Secret。
  • 确保 Bucket 设置了适当的访问权限（建议使用签名 URL）。

2. Configure environment variables

  • ADMIN_USERNAME
  • ADMIN_PASSWORD
  • OSS_ACCESS_KEY_ID
  • OSS_ACCESS_KEY_SECRET
  • OSS_REGION
  • OSS_BUCKET
  • IMAGE2_API_BASE_URL
  • IMAGE2_API_KEY
  • IMAGE2_SUBMIT_PATH
  • IMAGE2_STATUS_PATH
  • IMAGE2_TIMEOUT_MS

3. First admin login

  • The app auto-creates the first admin from `ADMIN_USERNAME` and `ADMIN_PASSWORD`.
  • Open `/admin/login` after deploy and sign in once.

4. image2 placeholder mode

If `IMAGE2_API_BASE_URL` is empty, the app keeps the full upload, job, and download flow but returns the uploaded image as the generated result. This is useful for smoke-testing the whole site before wiring the real upstream API.