用户诉求是「镜像已有,其它依赖考虑国内加速」。先把全链路的外部下载点摸了一遍, 结论:**构建镜像不需要 huggingface**——唯一的 HF 地址在 scripts/server.sh, 只在裸机 install 的 fetch_asr_model() 里用到,而且容器里根本没有 whisper-cli, 那条 curl 在 Docker 路径下永远不会执行;requirements.txt 只有 8 个包(没有任何 whisper/hub 依赖),models/ 也被 .dockerignore 排掉。构建期真正的下载点只有 npm / apt / pip 三个,此前 npm 与 pip 已是国内源,只有 apt 还默认 deb.debian.org (实测这一层要 200+ 秒,清华 0.24 秒拿到 Release)。 改动: - Dockerfile:APT_MIRROR 默认改清华(境外显式传回 deb.debian.org);apt 清单 ffmpeg → ffmpeg fontconfig fonts-noto-cjk。后两个是真 bug 修复——slim + --no-install-recommends 连 DejaVu 都不带,libass 找不到中文字形**不报错**, 直接把烧的字幕画成一片豆腐块;services/ffmpeg.py 又要靠 fc-list/fc-scan 按 charset 反查字体,所以 fontconfig 也一并装上。装完代码零改动: _FONT_FILE_CANDIDATES 里已写着 fonts-noto-cjk 的落盘路径。嫌 +120MB 可换 fonts-wqy-microhei(+10MB)。 - server.sh / dev.sh:新增 PIP_INDEX_URL / NPM_REGISTRY / ASR_DOWNLOAD_URL 三组 可覆盖变量,优先级 环境变量 > .env > 内置默认,键名与 Dockerfile 的 --build-arg 完全一致(容器和裸机同一套口径);pip 一律带 -i、npm 一律带 --registry; ASR 权重默认走 hf-mirror(huggingface.co 国内实测 0.04s 直接连接重置)。 - server.sh install 新增中文字体探测:复用 app.services.ffmpeg.cjk_font_catalog(), 查不到就 warn,别等出片了才发现字幕是方块。 - 四处默认值对齐(Dockerfile / docker-compose.yml / server.sh / dev.sh)。 - README §3.2 新增「依赖下载点与国内源」表:五个下载点各自发生在什么时候、 用哪个键、默认值是什么,并点明浏览器侧 Google Fonts 是最后一处外部依赖 (只影响访问者,要彻底离线需自托管);工程规范 §5 补一条「依赖源只有一套键、 默认即国内,判据是新机器零配置能装起来」。 验证:bash -n 两个脚本通过;字体探针正反向都跑过(本机 49 个中文字体 → exit 0); docker compose config 服务仍只有 app、args 渲染出新默认值;deploy.sh --check 19 项全绿; pytest -k "ffmpeg or subtitle or font or asr or speech or quality" 35 passed 1 skipped (未改后端代码,故未跑全量)。docker build 本机验证不了(Docker daemon 没起), 需在服务器上构建确认。 |
||
|---|---|---|
| .. | ||
| ui | ||
| deploy.sh | ||
| dev.sh | ||
| docker-entrypoint.sh | ||
| e2e_selfcheck.py | ||
| evidence_prune.py | ||
| seed.py | ||
| server.sh | ||