#!/usr/bin/env bash # 预览实例管理脚本: 见 compose.yaml 顶部说明。 # # ./preview.sh up 构建定制产物并启动预览 (http://127.0.0.1:2081) # ./preview.sh down 停止预览(保留数据) # ./preview.sh reset 停止并删除预览数据(下次全新安装) # ./preview.sh logs 跟踪日志 # ./preview.sh ps 查看状态 # ./preview.sh shell 进入容器 # ./preview.sh admin 在预览实例里建一个管理员(用于验证登录后的页面) # ./preview.sh check 构建校验 + 首页文案/页脚/元信息抽查 # # 说明: 本机 docker 需要 docker 组权限; 当前 shell 没有时会自动改用 # `sg docker -c ...`(sg 读 /etc/group 的成员关系, 不需要 sudo)。 set -euo pipefail HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" ROOT="$(cd "${HERE}/.." && pwd)" COMPOSE_FILE="${HERE}/compose.yaml" PORT="${PREVIEW_PORT:-2081}" BASE_URL="http://127.0.0.1:${PORT}" export PREVIEW_UID="$(id -u)" export PREVIEW_GID="$(id -g)" # 是否需要套 sg docker if docker info >/dev/null 2>&1; then compose() { docker compose -f "${COMPOSE_FILE}" "$@"; } elif command -v sg >/dev/null 2>&1 && sg docker -c 'docker info' >/dev/null 2>&1; then compose() { sg docker -c "docker compose -f '${COMPOSE_FILE}' $*"; } else echo "✗ 当前用户没有 docker 权限(既不能直连, 也不能通过 docker 组)" >&2 exit 1 fi prepare() { # 生成定制产物(语言文件等) python3 "${ROOT}/build.py" --quiet # 预建数据目录: 属主等于当前用户, 容器 entrypoint 就不会对只读挂载做 chown。 # .ssh 必须由我们建: 否则容器以 root 建出 0700 目录, 降权后的 gitea 进程 # 写不了 authorized_keys。 mkdir -p "${HERE}/data/gitea/conf" "${HERE}/data/git/.ssh" "${HERE}/data/ssh" chmod 700 "${HERE}/data/git/.ssh" } case "${1:-}" in up) prepare compose up -d echo "预览地址: ${BASE_URL} (数据目录: ${HERE}/data)" echo "首次启动约需 10~30 秒; 用 ./preview.sh logs 观察进度" ;; down) compose down ;; reload) # 模板改完必须重启才生效(prod/dev 都一样); 语言文件在 dev 下会自动热加载 python3 "${ROOT}/build.py" --quiet compose restart gitea echo "已重启, 预览地址: ${BASE_URL}" ;; reset) compose down if ! rm -rf "${HERE}/data" 2>/dev/null; then # 容器可能以 root 身份建过 data/git/.ssh(0700), 宿主用户删不掉; # 用一次性 root 容器清掉再删(正常流程不会走到这里, 见 prepare 的说明)。 compose run --rm -T --user 0 --entrypoint /bin/sh gitea -c 'rm -rf /data/git /data/ssh' >/dev/null rm -rf "${HERE}/data" fi echo "已清空预览数据" ;; logs) compose logs -f --tail=100 ;; ps) compose ps ;; shell) compose exec gitea bash ;; admin) USERNAME="${2:-previewadmin}" PASSWORD="${3:-previewadmin123}" # -u git: gitea 命令拒绝以 root 运行 compose exec -T -u git gitea gitea admin user create \ --username "${USERNAME}" --password "${PASSWORD}" \ --email "${USERNAME}@example.com" --admin --must-change-password=false echo "管理员: ${USERNAME} / ${PASSWORD}" ;; check) python3 "${ROOT}/build.py" --check --quiet fail=0 ok() { echo "✓ $1"; } bad() { echo "✗ $1" fail=1 } html="$(mktemp)" trap 'rm -f "${html}"' EXIT curl -fsS "${BASE_URL}/" -o "${html}" grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容" grep -q "assets/tjhlp/ask-guide.html" "${html}" && ok "导航栏/首页已指向课程提问指南" || bad "没找到提问指南链接" ! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${html}" && ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案" ! grep -qi "powered by" "${html}" && ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by" ! grep -q "docs.gitea.com" "${html}" && ok "页面已无 docs.gitea.com 外链" || bad "仍有 docs.gitea.com 外链" grep -q 'name="description" content="同济大学高级语言程序设计课程答疑平台"' "${html}" && ok "meta description 已替换" || bad "meta description 未替换" curl -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" && ok "custom/public 静态页可访问" || bad "提问指南静态页 404" # --- 与课程官网的联动 ------------------------------------------------- grep -q "http://10.80.42.185/Website/" "${html}" && ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接" grep -q "http://10.80.42.185/Website/ask-question/" "${html}" && ok "首页已链接官网《学会提问》" || bad "首页没有《学会提问》链接" guide="$(mktemp)" curl -fsS "${BASE_URL}/assets/tjhlp/ask-guide.html" -o "${guide}" grep -q "Website/ask-question/" "${guide}" && ok "站内提问指南已回链官网" || bad "站内提问指南没有官网链接" rm -f "${guide}" ! grep -rq "example.com" "${ROOT}/../issue-templates/" && ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com" ! grep -q "工单" "${ROOT}/custom/options/locale/locale_zh-CN.json" && ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」" # --- 登录页 ----------------------------------------------------------- login="$(mktemp)" curl -fsS -H 'Accept-Language: zh-CN' "${BASE_URL}/user/login" -o "${login}" grep -q "管理员登录" "${login}" && ok "登录页有独立的「管理员登录」卡片" || bad "登录页缺少管理员登录卡片" ! grep -q "webauthn-error\|signin-passkey" "${login}" && ok "登录页已无空的通行密钥(WebAuthn)方框" || bad "登录页仍有通行密钥区块" grep -q 'id="external-login-navigator"' "${login}" || echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)" rm -f "${login}" [ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项" exit "${fail}" ;; *) sed -n '2,18p' "$0" exit 1 ;; esac