#!/usr/bin/env bash #=============================================================================== # 证书终端安装脚本 # # 功能: # - 下载并校验 Linux amd64 或 arm64 二进制的 SHA256 # - 通过一次性接入码完成 HTTPS 注册并保存设备 mTLS 身份 # - 支持后台生成的含接入码命令,保留终端隐藏输入与标准输入方式 # - 安装 systemd 分钟级任务,由后台纳管及续期策略决定实际执行范围 # - 升级时可指定既有状态及配置目录,复用设备身份 # # 说明: # - 使用 root 执行;命令中的短期接入码可能进入终端历史,勿使用长期凭据 # - 不关闭 TLS 验证,不自动纳管扫描到的站点,不保存一次性接入码 #=============================================================================== # 在接触参数前停止命令跟踪和脚本文本回显,后续不恢复调试输出 set +xv set -euo pipefail umask 077 # 发行时由render-installer.sh注入平台地址,通用源码不预置部署域名 SERVER_URL='https://agent.iyoucloud.com' DOWNLOAD_BASE='https://agent.iyoucloud.com/downloads' EXPECTED_SHA='' SERVER_CA_FILE='' TOKEN_STDIN=false ENROLL_TOKEN='' SEEN_OPTIONS=' ' NGINX_CONF=/etc/nginx/nginx.conf CHECK_COMMAND='nginx -t' RELOAD_COMMAND='nginx -s reload' STATE_DIR=/var/lib/certmgr-agent CONFIG_DIR=/etc/certmgr-agent BINARY_PATH=/usr/local/bin/certmgr-agent UNIT_NAME=iyoucloud-certmgr-agent # die 输出不含接入码或配置正文的中文错误 die() { printf '[错误] %s\n' "$1" >&2; exit 1; } # usage 说明通用安装参数,不预置任何业务域名 usage() { printf '%s\n' '用法: installer.sh [选项] [一次性接入码]' printf '%s\n' '未提供接入码时从终端隐藏输入;发行包已配置平台地址' printf '%s\n' '选项: --server HTTPS地址 --download-base HTTPS下载目录' printf '%s\n' ' --sha256 摘要 --server-ca-file CA路径 --token-stdin' printf '%s\n' ' --nginx-conf 配置路径 --check-command 校验命令 --reload-command 重载命令' printf '%s\n' '高级: --state-dir 状态目录 --config-dir 配置目录(默认无需设置)' } # require_value 拒绝缺失值与包含换行的配置,防止环境文件注入 require_value() { [[ $# -ge 2 && -n "$2" && "$2" != --* && "$2" != *$'\n'* && "$2" != *$'\r'* ]] || die '安装参数值缺失或包含换行' } # claim_option 拒绝重复选项,避免覆盖顺序造成安装目标歧义 claim_option() { [[ "$SEEN_OPTIONS" != *" $1 "* ]] || die '安装选项不能重复' SEEN_OPTIONS+="$1 " } # accept_token 只接受平台生成的固定长度随机码,不回显输入材料 accept_token() { [[ -z "$ENROLL_TOKEN" ]] || die '只能提供一个一次性接入码' validate_token "$1" ENROLL_TOKEN="$1" } # validate_token 校验128位随机码,发布切换期间仍接受已签发且尚未过期的旧码 validate_token() { [[ "$1" =~ ^[A-Za-z0-9_-]{22}$ || "$1" =~ ^[A-Za-z0-9_-]{43}$ || "$1" =~ ^[a-f0-9]{64}$ ]] \ || die '一次性接入码格式无效' } while [[ $# -gt 0 ]]; do case "$1" in --server) claim_option "$1"; require_value "$@"; SERVER_URL="$2"; shift 2 ;; --download-base) claim_option "$1"; require_value "$@"; DOWNLOAD_BASE="${2%/}"; shift 2 ;; --sha256) claim_option "$1"; require_value "$@"; EXPECTED_SHA="$2"; shift 2 ;; --server-ca-file) claim_option "$1"; require_value "$@"; SERVER_CA_FILE="$2"; shift 2 ;; --nginx-conf) claim_option "$1"; require_value "$@"; NGINX_CONF="$2"; shift 2 ;; --check-command) claim_option "$1"; require_value "$@"; CHECK_COMMAND="$2"; shift 2 ;; --reload-command) claim_option "$1"; require_value "$@"; RELOAD_COMMAND="$2"; shift 2 ;; --state-dir) claim_option "$1"; require_value "$@"; STATE_DIR="$2"; shift 2 ;; --config-dir) claim_option "$1"; require_value "$@"; CONFIG_DIR="$2"; shift 2 ;; --token-stdin) claim_option "$1"; TOKEN_STDIN=true; shift ;; --help|-h) usage; exit 0 ;; --) shift; [[ $# -eq 1 ]] || die '结束选项后必须提供一个一次性接入码'; accept_token "$1"; shift ;; -*) # bash 已消费命令中的选项分隔符,URL安全随机码仍可能以连字符开头 [[ "$1" =~ ^[A-Za-z0-9_-]{22}$ || "$1" =~ ^[A-Za-z0-9_-]{43}$ ]] || die '存在不支持的安装参数' accept_token "$1"; shift ;; *) accept_token "$1"; shift ;; esac done [[ "$TOKEN_STDIN" != true || -z "$ENROLL_TOKEN" ]] || die '位置参数与标准输入接入码不能同时使用' # validate_url 限定 HTTPS 坐标,不接受用户信息、查询参数或片段 validate_url() { [[ "$1" =~ ^https://[a-zA-Z0-9.-]+(:[0-9]+)?(/[a-zA-Z0-9._/-]*)?$ ]] || die '服务与下载地址必须是无用户信息和查询参数的HTTPS地址' } # validate_directory_path 拒绝非规范路径与任意祖先符号链接,不改变目录位置 validate_directory_path() { local directory="$1" current='' component local -a components [[ "$directory" =~ ^/[a-zA-Z0-9._/-]+$ && "$directory" != / && "$directory" != */ && "$directory" != *//* ]] \ || die '状态及配置目录必须是绝对路径,仅支持字母、数字、点、下划线、连字符和单斜杠分隔' IFS=/ read -r -a components <<<"${directory#/}" for component in "${components[@]}"; do [[ "$component" != . && "$component" != .. ]] || die '状态及配置目录不能包含点路径段' current+="/$component" [[ ! -L "$current" ]] || die '状态及配置目录及其祖先不能是符号链接' [[ ! -e "$current" || -d "$current" ]] || die '状态及配置路径的已有部分必须是目录' done } validate_url "$SERVER_URL" validate_url "$DOWNLOAD_BASE" validate_directory_path "$STATE_DIR" validate_directory_path "$CONFIG_DIR" [[ $(id -u) -eq 0 ]] || die '请使用root或sudo运行安装脚本' [[ $(uname -s) == Linux ]] || die '当前安装脚本仅支持Linux' case "$(uname -m)" in x86_64|amd64) ARCH=amd64 ;; aarch64|arm64) ARCH=arm64 ;; *) die '当前CPU架构不受支持' ;; esac for command in curl sha256sum systemctl install awk mktemp; do command -v "$command" >/dev/null 2>&1 || die "缺少必要命令: $command" done [[ -d /run/systemd/system ]] || die '当前系统未使用systemd' [[ "$NGINX_CONF" == /* && -f "$NGINX_CONF" ]] || die 'Nginx主配置必须是已存在的绝对路径' if [[ -n "$SERVER_CA_FILE" ]]; then [[ "$SERVER_CA_FILE" == /* && -f "$SERVER_CA_FILE" && ! -L "$SERVER_CA_FILE" ]] || die '服务端CA必须是已存在的普通文件绝对路径' fi for path in "$STATE_DIR" "$CONFIG_DIR" "$BINARY_PATH"; do [[ ! -L "$path" ]] || die '安装目标不能是符号链接' done WORK_DIR=$(mktemp -d) # cleanup 清理下载和进程内接入码,不打印敏感值 cleanup() { unset ENROLL_TOKEN CERTMGR_AGENT_TOKEN; rm -rf -- "$WORK_DIR"; } trap cleanup EXIT trap 'exit 130' INT TERM # download 保留系统TLS校验,仅允许HTTPS跳转 download() { curl --fail --silent --show-error --location --max-redirs 3 --proto '=https' --proto-redir '=https' \ --connect-timeout 10 --max-time 180 "$1" -o "$2" } ARTIFACT="certmgr-agent-linux-$ARCH" download "$DOWNLOAD_BASE/$ARTIFACT" "$WORK_DIR/certmgr-agent" if [[ -z "$EXPECTED_SHA" ]]; then download "$DOWNLOAD_BASE/SHA256SUMS" "$WORK_DIR/SHA256SUMS" EXPECTED_SHA=$(awk -v name="$ARTIFACT" '$2 == name || $2 == "*" name {print $1}' "$WORK_DIR/SHA256SUMS") fi [[ "$EXPECTED_SHA" =~ ^[a-fA-F0-9]{64}$ ]] || die 'SHA256摘要缺失、重复或格式无效' printf '%s %s\n' "$EXPECTED_SHA" "$WORK_DIR/certmgr-agent" | sha256sum --check --status || die '二进制SHA256校验失败' chmod 0755 "$WORK_DIR/certmgr-agent" # 下载期间可能耗时,创建目录前再次检查路径,避免沿符号链接写入状态 validate_directory_path "$STATE_DIR" validate_directory_path "$CONFIG_DIR" install -d -m 0700 "$STATE_DIR" "$CONFIG_DIR" # run_agent 只向本次子进程注入坐标,TLS可信CA不会改变下载站点的信任 run_agent() { CERTMGR_AGENT_SERVER_URL="$SERVER_URL" CERTMGR_AGENT_SERVER_CA_FILE="$SERVER_CA_FILE" \ CERTMGR_AGENT_CONFIG_DIR="$STATE_DIR" CERTMGR_AGENT_NGINX_CONF="$NGINX_CONF" \ CERTMGR_AGENT_CHECK_CMD="$CHECK_COMMAND" CERTMGR_AGENT_RELOAD_CMD="$RELOAD_COMMAND" \ "$WORK_DIR/certmgr-agent" "$@" } if [[ ! -f "$STATE_DIR/state.json" ]]; then if [[ -z "$ENROLL_TOKEN" ]]; then if [[ "$TOKEN_STDIN" == true ]]; then IFS= read -r ENROLL_TOKEN || die '未从标准输入读到接入码' else printf '请输入一次性接入码: ' >/dev/tty IFS= read -r -s ENROLL_TOKEN /dev/tty fi fi validate_token "$ENROLL_TOKEN" # 仅向登记子进程传递接入码,不写入参数、环境文件或续期状态 export CERTMGR_AGENT_TOKEN="$ENROLL_TOKEN" run_agent enroll fi # 已有设备不重复登记,也不保留命令中可能携带的新接入码 unset CERTMGR_AGENT_TOKEN ENROLL_TOKEN # 扫描只上报发现清单,是否纳管由后台授权操作决定 run_agent scan # write_env 使用systemd双引号值,转义反斜线与引号而不执行变量或命令 write_env() { local value="$2" value="${value//\\/\\\\}" value="${value//\"/\\\"}" printf '%s="%s"\n' "$1" "$value" } { write_env CERTMGR_AGENT_SERVER_URL "$SERVER_URL" write_env CERTMGR_AGENT_SERVER_CA_FILE "$SERVER_CA_FILE" write_env CERTMGR_AGENT_CONFIG_DIR "$STATE_DIR" write_env CERTMGR_AGENT_NGINX_CONF "$NGINX_CONF" write_env CERTMGR_AGENT_CHECK_CMD "$CHECK_COMMAND" write_env CERTMGR_AGENT_RELOAD_CMD "$RELOAD_COMMAND" } >"$WORK_DIR/agent.env" # wait_for_existing_task 停止现有调度并等待完整生命周期,不强杀安装或回滚 wait_for_existing_task() { local load_state active_state load_state=$(systemctl show "$UNIT_NAME.timer" --property=LoadState --value) || die '无法读取已有定时器状态' if [[ "$load_state" != not-found ]]; then systemctl stop "$UNIT_NAME.timer" || die '无法停止已有定时器,取消升级' fi load_state=$(systemctl show "$UNIT_NAME.service" --property=LoadState --value) || die '无法读取已有同步服务状态' [[ "$load_state" != not-found ]] || return 0 while true; do active_state=$(systemctl show "$UNIT_NAME.service" --property=ActiveState --value) || die '无法读取已有同步任务状态' case "$active_state" in # oneshot 执行期间通常是 activating,不能只检查 active active|activating|reloading|deactivating) printf '[信息] 正在等待已有同步任务结束\n' sleep 5 ;; inactive|failed) return 0 ;; *) die '已有同步任务状态无法确认,取消升级' ;; esac done } wait_for_existing_task install -m 0755 "$WORK_DIR/certmgr-agent" "$BINARY_PATH.new" mv -f "$BINARY_PATH.new" "$BINARY_PATH" install -m 0600 "$WORK_DIR/agent.env" "$CONFIG_DIR/agent.env" # 目录已限制为安全字符,EnvironmentFile直接写绝对路径,不使用Shell外层引号 cat >"$WORK_DIR/$UNIT_NAME.service" <"$WORK_DIR/$UNIT_NAME.timer" <