Files
yun-xue-tang-assistant/docker-compose.yml
T
void b588b1042f feat: 无头运行器 Docker 镜像
把 runner/ 打包成可直接部署的容器镜像,Linux 服务器 / 群晖 / 云主机上
不用再手动装 Node 与浏览器。

- Dockerfile:node:22-bookworm-slim + 官方 google-chrome-stable。
  刻意不用发行版 chromium —— 它不带 H.264/AAC 专有编解码器,课程视频会
  一直停在 0 秒;同时满足 preflight.mjs 对 Node 22+ 的硬性要求。
  构建期完成 npm ci + npm run build,并实跑一次 headless 验证浏览器可用;
  CHROME_DEB_URL 构建参数供国内换镜像源。
- docker/entrypoint.sh:建 profile / 日志目录;首参为 sh/node 等时直接 exec
  便于排查;无参数且无凭据时降级成 --check,避免容器无意义重启空转。
- docker-compose.yml:挂载 ./.run-profile 与 ./run-logs,shm_size 512m,
  init: true,日志轮转。restart 用 on-failure:3 而非 always —— 运行器刷完课
  会以 0 正常退出,always 会造成「刷完 → 重启 → 再刷完」的热循环。
- .dockerignore:排除 node_modules / .run-profile / run-logs / .env,
  凭据不进镜像层。
- .env.example:账号模板;.gitignore 加 !.env.example 白名单。
- .gitattributes:*.sh / Dockerfile / docker-compose.yml 强制 LF —— 带 CRLF
  时 shebang 会变成 "/bin/sh\r",容器启动直接 exec format error。
- scripts/check.mjs:静态检查扩展到容器入口,跑 sh -n 并对 CRLF 报错
  (Windows 无 sh 时只校验行尾)。29 个文件全绿。
- README:新增「容器(Docker)」小节,含 build / 自检 / run / compose 流程
  与 8 条注意事项(卷权限、/dev/shm、沙箱、验证码、时区、退出码与重启策略)。
2026-10-26 22:02:08 +08:00

55 lines
3.1 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# docker compose 用法:
# cp .env.example .env # 填账号密码(.env 已在 .gitignore 里,不会入库)
# docker compose build
# docker compose run --rm yun-xue-tang --check # 先自检(只读,不登录)
# docker compose run --rm yun-xue-tang --max-courses 3 # 只刷 3 门,跑完就退
# docker compose up -d # 正式后台刷课
# docker compose logs -f # 跟随日志(也可 tail -f ./run-logs/headless.log)
# docker compose down # 停(SIGTERM → 暂停视频 → 关浏览器)
#
# 凭据走 environment 插值(compose 会自动读同目录的 .env),而不是 env_file:
# 这样 .env 不存在时也不会直接报错,入口脚本会降级成 --check。
services:
yun-xue-tang:
build: .
image: yun-xue-tang-assistant:latest
container_name: yun-xue-tang
# 为什么不是 unless-stopped:运行器「刷完了」会以退出码 0 正常退出,
# 而 unless-stopped / always 不看退出码,会造成「退出 → 立即重启 → 又刷完 → 再重启」的
# 热循环,反复请求平台。on-failure 只在非 0 时重试,正常收尾就停下。
# 想让它长期挂着,用运行器自己的 restartMinutes / budgetMinutes(见 config/runner.config.mjs),
# 或用 cron 定期 `docker compose up -d`。
restart: on-failure:3
# 自带一个极小的 init(tini)当 PID 1:node 是它 exec 出来的子进程,
# 信号照常透传(SIGTERM 仍能让运行器收尾),同时回收 Chrome 被收养的孤儿进程
init: true
environment:
TZ: "${TZ:-Asia/Shanghai}"
# 凭据只走环境变量,绝不写进镜像或提交到仓库
YUN_XUE_TANG_USR: "${YUN_XUE_TANG_USR:-}"
YUN_XUE_TANG_PWD: "${YUN_XUE_TANG_PWD:-}"
# 面板要求 stdout 是 TTY,后台跑必须关(默认就是关的,这里显式写出来防误改)
YUN_XUE_TANG_TUI: "0"
# 本次最多完成几门课;0 = 不限
YUN_XUE_TANG_MAX_COURSES: "${YUN_XUE_TANG_MAX_COURSES:-100}"
volumes:
# 持久化登录态(cookie / localStorage):删掉该目录等于重置登录与进度缓存
# 注意:与裸机运行共用同一个目录,容器内以 root 写入,宿主机上会是 root 所有
- ./.run-profile:/app/.run-profile
# 日志跟着宿主机走,方便 tail -f
- ./run-logs:/app/run-logs
# 容器内 /dev/shm 默认 64MB,Chrome 多标签时容易崩;给大一点更稳
# (运行器本身也加了 --disable-dev-shm-usage 兜底)
shm_size: 512m
# 运行器是前台进程,不需要端口映射(CDP 只监听容器内 127.0.0.1)
stop_grace_period: 30s
security_opt:
# 容器内 Chrome 沙箱受限,运行器会自动加 --no-sandbox;
# seccomp 默认策略也会拦 Chrome 的 namespace 调用,放宽到 unconfined 更省事
- seccomp=unconfined
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"