nex_animation/.env.example

133 lines
5.8 KiB
Bash
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# ============================================================
# Nex Animation Studio · 运行时配置(复制为 .env 后按需修改)
# 变量名 = backend/app/config.py 中 Settings 字段的大写下划线形式
# ============================================================
# ---------- Docker 部署(docker compose 读这份文件做变量插值并注入容器)----------
# 只有这一节是「给 compose 看的」,其余都是应用运行时配置(app/config.py 的字段)。
# 默认形态是一个容器(单端口整站 + SQLite + inline 调度),见 docker-compose.yml 头部。
# HOST_PORT 对外端口;容器内固定 8000,与 Dockerfile 的 EXPOSE/健康检查对齐
# AUTO_SEED 容器首启灌 ./scripts/seed 数据包的方式:
# only-missing 只补库里没有的(默认,不动服务器上改过的默认位)
# force 包里说的算 / off 跳过
# APP_DATABASE_URL / APP_MEDIA_ROOT
# 容器内的库与媒体路径。默认落在挂载点 /app/data 下 —— 别在 .env 里
# 写宿主机相对路径(./media 之类),那会让库和产物落在容器可写层里,
# 下次 `up --force-recreate` 直接蒸发;宿主路径只在 compose 的挂载那一行改。
# BASE_IMAGE / NODE_IMAGE / PIP_INDEX_URL / NPM_REGISTRY
# 拉不到 docker.io 或装包慢时覆盖成公司内网/国内镜像源
# POSTGRES_* / CELERY_CONCURRENCY 只有叠加 docker-compose.scale.yml 时才用到
# HOST_PORT=8000
# AUTO_SEED=only-missing
# BASE_IMAGE=python:3.12-slim
# NODE_IMAGE=node:22-alpine
# PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
# NPM_REGISTRY=https://registry.npmmirror.com
# ---------- 基础设施 ----------
POSTGRES_DB=nexanimation
POSTGRES_USER=nex
POSTGRES_PASSWORD=change_this_password
DATABASE_URL=postgresql+psycopg://nex:change_this_password@db:5432/nexanimation
REDIS_URL=redis://redis:6379/0
MEDIA_ROOT=/app/media
MEDIA_URL_PREFIX=/media
CORS_ORIGINS=*
LOG_LEVEL=INFO
# ---------- 鉴权与账号 ----------
# 默认开启:/api/* 与 /media/* 都要会话(nex_session Cookie,脚本可用 Authorization: Bearer)。
# 库里还没有用户时,首启自动播种下面这个管理员并标记「需改密」;登录后请立刻改口令。
# 关掉只适合可信内网:AUTH_ENABLED=false 时任何人裸奔可写(含改模型配置)。
AUTH_ENABLED=true
BOOTSTRAP_USERNAME=admin
BOOTSTRAP_PASSWORD=admin1234
# COOKIE_NAME=nex_session
# ---------- 前端托管 ----------
# off = 只出 API,页面由 Vite(scripts/dev.sh)或单独的 nginx 提供
# (frontend/Dockerfile + nginx.conf 是「前端另发一份」时的镜像,默认单容器用不到)
# on = 后端一并托管 frontend/dist 并做 SPA history 回落,对外只有一个端口
# (scripts/server.sh 与 docker-compose.yml 的默认形态都是它;缺 dist 时只告警,不会起不来)
SERVE_FRONTEND=off
# FRONTEND_DIST_DIR= # 留空 = <仓库根>/frontend/dist
# ---------- 任务执行后端 ----------
# celery = 生产模式(Redis broker + worker + beat)
# inline = 单机模式(进程内线程池 + 内置守护调度器,无需 Redis,便于开发/自检)
TASK_EXECUTOR=celery
# CELERY_BROKER_URL=redis://redis:6379/0
# CELERY_RESULT_BACKEND=redis://redis:6379/1
INLINE_WORKERS=2
CELERY_CONCURRENCY=2
# ---------- 调度中心:限流 / 重试 / 断点续跑 ----------
DISPATCH_INTERVAL_SECONDS=5
DISPATCH_BATCH_SIZE=32
MAX_SHOT_RETRIES=3
MAX_COMPOSE_RETRIES=2
RETRY_BACKOFF_BASE_SECONDS=5
RETRY_BACKOFF_MAX_SECONDS=300
STALE_RUNNING_SECONDS=900
DEFAULT_PROVIDER_CONCURRENCY=2
DEFAULT_PROVIDER_RPM=30
# ---------- 视频模型(mock 便于自检;真实模型请在「调度中心」登记 provider_models)----------
VIDEO_PROVIDER=mock
VIDEO_MODEL=mock-video-1
VIDEO_API_BASE_URL=
VIDEO_API_KEY=
VIDEO_POLL_INTERVAL_SECONDS=5
VIDEO_POLL_TIMEOUT_SECONDS=1800
# ---------- ComfyUI(自建大模型,如 MiniMax H3)----------
# 填了 COMFYUI_BASE_URL 就会自动注册 comfyui/<COMFYUI_MODEL> 到模型注册表。
# 更细的参数(模型文件名、步数、画布像素、上传子目录)在「调度中心 → 模型注册表 → config」里改,
# 页面上的 🔌 探测会列出机器上真实存在的 UNET / CLIP / VAE / LoRA 文件名。
COMFYUI_BASE_URL=
COMFYUI_WORKFLOW=minimax_h3
COMFYUI_MODEL=minimax-h3
COMFYUI_STEPS=20
COMFYUI_TIMEOUT_SECONDS=5400
# 单卡串行即可;并发调高只会让显存争抢、整体更慢
COMFYUI_CONCURRENCY=1
COMFYUI_RPM=6
# 用真实模型作为默认视频模型时:VIDEO_PROVIDER=comfyui / VIDEO_MODEL=minimax-h3
# VIDEO_PROVIDER=comfyui
# VIDEO_MODEL=minimax-h3
# ---------- 配音 TTS ----------
# 真实配音用 comfyui_tts(IndexTTS2,部署机 ComfyUI 提供,Linux 可用);
# 声线在「资产库 → 声线」配置:绑真人参考音频走 zero-shot 克隆,
# 只填「音色描述」则由描述词直出。
TTS_PROVIDER=mock
TTS_API_BASE_URL=
TTS_API_KEY=
TTS_VOICE=demo-voice
# ---------- 合成引擎 ----------
DEFAULT_FPS=24
DEFAULT_WIDTH=1920
DEFAULT_HEIGHT=1080
TARGET_LUFS=-16.0
XFADE_MAX_DURATION_MS=1200
FFMPEG_THREADS=0
FFMPEG_PRESET=medium
FFMPEG_CRF=20
# ---------- 自动质检阈值 ----------
QC_DURATION_TOLERANCE=0.35
QC_MIN_BITRATE_KBPS=200
QC_BLACK_THRESHOLD=0.98
# ---------- 成本台账 ----------
COST_CURRENCY=CNY
DEFAULT_VIDEO_PRICE_PER_SECOND=0.0
DEFAULT_TTS_PRICE_PER_1K_CHARS=0.0
# ---------- 上传白名单(一般无需修改)----------
# UPLOAD_IMAGE_EXTENSIONS=.png,.jpg,.jpeg,.webp,.gif,.bmp,.tif,.tiff
# UPLOAD_VIDEO_EXTENSIONS=.mp4,.mov,.webm,.mkv,.m4v,.avi
# UPLOAD_AUDIO_EXTENSIONS=.mp3,.wav,.m4a,.aac,.flac,.ogg,.opus
# UPLOAD_DOC_EXTENSIONS=.txt,.md,.csv,.tsv,.json,.srt,.ass,.vtt,.zip,.docx