114 lines
7.2 KiB
Docker
114 lines
7.2 KiB
Docker
# =============================================================================
|
||
# Nex Animation Studio · 单容器整站镜像(前端产物 + 后端 + ffmpeg 装在同一个镜像里)
|
||
#
|
||
# 为什么是一个镜像而不是六个容器:这个项目跑起来只需要 SQLite 和进程内线程池。
|
||
# · TASK_EXECUTOR=inline 时 app/services/daemon.py 的守护线程顶替 celery beat 做周期派发;
|
||
# · SERVE_FRONTEND=on 时 app/main.py 直接托管 frontend/dist 并做 SPA history 回落;
|
||
# · 于是「nginx 容器 + api + worker + beat + redis」这套拆分在这里没有必然性,
|
||
# 剩下的只是一个进程、一个端口、两个数据挂载点(./data 库 + ./media 产物)。
|
||
# 升级 = 换镜像,库和产物都在挂载点里不动。
|
||
# 这正是 scripts/server.sh 在裸机上跑的那套形态,只不过搬进了镜像。
|
||
# 真要多机/多 GPU 扩容,再叠加 -f docker-compose.scale.yml 切回 Postgres + Celery。
|
||
#
|
||
# 日常部署(进程配置读同目录 .env,模型配置与主密钥读 ./scripts/seed):
|
||
# docker compose up -d --build # 然后打开 http://localhost:8000
|
||
# docker compose logs -f app
|
||
# docker compose down # 数据留在 ./data 与 ./media
|
||
# 等价的裸命令:
|
||
# docker build -t nex-animation:latest .
|
||
# docker run -d --name nex-animation -p 8000:8000 \
|
||
# -v $PWD/data:/app/data -v $PWD/media:/app/media \
|
||
# -v $PWD/scripts/seed:/app/scripts/seed:ro nex-animation:latest
|
||
# 少了 -v $PWD/media 会怎样:出片写进容器可写层,`up --force-recreate` 之后
|
||
# 页面上一片 404,而且文件跟着容器一起被删——产物比镜像贵得多,别赌。
|
||
#
|
||
# 国内网络:构建期只有三个下载点,默认值全部已指向国内源,零配置即可用——
|
||
# npm -> NPM_REGISTRY(默认 npmmirror,且 package-lock.json 的 211 条 resolved 本身就锁在 npmmirror)
|
||
# pip -> PIP_INDEX_URL(默认清华)
|
||
# apt -> APT_MIRROR(默认清华)
|
||
# 基础镜像 BASE_IMAGE / NODE_IMAGE 也在 --build-arg 里;服务器上已有这两个镜像时,
|
||
# `docker compose up -d --build` 不加 --pull 就不会联网重拉。境外构建反过来传官方源即可。
|
||
# 构建期**没有任何 huggingface 下载**:听写权重(465M)只在裸机 server.sh install 时才拉。
|
||
# =============================================================================
|
||
ARG BASE_IMAGE=python:3.12-slim
|
||
ARG NODE_IMAGE=node:22-alpine
|
||
|
||
# ---------- 1/2 前端构建 ----------
|
||
FROM ${NODE_IMAGE} AS webbuild
|
||
ARG NPM_REGISTRY=https://registry.npmmirror.com
|
||
WORKDIR /web
|
||
# 先只拷两个清单文件:改一个 .tsx 不该让 npm ci 重跑一遍(这一层能缓存住)
|
||
COPY frontend/package.json frontend/package-lock.json ./
|
||
RUN npm config set registry "${NPM_REGISTRY}" \
|
||
&& npm ci --cache /tmp/npm-cache --no-audit --no-fund
|
||
COPY frontend/ ./
|
||
# build = tsc --noEmit && vite build:类型不过就地构建失败,比在服务器上炸便宜得多
|
||
RUN npm run build
|
||
|
||
# ---------- 2/2 运行镜像 ----------
|
||
FROM ${BASE_IMAGE}
|
||
ARG PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
|
||
ENV PYTHONUNBUFFERED=1 \
|
||
PYTHONDONTWRITEBYTECODE=1 \
|
||
PIP_NO_CACHE_DIR=1 \
|
||
PIP_DISABLE_PIP_VERSION_CHECK=1 \
|
||
TZ=Asia/Shanghai
|
||
WORKDIR /app
|
||
|
||
# 装三个包,缺一不可,而且后两个的缺失是「静默出错」而不是报错:
|
||
# ffmpeg 时间线合成、抽帧、时长/码率质检全靠调它(app/services/ffmpeg.py),
|
||
# 缺了它的表现是「导出成片一路 500」而不是起不来;
|
||
# fontconfig 提供 fc-list / fc-scan —— services/ffmpeg.py 靠它们按 charset
|
||
# 反查「哪个字体真的含中文字形」,没有 fc-list 就只能退到写死的路径清单;
|
||
# fonts-noto-cjk 烧字幕必须有真的含中文字形的字体。slim + --no-install-recommends
|
||
# 连 DejaVu 都不带,libass 找不到字形**不报错**,直接画一排豆腐块,
|
||
# 字幕质检和成片一起废(本轮真实踩过,见 ffmpeg.py 注释)。
|
||
# 嫌它 +120MB 就换成 fonts-wqy-microhei(+10MB,同样在候选清单里)。
|
||
# 源同样是可覆盖的:deb822 与老式 sources.list 里 bookworm 的 /debian 与 /debian-security
|
||
# 都在 deb.debian.org 下,一次替换就够。默认给清华:实测直连 deb.debian.org 光这一层就要
|
||
# 200+ 秒,清华 0.24 秒拿到 Release;境外构建显式传回 --build-arg APT_MIRROR=deb.debian.org。
|
||
ARG APT_MIRROR=mirrors.tuna.tsinghua.edu.cn
|
||
RUN for f in /etc/apt/sources.list.d/debian.sources /etc/apt/sources.list; do \
|
||
[ -f "$f" ] && sed -i "s|deb\.debian\.org|${APT_MIRROR}|g; s|security\.debian\.org|${APT_MIRROR}|g" "$f"; \
|
||
done; \
|
||
apt-get update \
|
||
&& apt-get install -y --no-install-recommends \
|
||
ffmpeg fontconfig fonts-noto-cjk \
|
||
&& rm -rf /var/lib/apt/lists/*
|
||
|
||
# 依赖单独一层:requirements.txt 里带着 psycopg,将来切 Postgres 扩容不必重建镜像骨架
|
||
COPY backend/requirements.txt ./backend/
|
||
RUN pip install --retries 5 --timeout 60 -i "${PIP_INDEX_URL}" -r backend/requirements.txt
|
||
|
||
# 代码布局保持和仓库一致(backend/ + scripts/ + frontend/dist),一个都不挪:
|
||
# app/config.py 用 parents[2] 反推仓库根、scripts/seed.py 用同一个办法找 backend/ 和数据集,
|
||
# 镜像里改布局就会让「.env 找不到」「数据集看不见」这两类静默失灵重演。
|
||
# PYTHONPATH 指向 backend/ 是为了 uvicorn、celery、seed.py 三种入口都能 import app.*——
|
||
# celery 没有 uvicorn 的 --app-dir 可用,不指它 worker 起不来。
|
||
COPY backend/app ./backend/app
|
||
COPY scripts ./scripts
|
||
COPY --from=webbuild /web/dist ./frontend/dist
|
||
|
||
# 容器内一律用绝对路径:宿主 .env 里那套 ./media、./nex_animation.db 是开发机视角,
|
||
# 换个工作目录就漂;库和媒体必须落在挂载点上才扛得住镜像升级。
|
||
# 库与媒体分家(/app/data 只放 SQLite,/app/media 只放产物):产物会长到几十上百 GB,
|
||
# 迟早要单独挪大盘 / 单独备份 / 被 rsync 与剪辑软件直接读,和「一个不能写坏的库文件」
|
||
# 绑在同一个挂载点上,做这些动作时就得先把整目录停服拷走。
|
||
ENV DATABASE_URL=sqlite:////app/data/nex_animation.db \
|
||
MEDIA_ROOT=/app/media \
|
||
PYTHONPATH=/app/backend \
|
||
SERVE_FRONTEND=on \
|
||
TASK_EXECUTOR=inline \
|
||
AUTO_SEED=only-missing
|
||
# 模型配置(model_specs 表)不在这里、也不在 .env:首启由入口脚本从 ./scripts/seed 灌进库。
|
||
# 镜像以 root 运行:macOS 的 bind mount 只有 root 写 ./data 与 ./media 最省心。
|
||
# Linux 想换非特权账号:在 compose 里加 user: "1000:1000" 并把两个目录属主对齐。
|
||
RUN mkdir -p /app/data /app/media
|
||
EXPOSE 8000
|
||
# /health 在 AUTH_ENABLED=true 时也免登录(监控探针和 server.sh verify 都靠它)。
|
||
# slim 里没有 curl,就用自带 python 探,别为一条健康检查装一串包。
|
||
HEALTHCHECK --interval=30s --timeout=5s --start-period=25s --retries=3 \
|
||
CMD python -c "import urllib.request,sys;sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8000/health',timeout=4).status==200 else 1)"
|
||
ENTRYPOINT ["/app/scripts/docker-entrypoint.sh"]
|
||
CMD ["uvicorn","app.main:app","--host","0.0.0.0","--port","8000"]
|