把 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、沙箱、验证码、时区、退出码与重启策略)。
55 lines
3.1 KiB
YAML
55 lines
3.1 KiB
YAML
# 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"
|