wizardchen
cdfbf05524
Address review feedback on PR #1249: - prepare.sh: when WEKNORA_REF looks like a version tag (v*), write the matching WEKNORA_VERSION into .env so docker compose pulls images that match the compose YAML's git ref (previously stuck on :latest). - prepare.sh: detect docker binary path via `command -v docker` and template it into weknora.service (replacing hardcoded /usr/bin/docker that fails when docker lives in /usr/local/bin). - firstboot.sh: write a /opt/WeKnora/.firstboot.done marker immediately after rewriting .env, before `docker compose up -d`. If compose fails mid-run, the next boot is gated by ConditionPathExists=!marker so we never regenerate DB_PASSWORD against an already-initialized postgres volume (which previously bricked the database). - firstboot.sh: stop deleting its own unit file / script while the oneshot is still executing; rely on the marker + `systemctl disable` instead, avoiding "job failed" markings from systemd. - firstboot.sh: use detected docker path instead of /usr/bin/docker; add note in credentials file that .env is the source of truth. - weknora-firstboot.service: add ConditionPathExists=!.firstboot.done. - cleanup.sh: scope docker volume deletion to compose project label (com.docker.compose.project=<name>) instead of fuzzy substring match that could nuke unrelated postgres/redis volumes. - cleanup.sh: also remove .firstboot.done marker, firstboot log, and any leftover /root/weknora-credentials.txt so the image is clean. - README.md: clarify how to actually disable registration (edit the `replace` call list in firstboot.sh, not run that command in shell).
116 lines
3.8 KiB
Bash
Executable File
116 lines
3.8 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# firstboot.sh - 由 weknora-firstboot.service 在新实例首次开机时自动执行。
|
|
# 任务: 生成随机密钥写入 .env -> 启动容器 -> 输出凭证 -> 标记完成 + 自禁用。
|
|
#
|
|
# 幂等性策略:
|
|
# 1) 一上来先写 ${MARKER} 标记 "已生成过密钥",
|
|
# 之后即便 docker compose 失败导致脚本中断, 重启后由 unit 的
|
|
# ConditionPathExists=!${MARKER} 拦住, 不会再生成新密钥覆盖 .env。
|
|
# (旧密钥已经写进 postgres 数据卷, 二次生成会导致数据库永久无法登录)
|
|
# 2) 失败时 unit 标记 failed, 用户可手动 docker compose up -d 恢复;
|
|
# 凭证仍可在 ${ENV_FILE} 中查到。
|
|
set -euo pipefail
|
|
|
|
WEKNORA_DIR="${WEKNORA_DIR:-/opt/WeKnora}"
|
|
ENV_FILE="${WEKNORA_DIR}/.env"
|
|
CRED_FILE="/root/weknora-credentials.txt"
|
|
LOG_FILE="/var/log/weknora-firstboot.log"
|
|
MARKER="${WEKNORA_DIR}/.firstboot.done"
|
|
|
|
exec >>"${LOG_FILE}" 2>&1
|
|
echo "==== firstboot started at $(date -Iseconds) ===="
|
|
|
|
if [[ -f "${MARKER}" ]]; then
|
|
echo "marker ${MARKER} exists, skip (already initialized)"
|
|
exit 0
|
|
fi
|
|
|
|
if [[ ! -f "${ENV_FILE}" ]]; then
|
|
echo "ERROR: ${ENV_FILE} not found"
|
|
exit 1
|
|
fi
|
|
|
|
DOCKER_BIN="$(command -v docker || true)"
|
|
if [[ -z "${DOCKER_BIN}" ]]; then
|
|
echo "ERROR: docker binary not found in PATH"
|
|
exit 1
|
|
fi
|
|
|
|
# 生成 32 字节强随机字符串(用于 AES-256 key, 必须刚好 32 字节)
|
|
gen32() { LC_ALL=C tr -dc 'A-Za-z0-9' </dev/urandom | head -c 32; }
|
|
# 通用密码: 24 字符, 不含 / + = (避免出现在 URL / sed 替换时出问题)
|
|
genpw() { LC_ALL=C tr -dc 'A-Za-z0-9' </dev/urandom | head -c 24; }
|
|
|
|
DB_PWD=$(genpw)
|
|
REDIS_PWD=$(genpw)
|
|
JWT=$(genpw)$(genpw)
|
|
SYS_AES=$(gen32)
|
|
TENANT_AES=$(gen32)
|
|
|
|
# 用 | 作 sed 分隔符避免冲突; 仅替换以 KEY= 开头的行
|
|
replace() {
|
|
local key="$1" val="$2"
|
|
if grep -qE "^${key}=" "${ENV_FILE}"; then
|
|
sed -i "s|^${key}=.*|${key}=${val}|" "${ENV_FILE}"
|
|
else
|
|
echo "${key}=${val}" >>"${ENV_FILE}"
|
|
fi
|
|
}
|
|
|
|
replace DB_PASSWORD "${DB_PWD}"
|
|
replace REDIS_PASSWORD "${REDIS_PWD}"
|
|
replace JWT_SECRET "${JWT}"
|
|
replace SYSTEM_AES_KEY "${SYS_AES}"
|
|
replace TENANT_AES_KEY "${TENANT_AES}"
|
|
replace GIN_MODE "release"
|
|
|
|
# 关键: .env 改完立刻写 marker。
|
|
# 这之后即便 docker compose up 失败, 重启也不会再次重写 .env,
|
|
# 防止与 postgres 已经持久化的密码不一致。
|
|
umask 077
|
|
touch "${MARKER}"
|
|
chmod 0600 "${MARKER}"
|
|
|
|
echo "env updated, marker written, starting docker compose..."
|
|
cd "${WEKNORA_DIR}"
|
|
"${DOCKER_BIN}" compose up -d
|
|
|
|
# 尝试拿公网 IP, 失败就用内网
|
|
PUB_IP=$(curl -fsS --max-time 5 https://ifconfig.me 2>/dev/null \
|
|
|| curl -fsS --max-time 5 https://api.ipify.org 2>/dev/null \
|
|
|| hostname -I | awk '{print $1}')
|
|
|
|
cat >"${CRED_FILE}" <<INFO
|
|
========================================
|
|
WeKnora 实例初始化完成
|
|
生成时间: $(date -Iseconds)
|
|
========================================
|
|
|
|
访问地址 : http://${PUB_IP}
|
|
|
|
注册后如需关闭后续注册, 编辑 ${ENV_FILE}:
|
|
DISABLE_REGISTRATION=true
|
|
然后执行: cd ${WEKNORA_DIR} && docker compose up -d
|
|
|
|
下列随机凭证已写入 ${ENV_FILE}, 请妥善保存(仅 root 可读):
|
|
DB_PASSWORD = ${DB_PWD}
|
|
REDIS_PASSWORD = ${REDIS_PWD}
|
|
JWT_SECRET = ${JWT}
|
|
SYSTEM_AES_KEY = ${SYS_AES}
|
|
TENANT_AES_KEY = ${TENANT_AES}
|
|
|
|
注意:
|
|
- 本文件只反映首启时刻的密钥, 后续以 ${ENV_FILE} 为准。
|
|
- 切勿直接对外暴露 5432 / 6379 / 9000 等基础设施端口。
|
|
- 仅用 80 / 443 对外服务, 必要时配置反向代理 + HTTPS。
|
|
|
|
INFO
|
|
|
|
echo "credentials written to ${CRED_FILE}"
|
|
|
|
# 仅停掉 unit, 不删 unit 文件 (否则当前正在运行的 oneshot 可能被 systemd 标记 failed)。
|
|
# 下次重启时, weknora-firstboot.service 通过 ConditionPathExists=!${MARKER} 自动跳过。
|
|
systemctl disable weknora-firstboot.service || true
|
|
|
|
echo "==== firstboot finished at $(date -Iseconds) ===="
|