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

+28 -4
View File
@@ -19,7 +19,7 @@ import { fileURLToPath } from 'node:url';
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
/** 要遍历的目录(JS 与 bat 一起收;scripts/ 也在里面,含本文件自己) */
const DIRS = ['runner', 'dev', 'scripts', 'config'];
const DIRS = ['runner', 'dev', 'scripts', 'config', 'docker'];
/** 顶层要单独检查的文件(构建产物不入源码校验,它在 scripts/ 下重新生成后自然被覆盖) */
const FILES = ['yun-xue-tang-assistant.user.js'];
const SKIP_DIRS = new Set(['node_modules', '.git', '.run-profile', 'run-logs', '.run-tmp']);
@@ -29,7 +29,7 @@ function walk(dir, out = []) {
const p = path.join(dir, ent.name);
if (ent.isDirectory()) {
if (!SKIP_DIRS.has(ent.name)) walk(p, out);
} else if (/\.m?js$|\.cmd$|\.bat$/i.test(ent.name)) {
} else if (/\.m?js$|\.cmd$|\.bat$|\.sh$/i.test(ent.name)) {
out.push(p);
}
}
@@ -38,11 +38,13 @@ function walk(dir, out = []) {
const jsTargets = [];
const cmdTargets = [];
const shTargets = [];
for (const d of DIRS) {
const dir = path.join(ROOT, d);
if (fs.existsSync(dir)) {
for (const f of walk(dir)) {
if (/\.m?js$/.test(f)) jsTargets.push(f);
else if (/\.sh$/i.test(f)) shTargets.push(f);
else cmdTargets.push(f);
}
}
@@ -110,10 +112,32 @@ for (const file of cmdTargets.sort()) {
}
}
const total = jsTargets.length + cmdTargets.length;
// ---- 3. 容器入口脚本:sh -n 语法 + 必须是 LF 行尾 ----
// 容器的 entrypoint 若带 CRLF,shebang 会变成 "/bin/sh\r",直接报 exec format error。
// Windows 上不一定有 sh(纯 CMD / PowerShell 环境),找不到就跳过语法检查,但行尾照样校验。
const hasSh = spawnSync('sh', ['-c', 'exit 0'], { stdio: 'ignore' }).status === 0;
for (const file of shTargets.sort()) {
const rel = path.relative(ROOT, file);
const buf = fs.readFileSync(file);
const bad = [];
const crlf = buf.indexOf('\r\n') >= 0;
if (crlf) bad.push('含 CRLF 行尾;容器里的 sh 会把 shebang 读成 "/bin/sh\\r" 而报 exec format error');
if (hasSh) {
const r = spawnSync('sh', ['-n', file], { encoding: 'utf8' });
if (r.status !== 0) bad.push((r.stderr || '').trim());
}
if (bad.length) {
failed++;
console.error(' FAIL ' + rel);
for (const b of bad) console.error(' - ' + b);
}
}
const total = jsTargets.length + cmdTargets.length + shTargets.length;
if (failed) {
console.error('\n静态检查:' + failed + '/' + total + ' 个文件失败');
process.exit(1);
}
console.log('静态检查:' + total + '/' + total + ' 个文件通过'
+ '(JS ' + jsTargets.length + ' · 批处理 ' + cmdTargets.length + ')');
+ '(JS ' + jsTargets.length + ' · 批处理 ' + cmdTargets.length
+ ' · 容器入口 ' + shTargets.length + (hasSh ? '' : '(当前环境无 sh,仅校验行尾)') + ')');