Files
yun-xue-tang-assistant/Dockerfile
T
void 17217dbeb1 feat: 考试结果页去重与跳课,构建镜像脚本支持国内换源
考试:
- 新增 src/exam-plan.js(纯函数)判定结果页处置:只有本页确实点过
  「提交考试/确定交卷」才算一次空卷交卷,平台恢复的旧结果页先回
  「考试说明页」重进,不再在结果页和课程页之间空转
- 重试也不会好的确定性失败(交卷次数到上限、说明页无「开始考试」、
  答卷页无「提交考试」、结果页反复回退)改为本轮跳过该课继续下一门,
  记录在 S.skippedCourses(sessionStorage),不会停下整轮刷课
- 新一轮开跑时清空 skippedCourses / examEmptySubmits,人工处理后可重试
- 补 dev/tests/exam-test.mjs(npm run test:exam,5 条用例)

构建:
- 新增 scripts/build-docker.mjs/.cmd/.sh(npm run docker:build):
  国内换源、按包版本打标签、构建后自检、--dry-run
- Dockerfile 增加 APT_MIRROR / NPM_REGISTRY 构建参数,
  docker-compose.yml 透传三个 build args,.env.example 补说明
2026-10-29 21:31:45 +08:00

112 lines
5.6 KiB
Docker
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.
# 云学堂助手 · 无头运行器镜像
#
# 设计要点(为什么是这些选择):
# · 基础镜像用 node:22-bookworm-slim —— runner/ 依赖全局 WebSocket / fetch,
# preflight.mjs 会硬性要求 Node 22+,低于这个版本连预检都过不去;
# · 浏览器装官方 google-chrome-stable,而不是 Debian 的 chromium:
# 发行版 chromium 不带 H.264/AAC 专有编解码器,课程视频会一直停在 0 秒
# (README「无图形环境常见的坑」里那条 error.code=4 就是这个原因);
# · 构建在镜像内完成(npm ci → npm run build),产物落在 /app 根目录,
# 所以镜像可以直接跑,不依赖宿主机先 build;
# · 容器内必然没有 DISPLAY,运行器会自动走无头;以 root 运行时
# platform.mjs / browser.mjs 会自动补 --no-sandbox 与 --disable-dev-shm-usage,
# 不需要在命令行里手写这些参数。
#
# 构建:docker build -t yun-xue-tang-assistant .
# 运行:见 docker-compose.yml 或 README「容器(Docker)」
FROM node:22-bookworm-slim
# 国内或内网环境从 dl.google.com 下不动时,可用内网镜像 / 本地文件替换:
# docker build --build-arg CHROME_DEB_URL=https://your-mirror/google-chrome-stable_current_amd64.deb .
# 留空则按架构自动取官网地址。
ARG CHROME_DEB_URL=
# Debian 官方源在国内经常慢到几百字节每秒,可用内网/国内镜像替换:
# docker build --build-arg APT_MIRROR=mirrors.tuna.tsinghua.edu.cn .
# 留空 = 保持基础镜像自带的 deb.debian.org
ARG APT_MIRROR=
# npm 同理(https://registry.npmmirror.com 之类),留空 = 官方源
ARG NPM_REGISTRY=
# tzdata 让日志时间戳跟随 TZ(默认给上海时区);fonts-noto-cjk 只影响截图观感,
# 但缺了它中文在页面里是方块,排查问题时不方便
ENV TZ=Asia/Shanghai \
DEBIAN_FRONTEND=noninteractive
# 注意:这段 RUN 里不要夹注释行——Docker 解析续行时可能把注释当成命令的一部分,容易把命令拼断。
# 步骤:装基础包 → 按架构下官方 Chrome deb → 用 apt 一次装齐依赖 → 清缓存 → 验证能起来。
# procps 提供 ps:运行器启动时靠它找「占着本 profile 的残留浏览器」并收掉(缺了也可跑,自愈会退化)。
RUN set -eux; \
if [ -n "$APT_MIRROR" ]; then \
sed -ri "s|deb.debian.org|${APT_MIRROR}|g" /etc/apt/sources.list.d/debian.sources /etc/apt/sources.list 2>/dev/null || true; \
echo "已切换 apt 源:$APT_MIRROR"; \
fi; \
apt-get update; \
apt-get install -y --no-install-recommends \
ca-certificates \
curl \
fonts-liberation \
fonts-noto-cjk \
gnupg \
procps \
tzdata \
wget; \
arch="$(dpkg --print-architecture)"; \
case "$arch" in \
amd64) chrome_deb="google-chrome-stable_current_amd64.deb" ;; \
arm64) chrome_deb="google-chrome-stable_current_arm64.deb" ;; \
*) echo "不支持的架构:$arch(可用 amd64 / arm64)" >&2; exit 1 ;; \
esac; \
chrome_url="${CHROME_DEB_URL:-https://dl.google.com/linux/direct/${chrome_deb}}"; \
echo "下载 Chrome:$chrome_url"; \
wget -q -O /tmp/chrome.deb "$chrome_url"; \
apt-get install -y --no-install-recommends /tmp/chrome.deb; \
rm -f /tmp/chrome.deb; \
rm -rf /var/lib/apt/lists/*; \
dpkg-query -W -f='chrome ${Version}\n' google-chrome-stable; \
timeout 60 google-chrome-stable --headless=new --no-sandbox --disable-gpu \
--disable-dev-shm-usage --dump-dom about:blank > /dev/null
WORKDIR /app
# 依赖层单独缓存:只有 lockfile 变了才重装。
# devDependencies 里的 esbuild 是构建注入脚本必需的,所以不能用 --omit=dev;
# 留着它也能让使用者在容器里直接 `npm run build`
COPY package.json package-lock.json ./
RUN set -eux; \
if [ -n "$NPM_REGISTRY" ]; then \
npm config set registry "$NPM_REGISTRY"; \
fi; \
npm ci --no-audit --no-fund
# 业务源码 + 构建脚本 + 无头运行器(node_modules / .run-profile / run-logs / .env 由 .dockerignore 排除)
COPY . .
# 构建注入浏览器用的单文件脚本,并确认产物真的生成了
RUN npm run build && test -s yun-xue-tang-assistant.user.js
# 运行期目录:profile(含登录 cookie)与日志。用命名卷 / 绑定挂载覆盖即可持久化
RUN mkdir -p /app/.run-profile /app/run-logs && chmod 700 /app/.run-profile
COPY docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh
# 用 tr 去掉可能存在的 CR(Windows 上检出后容易带 CRLF,shebang 会变成 /bin/sh\r,exec 直接报 exec format error),
# 然后当场用 sh -n 验一遍语法,把问题拦在构建阶段
RUN tr -d '\r' < /usr/local/bin/docker-entrypoint.sh > /tmp/ep.sh \
&& mv /tmp/ep.sh /usr/local/bin/docker-entrypoint.sh \
&& chmod +x /usr/local/bin/docker-entrypoint.sh \
&& sh -n /usr/local/bin/docker-entrypoint.sh
# 容器里没有图形会话,强制无头;面板需要 TTY,后台跑时保持关闭
# (`docker run -it -e YUN_XUE_TANG_TUI=1` 可以打开面板)
ENV YUN_XUE_TANG_HEADLESS=1 \
YUN_XUE_TANG_TUI=0 \
YUN_XUE_TANG_PROFILE_DIR=/app/.run-profile \
YUN_XUE_TANG_LOG_FILE=/app/run-logs/headless.log \
YUN_XUE_TANG_CHROME_BIN=/usr/bin/google-chrome-stable
# 凭据只走环境变量,不在镜像里 ENV(否则会被写进镜像层):
# docker run ... -e YUN_XUE_TANG_USR=账号 -e YUN_XUE_TANG_PWD=密码
ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
# 默认无参数:入口脚本在「没参数且没填凭据」时自动降级成 --check(只读自检)
CMD []