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、沙箱、验证码、时区、退出码与重启策略)。
This commit is contained in:
void committed 2026-10-26 22:02:08 +08:00
1 parent 65bf63ea6a
commit b588b1042f
9 files changed
+319 -4

No files matched your search

+54
View File
@@ -0,0 +1,54 @@
# 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"