# 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: context: . # apt / npm 镜像源可在 .env 里覆盖(APT_MIRROR / NPM_REGISTRY),留空则用默认官方源 args: APT_MIRROR: "${APT_MIRROR:-}" NPM_REGISTRY: "${NPM_REGISTRY:-}" CHROME_DEB_URL: "${CHROME_DEB_URL:-}" 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"