Skip to content

环境变量

后端配置由 backend/app/config.py 的 Settings(pydantic-settings)读取, 全部以环境变量或 backend/.env 文件注入;Go 控制面只从环境变量读取, 与 Python 共用同一份 .env。

应用与 API

变量默认值说明
APP_NAMEDyeingTime API应用名
DEBUGfalse调试开关
API_V1_PREFIX/api/v1接口路径前缀
CORS_ORIGINShttp://localhost:7788,http://127.0.0.1:7788允许的前端来源,逗号分隔

数据库

变量默认值说明
DATABASE_URLsqlite+aiosqlite:///./dyeingtime.db异步数据库连接串

生产使用 MySQL:

DATABASE_URL=mysql+aiomysql://user:pass@127.0.0.1:3306/dyeingtime

Redis / Celery

变量默认值说明
REDIS_HOSTlocalhostRedis 主机
REDIS_PORT6379Redis 端口
REDIS_DB0Redis 库号
REDIS_PASSWORD空Redis 密码
CELERY_BROKER_URL空直接指定完整 broker 地址时使用,优先于上面四项

鉴权与密钥加密

变量默认值说明
JWT_SECRET空必填。签发与校验访问令牌的 HMAC 密钥
JWT_EXPIRE_MINUTES720访问令牌有效期(分钟)
SECRETS_KEY空推荐必填。供应商密钥落库加密用的 Fernet 密钥

⚠️ SECRETS_KEY 未配置时,加密会回退为「从 JWT_SECRET 派生密钥」并打告警日志。 这意味着轮换 JWT_SECRET 会导致已加密的供应商密钥无法解密。生产环境请显式设置 SECRETS_KEY,生成方式:

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

存量明文密钥可用幂等迁移脚本就地加密(--dry-run 可先预览):

cd backend && uv run python scripts/encrypt_provider_keys.py --dry-run

Google 登录(可选)

变量默认值说明
GOOGLE_CLIENT_ID空Google OAuth 客户端 ID
GOOGLE_ALLOWED_EMAILS空允许登录的邮箱,逗号分隔;留空等于放行所有
GOOGLE_TOKENINFO_URLhttps://oauth2.googleapis.com/tokeninfo令牌校验地址

公网部署请务必配置 GOOGLE_ALLOWED_EMAILS 白名单。

邀请码 + 邮箱注册

变量默认值说明
FRONTEND_BASE_URLhttp://localhost:7788验证邮件链接指向的前端地址,必须浏览器可达
REGISTRATION_LINK_EXPIRE_MINUTES1440邮箱验证链接有效期(分钟)
REGISTRATION_RESEND_INTERVAL_SECONDS60同一邮箱重复请求验证邮件的冷却时间(秒)
SMTP_HOST空SMTP 主机;生产必须配置
SMTP_PORT587SMTP 端口
SMTP_USERNAME空SMTP 登录名
SMTP_PASSWORD空SMTP 密码
SMTP_FROM空发件人地址;留空回退为 SMTP_USERNAME
SMTP_FROM_NAMEDyeingTime发件人显示名
SMTP_USE_TLStrue587 端口通常用 STARTTLS
SMTP_USE_SSLfalse465 端口通常改为 SSL,并关闭 STARTTLS
SMTP_TIMEOUT_SECONDS15SMTP 连接与发送超时

非 DEBUG 环境未配置 SMTP_HOST 时,注册接口返回 503,而不是静默成功。 本地开发可设置 DEBUG=true 并留空 SMTP,验证链接会写入后端日志。 邀请码生成与管理见 邀请码注册运维。

对象存储(S3 兼容)

变量默认值说明
S3_ENDPOINT_URL空S3 端点;自建服务(RustFS / MinIO)填服务地址
S3_REGION_NAME空区域
S3_ACCESS_KEY_ID空Access Key
S3_SECRET_ACCESS_KEY空Secret Key
S3_BUCKET_NAME空桶名
S3_BASE_PATH空统一前缀,便于按环境/项目隔离
S3_PUBLIC_BASE_URL空浏览器可达的素材直链基址
S3_ADDRESSING_STYLEpath自建服务必须用 path;容器 DNS 无法解析虚拟主机名

素材直链直出依赖桶的公共读策略或签名 URL,S3_PUBLIC_BASE_URL 未配置时 前端无法展示已上传的图片。

生成接口默认参数(可选)

用于「演员/角色/道具/场景/服装/镜头帧图片生成任务」与 /film/generated_video:

变量说明
IMAGE_API_PROVIDER / IMAGE_API_BASE_URL / IMAGE_API_KEY图片生成默认供应商与凭据
VIDEO_API_PROVIDER / VIDEO_API_BASE_URL / VIDEO_API_KEY视频生成默认供应商与凭据

多数场景下不需要设置这些:供应商凭据在「模型管理」界面按 Provider 记录维护, 并以密文落库。

Go 控制面

变量默认值说明
GO_API_ADDR127.0.0.1:8001监听地址
GO_API_ENV_FILEbackend/.env环境文件路径(与 Python 共用同一份)
PYTHON_UPSTREAMhttp://127.0.0.1:8000写方法回落与文件下载代理的 Python 上游
APP_ENVdev运行环境标识

火山豆包语音目录同步(仅维护脚本)

以下变量只在运行 backend/scripts/sync_volcengine_voices.py 时使用,不写入数据库,也不参与运行时:

变量说明
VOLCENGINE_ACCESS_KEY_ID / VOLCENGINE_SECRET_ACCESS_KEY火山账号级只读 AK/SK,用于 ListSpeakers OpenAPI 签名
VOLCENGINE_VOICE_RESOURCE_IDS可选,逗号分隔,默认 seed-tts-2.0
VOLCENGINE_VOICE_PAGE_SIZE可选,默认 100

运行时 TTS 只需要 Provider 里的豆包语音 API Key;音色目录读取仓库内置的 voice_catalog.json。

Compose 部署

deploy/compose/.env 额外用到:

变量说明
MYSQL_ROOT_PASSWORD / MYSQL_PASSWORD数据库密码
MYSQL_DATABASE / MYSQL_USER库名与账号
MYSQL_PORT宿主机端口(被占用时改这里)
REDIS_PORT / REDIS_DBRedis 端口与库号
RUSTFS_ACCESS_KEY / RUSTFS_SECRET_KEY本地对象存储凭据
RUSTFS_PORT / RUSTFS_CONSOLE_PORT对象存储 API 与控制台端口
BACKEND_URL注入前端 /env.js,浏览器访问后端用的地址

前端运行时配置

前端与后端分端口部署时,运行时地址通过 front/public/env.js 注入:

window.__ENV = { BACKEND_URL: "http://localhost:8000" };