#!/usr/bin/env bash # ===================================================================== # editor-api 一键部署 / 迁移脚本 # ===================================================================== # 用途:在一台全新机器上(或从快过期的机器上迁走)用一条命令把 # 「在线编辑文章」的后端跑起来。所有状态都在两个目录里: # $BLOG_DIR = 博客仓库的 git 工作区(内容就在这里) # $APP_DIR = compose + .env(只有这一个文件是手写的) # 迁移 = 复制这两个目录 / 或在新机器上重跑本脚本。 # # 用法: # CNB_TOKEN=xxx EDITOR_TOKEN=yyy bash bootstrap.sh # # 必填环境变量: # CNB_TOKEN CNB 访问令牌(用户名固定 cnb)。只用于 git clone 与 push。 # EDITOR_TOKEN 与 Cloudflare Worker 里 EDITOR_TOKEN **完全相同**的共享令牌 # (Worker 转发时会带上,后端用它鉴权;浏览器永远看不到) # ADMIN_PASS 后台登录页的密码(账号固定 admin,默认 3070210zz)。 # 后台登录走 editor-api 签发的 Cookie 会话,不再用 nginx basic auth。 # # 可选环境变量(都有默认值): # CNB_URL 默认 https://cnb.cool/zqlit/blog.git # GITEA_URL 默认 http://23.254.236.47:3001/zqlit/blog.git(自建 Gitea 辅仓) # GITEA_USER 默认 zqlit # GITEA_PASS 可选:Gitea 的密码 / 访问令牌。**给了才会把 gitea 加进推送远端**, # 否则 PUSH_REMOTES 自动降级成只推 origin(CNB 主仓)。 # ★ 不传时会**自动复用 $APP_DIR/.env 里上次写下的值** —— # 免得「重跑一次」把辅仓推送静默关掉(见脚本内注释)。 # BLOG_DIR /srv/blog 仓库工作区 # APP_DIR /srv/editor-api compose + .env # TRASH_DIR /srv/editor-trash 删除文章的回收目录(故意放在仓库外) # BIND_PORT 8017 只绑 127.0.0.1 # PUSH_REMOTES origin,gitea 发布时依次推送的远端 # GIT_AUTHOR_NAME / GIT_AUTHOR_EMAIL / BLOG_BASE # # ★ 远端与备份定案(2026-10-06): # - CNB(remote `origin`):**主仓**,唯一的 fetch 源,推送即触发 CNB 构建 # - 自建 Gitea(remote `gitea`,23.254.236.47:3001):**代码同步辅仓**, # 只作代码留档与找回,不参与构建(.github/ 已删,Actions 早已停用) # - GitHub(GH_URL / GH_SSH_KEY / remote `gh`):账号被平台标记、仓库被按 # AUP 清空 → 已彻底移除,别再往回加 # - Gitee:单仓 500MB / 单文件 50MB 两道硬门槛,本仓 `bin/linux/hugo` # 是 83.1MB → 未采用 # - OpenList(中兴 F50 上的加密 bundle,scripts/backup-bundle.mjs, # Windows 计划任务 Blog-BundleBackup 每天 03:30):**备选异地备份**, # 与 git 远端无关,独立于上面三者 # 推送语义见 editor-api/src/git.mjs:逐个远端推、**主仓成功即算发布成功**, # 辅仓失败只警告不阻断 —— 所以 gitea 挂了不会让文章发不出去。 # ===================================================================== set -euo pipefail say() { printf '\033[1;36m==> %s\033[0m\n' "$*"; } die() { printf '\033[1;31m!! %s\033[0m\n' "$*" >&2; exit 1; } : "${CNB_TOKEN:?必须设置 CNB_TOKEN(CNB 访问令牌,用户名固定 cnb)}" : "${EDITOR_TOKEN:?必须设置 EDITOR_TOKEN(与 Cloudflare Worker 里的一致)}" : "${ADMIN_PASS:?必须设置 ADMIN_PASS(后台登录密码,账号固定 admin)}" CNB_URL="${CNB_URL:-https://cnb.cool/zqlit/blog.git}" BLOG_DIR="${BLOG_DIR:-/srv/blog}" APP_DIR="${APP_DIR:-/srv/editor-api}" TRASH_DIR="${TRASH_DIR:-/srv/editor-trash}" BIND_PORT="${BIND_PORT:-8017}" GIT_AUTHOR_NAME="${GIT_AUTHOR_NAME:-blog-editor}" GIT_AUTHOR_EMAIL="${GIT_AUTHOR_EMAIL:-editor@usj.cc}" BLOG_BASE="${BLOG_BASE:-}" PUSH_REMOTES="${PUSH_REMOTES:-origin,gitea}" command -v docker >/dev/null || die "没有 docker" docker compose version >/dev/null 2>&1 || die "没有 docker compose" say "1/5 准备工作目录" mkdir -p "$BLOG_DIR" "$APP_DIR" "$TRASH_DIR" # compose 的 volume 必须写绝对路径,这里统一转成绝对路径 BLOG_DIR="$(cd "$BLOG_DIR" && pwd)" APP_DIR="$(cd "$APP_DIR" && pwd)" TRASH_DIR="$(cd "$TRASH_DIR" && pwd)" # ---- 复用上一次部署的 Gitea 配置(★ 别删这段)---- # 为什么必须有:本脚本每次都会**重写** .env,而 .env 是 GITEA_PASS 的唯一落点。 # 于是「重跑一次 bootstrap.sh 但没现给 GITEA_PASS」会走到下面那个降级分支, # 把 PUSH_REMOTES 静默改成 origin —— 不报错、不提示、看着一切正常, # 直到某天要恢复时才发现 Gitea 辅仓早就没在同步了。 # 现在改成:命令行没给就从上次的 .env 里捡回来(显式传新值仍然优先)。 if [ -f "$APP_DIR/.env" ]; then _prev() { sed -n "s/^$1=//p" "$APP_DIR/.env" 2>/dev/null | tail -1; } GITEA_URL="${GITEA_URL:-$(_prev GITEA_URL)}" GITEA_USER="${GITEA_USER:-$(_prev GITEA_USER)}" GITEA_PASS="${GITEA_PASS:-$(_prev GITEA_PASS)}" if [ -n "${GITEA_PASS:-}" ]; then say "已从 $APP_DIR/.env 复用 GITEA_URL / GITEA_USER / GITEA_PASS" fi fi GITEA_URL="${GITEA_URL:-http://23.254.236.47:3001/zqlit/blog.git}" GITEA_USER="${GITEA_USER:-zqlit}" # 到这里还是没有 Gitea 凭据 → 只推主仓。 # 宁可少推一个辅仓,也不要让每次发布都对着一个认证不过的远端空转一遍。 # (默认列表就是 origin,gitea,没有凭据等于只剩 origin; # 要推别的远端请连同 gitea 一起显式写全 PUSH_REMOTES。) if [ -z "${GITEA_PASS:-}" ]; then PUSH_REMOTES="origin" fi say "2/5 拉取/更新博客仓库 → $BLOG_DIR" AUTH_URL="$(printf '%s' "$CNB_URL" | sed -E "s#^https://#https://cnb:${CNB_TOKEN}@#")" if [ -d "$BLOG_DIR/.git" ]; then git -C "$BLOG_DIR" remote set-url origin "$AUTH_URL" git -C "$BLOG_DIR" fetch origin main git -C "$BLOG_DIR" checkout main git -C "$BLOG_DIR" reset --hard origin/main else git clone --branch main "$AUTH_URL" "$BLOG_DIR" fi # 自建 Gitea 辅仓:只有给了 GITEA_PASS 才配(没给就只推 origin,见上面 PUSH_REMOTES 降级)。 # 凭据直接编进远端 URL —— 容器里没有交互终端、也没有 credential helper, # 这是唯一能让 `git push gitea` 免交互跑通的写法。 # 明文只落在 $APP_DIR/.env 与容器内的 .git/config,不会进仓库。 if [ -n "${GITEA_PASS:-}" ]; then _gitea_auth="$(printf '%s' "$GITEA_URL" | sed -E "s#^(https?://)#\1${GITEA_USER}:${GITEA_PASS}@#")" git -C "$BLOG_DIR" remote remove gitea 2>/dev/null || true git -C "$BLOG_DIR" remote add gitea "$_gitea_auth" unset _gitea_auth fi # 退役的远端:以前这一节会配 GitHub / Gitee 辅仓,两者都已退役 # (GitHub 被平台按 AUP 清空、Gitee 卡体积门槛)。若这份工作区是从旧部署续用的, # 顺手把残留的退役远端清掉,免得后端按 PUSH_REMOTES 推送时撞上已失效的远端。 # ★ gitea **不在**退役名单里 —— 它是现行辅仓,别跟着一起清掉。 for _retired_remote in gh gitee; do git -C "$BLOG_DIR" remote remove "$_retired_remote" 2>/dev/null || true done # 容器里要能 commit —— 顺手把身份写进仓库配置(不改全局) git -C "$BLOG_DIR" config user.name "$GIT_AUTHOR_NAME" git -C "$BLOG_DIR" config user.email "$GIT_AUTHOR_EMAIL" say "3/5 写入 $APP_DIR/.env" umask 077 # 用 printf 而不是 heredoc:令牌里若含 $ 或反引号,heredoc 会被 shell 展开 { printf 'EDITOR_TOKEN=%s\n' "$EDITOR_TOKEN" printf 'ADMIN_USER=%s\n' "${ADMIN_USER:-admin}" printf 'ADMIN_PASS=%s\n' "$ADMIN_PASS" printf 'BLOG_DIR=%s\n' "$BLOG_DIR" printf 'TRASH_DIR=%s\n' "$TRASH_DIR" printf 'BIND_PORT=%s\n' "$BIND_PORT" printf 'PUSH_REMOTES=%s\n' "$PUSH_REMOTES" printf 'GIT_AUTHOR_NAME=%s\n' "$GIT_AUTHOR_NAME" printf 'GIT_AUTHOR_EMAIL=%s\n' "$GIT_AUTHOR_EMAIL" printf 'BLOG_BASE=%s\n' "$BLOG_BASE" # ★ Gitea 凭据也写进 .env —— 这是「重跑本脚本时复用」的唯一落点(见 1/5 那段)。 # 容器本身**不读**这几个键(它只认 PUSH_REMOTES),写在这里没有副作用。 if [ -n "${GITEA_PASS:-}" ]; then printf 'GITEA_URL=%s\n' "$GITEA_URL" printf 'GITEA_USER=%s\n' "$GITEA_USER" printf 'GITEA_PASS=%s\n' "$GITEA_PASS" fi } > "$APP_DIR/.env" say "4/5 生成 compose 并启动容器" # ★ 仓库与回收站必须落在**同一个挂载点**里。 # 若容器内把它们挂成两个独立 bind mount,rename(2) 跨挂载点必返回 EXDEV # ——哪怕宿主机上它们同在一块盘上。后端虽已能退化成「复制+删除」,但那是白搬一遍数据。 # 做法:挂载 BLOG_DIR 的**父目录**,让容器内路径 == 宿主机路径。 MOUNT_ROOT="$(dirname "$BLOG_DIR")" if [ "${TRASH_DIR#"$MOUNT_ROOT"/}" != "$TRASH_DIR" ]; then # 回收站就在仓库父目录下 → 一个挂载点搞定 BLOG_IN_CT="$BLOG_DIR" TRASH_IN_CT="$TRASH_DIR" VOLUMES=" - $MOUNT_ROOT:$MOUNT_ROOT" else # 回收站被指到别处 → 只能两条独立挂载(后端会自动复制+删除,只是慢一点) BLOG_IN_CT=/blog TRASH_IN_CT=/app/trash VOLUMES=" - $BLOG_DIR:/blog - $TRASH_DIR:/app/trash" fi cat > "$APP_DIR/docker-compose.yml" <process.exit(r.ok?0:1)).catch(()=>process.exit(1))"] interval: 30s timeout: 5s retries: 3 start_period: 10s logging: driver: json-file options: max-size: "10m" max-file: "3" EOF cd "$APP_DIR" docker compose up -d --build say "5/5 健康检查" for i in $(seq 1 30); do if curl -fsS -H "X-Editor-Token: $EDITOR_TOKEN" "http://127.0.0.1:$BIND_PORT/health" >/tmp/editor-health.json 2>/dev/null; then cat /tmp/editor-health.json; echo say "部署完成。接下来:" echo " · 宿主机 nginx(1Panel 站点)加反代:location ^~ / { proxy_pass http://127.0.0.1:$BIND_PORT; ... }" echo " · Cloudflare Worker 变量:EDITOR_API_BASE=https://<指向本机的域名> EDITOR_TOKEN=$EDITOR_TOKEN" echo " · 推送远端:PUSH_REMOTES=$PUSH_REMOTES" if [ -z "${GITEA_PASS:-}" ]; then echo " · 未提供 GITEA_PASS → 本次只推 origin,Gitea 辅仓未启用" echo " (要启用:GITEA_PASS='' 重跑本脚本)" fi exit 0 fi sleep 2 done die "健康检查失败,看日志:cd $APP_DIR && docker compose logs --tail=80"