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

+39
View File
@@ -0,0 +1,39 @@
#!/bin/sh
# 容器入口:只做三件事——兜底默认路径、保证 profile / 日志目录存在、必要时降级成自检。
# 所有实际逻辑仍在 runner/headless.mjs 里,这里不复制任何业务判断,避免两处行为分叉。
#
# docker run 镜像 → 没凭据则 --check(只读自检),有凭据则正式刷课
# docker run 镜像 --max-courses 3 → 参数原样透传给运行器
# docker run -it 镜像 sh → 进容器排查
set -e
PROFILE_DIR="${YUN_XUE_TANG_PROFILE_DIR:-/app/.run-profile}"
LOG_FILE="${YUN_XUE_TANG_LOG_FILE:-/app/run-logs/headless.log}"
export YUN_XUE_TANG_PROFILE_DIR="$PROFILE_DIR"
export YUN_XUE_TANG_LOG_FILE="$LOG_FILE"
mkdir -p "$PROFILE_DIR" "$(dirname "$LOG_FILE")"
# profile 里有登录 cookie,收窄权限(挂载卷时可能已经是宿主机权限,失败就算了)
chmod 700 "$PROFILE_DIR" 2>/dev/null || true
# 第一个参数是可执行文件时直接 exec,方便 docker run -it 镜像 sh / node -v 之类排查
case "${1:-}" in
sh|bash|node|npm|google-chrome|google-chrome-stable|chromium)
exec "$@"
;;
esac
# 没有参数且没填凭据:跑正式刷课只会被预检拦下(退出码 2),容器会反复重启。
# 这里降级成 --check,让容器稳定地给出「环境 OK 但缺凭据」的结论。
if [ "$#" -eq 0 ]; then
if [ -z "${YUN_XUE_TANG_USR:-}" ] || [ -z "${YUN_XUE_TANG_PWD:-}" ]; then
{
echo "[入口] 未提供凭据,改为只读自检(--check):不登录、不点课程、不动进度。"
echo "[入口] 正式刷课请带上环境变量:"
echo "[入口] docker run -e YUN_XUE_TANG_USR=账号 -e YUN_XUE_TANG_PWD=密码 ..."
} >&2
set -- --check
fi
fi
exec node /app/runner/headless.mjs "$@"