适用于 Ubuntu 22.04 / 24.04;需要已安装 Docker Engine、Compose V2 和 systemd。
1. 准备与环境检查
准备 sudo 权限、服务器名称、授权中心地址,以及数据库地址、库名、账户和密码。授权中心需已发布本机架构的安装包;发布人员见第 8 节 。服务器能访问授权中心及文件地址即可,不要求访问公网镜像仓库。
作用:查看系统、CPU、Docker / Compose 版本和磁盘空间;确认安装工具齐全。检查失败先处理,建议部署目录和下载目录各预留 2 GB。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
cat /etc/os-release
uname -rm
for tool in curl unzip sha256sum flock docker; do
command -v "$tool" >/dev/null || { echo "缺少 $tool,请管理员安装。"; exit 1; }
done
sudo docker version
sudo docker compose version
systemctl --version
df -h /opt "$HOME"
BASH
缺少工具时:Ubuntu 安装命令
仅在能访问管理员配置的软件源时执行;否则由管理员提供离线依赖。
作用:安装下载、解压、编辑配置及升级所需的基础工具,不安装 Docker。
Linux 终端命令 复制命令
sudo apt-get update && sudo apt-get install -y ca-certificates curl unzip nano util-linux
2. 下载并准备部署目录
仅用于首次安装 。已有 /opt/hitek-auth-client 时不要删除重装,请使用手动升级 。输入地址时回车使用正式环境;内网部署填写实际根地址。下载的 ZIP 需为 3.1.6 或更高兼容版本。
展开首次下载与安装命令
作用:自动识别 CPU,下载本机架构的 ZIP,解压并校验全部文件,导入镜像并创建部署目录。此步骤不启动业务同步,也不覆盖已有部署。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
umask 077
install_dir=/opt/hitek-auth-client
for tool in curl unzip sha256sum docker; do
command -v "$tool" >/dev/null || { echo "缺少 $tool,请先完成环境检查。"; exit 1; }
done
sudo -v
sudo test ! -e "$install_dir" || { echo "部署目录已存在,请使用升级步骤:$install_dir"; exit 1; }
sudo docker info >/dev/null
sudo docker compose version
case "$(uname -m)" in
x86_64) arch=amd64; product_type=HitekAuthClientDockerAmd64 ;;
aarch64|arm64) arch=arm64; product_type=HitekAuthClientDockerArm64 ;;
*) echo '当前 CPU 架构暂不支持。'; exit 1 ;;
esac
read -r -p '授权中心根地址 [https://auth.qdm123.com/]: ' server </dev/tty
server="${server:-https://auth.qdm123.com/}"
[[ "$server" == http://* || "$server" == https://* ]] || { echo '地址必须以 http:// 或 https:// 开头。'; exit 1; }
[[ "$server" != *'?'* && "$server" != *'#'* && "$server" != *'@'* && "$server" != *[[:space:]]* ]] || { echo '请输入不含账号、空格、查询参数或片段的系统根地址。'; exit 1; }
mkdir -p "$HOME/hitek-downloads"
package_dir="$(mktemp -d "$HOME/hitek-downloads/release.XXXXXX")"
url="${server%/}/api/ClientSetup/DownLoadSetupClient?PType=$product_type"
redirect_protocols='=http,https'
[[ "$server" != https://* ]] || redirect_protocols='=https'
echo "正在下载 $arch 安装包到:$package_dir"
if ! curl --fail --show-error --location --connect-timeout 20 --max-time 1800 \
-H 'Accept: */*' --proto '=http,https' --proto-redir "$redirect_protocols" \
--output "$package_dir/package.zip.part" "$url"; then
echo '下载失败,未安装。404 通常表示对应下载类型尚未上传可用包;请联系管理员。'
exit 1
fi
mv "$package_dir/package.zip.part" "$package_dir/package.zip"
unzip -tq "$package_dir/package.zip"
unzip -q "$package_dir/package.zip" -d "$package_dir/unpacked"
cd "$package_dir/unpacked"
sha256sum --check SHA256SUMS
shopt -s nullglob
images=(hitek-auth-client-*-linux-"$arch".tar)
[[ ${#images[@]} -eq 1 ]] || { echo '包内镜像数量或架构不符,停止安装。'; exit 1; }
sudo docker load --input "${images[0]}"
sudo bash docker-deployment/docker-install.sh "$install_dir"
printf '下载来源:%s\n解压目录:%s\n部署目录:%s\n' "$server" "$PWD" "$install_dir"
echo '目录准备完成。下一步填写配置;内网部署请把 ServerRoot 改成上面输入的地址。'
BASH
完成后应看到文件校验 OK、Loaded image 和“目录准备完成”。接着填写配置;内网部署还需在配置中填写相同的 ServerRoot。
3. 填写配置
3.1 备份并编辑
作用:备份当前配置,然后用 Nano 打开配置文件;备份仅 root 可读。已有运行中的部署请先按第 6 节暂停定时升级。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
sudo install -m 0600 config/appsettings.json "backups/appsettings-$(date +%Y%m%d-%H%M%S)-$$.json" &&
sudo nano config/appsettings.json
Nano 中按 Ctrl+O、回车保存,Ctrl+X 退出。替换示例值时保留 JSON 的引号和逗号;密码只在服务器上填写。
3.2 常用配置:MySQL 自动发现客户
下面是可替换整个配置文件的示例。改好 ClientName、数据库地址、账户、密码和库名;使用内网授权中心时也改 ServerRoot。同一连接的多个库可追加到 DatabaseNames,不同连接在 Databases 中另加对象。
作用:配置 MySQL 业务库,自动读取库中的单位或项目信息。请粘贴到 appsettings.json,不要在终端直接执行。
配置内容 复制配置
{
"HitekAuthClient": {
"ServerRoot": "https://auth.qdm123.com/",
"AllowInsecureHttp": false,
"ClientName": "请替换为现场服务器名称",
"SyncIntervalMinutes": 10,
"HttpTimeoutSeconds": 30,
"DataDirectory": "/data",
"PluginDirectory": "/app/plugins",
"ApplyAuthorizationPackages": true,
"UploadDiskTelemetry": false,
"ValidateAuthorizationOffline": true,
"Customers": [],
"Databases": [
{
"DatabaseType": "MYSQL",
"ConnectionString": "Server=请替换为数据库IP;Port=3306;User ID=请替换为数据库账户;Password=请替换为数据库密码;",
"DatabaseNames": [
"请替换为实际业务库名"
]
}
]
}
}
MySQL 自动发现需使用支持的业务表:ILIS Java 的 t_s_depart_version / t_unit,或 QDM / HIPMS 的 hipms_project + hipms_unit。单位/项目授权名称应与授权中心登记一致。不是这些结构时由负责人核对,或使用下面的手工配置。
按需:Customers 手工指定客户(完整配置)
与上面的完整 JSON 二选一,不要拼接两份配置。 适用于已明确单位/项目的部署;多个目标在 Customers 中追加对象。两种方式可组合,但同一目标不要重复填写。
单位、项目、192.0.2.x 地址及账户均为虚构示例,使用前替换为现场信息和密码。单位/项目名称与授权中心登记一致;DatabaseName 与连接字符串中的 Database 一致。
作用:配置两个手工目标:ILIS Java + MySQL 单位、QDM + SQL Server 项目;替换完整配置文件,仅需一个目标时删除另一对象及多余逗号。
配置内容 复制配置
{
"HitekAuthClient": {
"ServerRoot": "https://auth.qdm123.com/",
"AllowInsecureHttp": false,
"ClientName": "示例检测中心授权终端-01",
"SyncIntervalMinutes": 10,
"HttpTimeoutSeconds": 30,
"DataDirectory": "/data",
"PluginDirectory": "/app/plugins",
"ApplyAuthorizationPackages": true,
"UploadDiskTelemetry": false,
"ValidateAuthorizationOffline": true,
"Customers": [
{
"CustomerName": "示例市工程检测中心",
"ProjectName": "",
"SystemType": "ILIS_JAVA",
"DatabaseType": "MYSQL",
"DatabaseName": "ilis_lab",
"ConnectionString": "Server=192.0.2.10;Port=3306;Database=ilis_lab;User ID=ilis_auth;Password=请替换为实际MySQL密码;"
},
{
"CustomerName": "示例交通建设有限公司",
"ProjectName": "示例高速公路一期",
"SystemType": "QDM",
"DatabaseType": "MSSQL",
"DatabaseName": "qdm_phase1",
"ConnectionString": "Server=tcp:192.0.2.20,1433;Database=qdm_phase1;User ID=qdm_auth;Password=请替换为实际SQLServer密码;Encrypt=True;TrustServerCertificate=False;"
}
],
"Databases": []
}
}
客户/项目名称须与授权中心一致;QDM、HIPMS、HIDOC 填写 ProjectName。手工目标的 DatabaseName 是单个库名,应与连接字符串中的 Database 一致。
按需:SQL Server 数据源
保留完整配置的其他字段和 Customers: [],仅替换 Databases 数组中的一个对象。
作用:配置一个 SQL Server 自动发现数据源;这是局部对象,不能覆盖整个配置文件。
配置内容 复制配置
{
"DatabaseType": "MSSQL",
"ConnectionString": "Server=tcp:请替换为数据库IP,1433;User ID=请替换为数据库账户;Password=请替换为数据库密码;Encrypt=True;TrustServerCertificate=False;",
"DatabaseNames": [
"请替换为实际业务库名"
],
"SystemType": "ILIS"
}
从 TestUnit 识别 ILIS 单位,从 Project 及对应业务表识别 QDM / HIDOC。SystemType 仅为 TestUnit 缺少有效类型时兜底(桥检用 ILIS_BRIDGE);有效的 AS_SystemType 优先,不会强制覆盖所有结果。加密与证书参数由数据库负责人提供。
按需:内网 HTTP、连接字符串注意事项
作用:指定内网授权中心并明确允许 HTTP;仅替换完整配置中的这两项。
配置内容 复制配置
"ServerRoot": "http://192.168.2.31:8080/",
"AllowInsecureHttp": true
旧配置如有自定义 ServerGetApi / ServerDriverApi,删除这两项才会统一跟随根地址;无法连接时不会自动切回公网。JSON 内的双引号写成 \",反斜杠写成 \\。
若现场 JDBC 明确使用 useSSL=false,MySQL 的对应参数为 SslMode=Disabled;其他现场按数据库实际 TLS 要求配置。不要为了消除报错盲目关闭证书验证。
作用:保存配置后恢复文件所有者与权限,让默认容器账户能读取配置。
Linux 终端命令 复制命令
sudo chown root:1654 /opt/hitek-auth-client/config/appsettings.json && sudo chmod 640 /opt/hitek-auth-client/config/appsettings.json
按需:数据库在本机 Docker 中,需接入已有网络
连接本机 Docker 数据库
数据库与客户端由同一 Docker Engine 管理、希望用容器别名连接时执行;使用独立服务器 IP 的部署可跳过。示例网络为 gzsz-runtime,数据库容器为 gzsz-dependencies-mysql-1,别名为 gzsz-mysql,请以现场查询结果为准。
作用:列出运行中的容器、网络和端口,找到数据库容器名称。
Linux 终端命令 复制命令
sudo docker ps --format 'table {{.Names}}\t{{.Networks}}\t{{.Ports}}'
作用:输入数据库容器名称,查询它所在的网络和可用别名。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
read -r -p '请输入数据库容器名称: ' db_container </dev/tty
[[ -n "$db_container" ]] || { echo '容器名称不能为空。'; exit 1; }
sudo docker inspect --format \
'{{range $name, $network := .NetworkSettings.Networks}}网络={{$name}}
网络别名={{json $network.Aliases}}
{{end}}' "$db_container"
BASH
已有运行中的部署先按第 6 节暂停定时升级。以下命令只用于尚未自定义网络的标准 Compose 文件;已成功接入的不必重复执行。
作用:备份 Compose 并将客户端接入指定的已有网络;配置验证失败时恢复原文件。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
umask 077
cd /opt/hitek-auth-client
read -r -p '请输入要接入的已有 Docker 网络名称(例如 gzsz-runtime): ' network </dev/tty
[[ "$network" =~ ^[A-Za-z0-9][A-Za-z0-9_.-]*$ ]] || { echo '网络名称无效。'; exit 1; }
docker network inspect "$network" >/dev/null
exec 8>.deployment.lock
flock -n 8 || { echo '另一个检测、同步或升级操作正在进行,请稍后重试。'; exit 1; }
if grep -Eq '^[[:space:]]*(networks|network_mode)[[:space:]]*:' docker-compose.yml; then
echo '文件已有网络配置,停止追加。已接入的现场直接检查连接和实际网络;需改接其他网络时请负责人修改现有定义。'
exit 1
fi
backup="backups/docker-compose-before-network-$(date +%Y%m%d-%H%M%S)-$$.yml"
install -m 0600 docker-compose.yml "$backup"
cat >> docker-compose.yml <<YAML
networks:
default:
external: true
name: "$network"
YAML
if ! docker compose --env-file .env -f docker-compose.yml config --quiet; then
cp "$backup" docker-compose.yml
echo 'Compose 配置验证失败,已恢复原文件。'
exit 1
fi
printf '已配置外部网络:%s\n备份文件:%s\n' "$network" "$backup"
echo '下一步核对数据库连接地址,再单独执行连接检查。已有后台容器需在检查通过后运行 manage.sh start 重建。'
BASH
在配置中使用数据库别名和容器内部端口 ,例如 Server=gzsz-mysql;Port=3306;。即使显示 3339->3306,同网络仍用 3306;3339 用于访问宿主机映射端口。库名填入 DatabaseNames。
首次部署接着做第 4 步。已有客户端则重新检查连接,成功后执行 manage.sh start,Compose 会按新网络重建容器;随后在第 5 节恢复定时升级。
作用:客户端启动后,查询它实际使用的网络和别名,确认接入结果。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
cid="$(sudo docker compose --env-file .env -f docker-compose.yml ps -a -q hitek-auth-client)"
if [[ -z "$cid" ]]; then
echo '尚未找到正式客户端容器。connections 使用临时容器,检测结束后会自动删除;首次部署请先完成同步验收并启动。'
exit 0
fi
sudo docker inspect --format \
'容器名称={{.Name}}
{{range $name, $network := .NetworkSettings.Networks}}网络={{$name}}
网络别名={{json $network.Aliases}}
{{end}}' "$cid"
BASH
4. 检查、首次同步并启动
检查失败先处理错误;连接通过不代表客户发现和授权写入已成功。
作用:先检查配置与运行环境,再测试授权中心连接和数据库登录(SELECT 1),不写业务表。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
sudo bash manage.sh check && sudo bash manage.sh connections
首次同步前,由负责人确认业务数据库已备份、旧客户端已停止。首次部署此时还没有后台同步进程。
作用:执行一次真实授权同步,会写入业务库;确认识别到预期客户且授权生效后再启动后台服务。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh once
作用:查看首次同步的最近日志,核对客户发现、授权处理及失败原因。
Linux 终端命令 复制命令
sudo tail -n 100 /opt/hitek-auth-client/logs/hitek-auth-client.log
作用:启动后台服务并查看状态;应显示 Up,随后变为 healthy。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
sudo bash manage.sh start && sudo bash manage.sh status
healthy 只表示进程正常,还需在业务系统确认授权生效,并在授权中心核对服务器名称、版本和连接时间。默认每轮同步结束后等待 10 分钟;管理端阈值也是 10 分钟,耗时或网络延迟可能造成短暂超时提示。
5. 开启自动升级
首次同步验收通过、后台容器运行后执行。授权同步默认 10 分钟 ;版本检查为 每分钟 ,两者独立。
作用:启用每分钟检查更新,下载地址跟随配置中的 ServerRoot;修改配置后恢复自动升级也用此命令。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash enable-auto-upgrade.sh
作用:确认自动升级定时器已启用,并查看下一次检查时间。
Linux 终端命令 复制命令
sudo systemctl list-timers 'hitek-auth-client-update-*' --all
作用:立即检查一次版本;有新包时下载、校验、备份并切换镜像,不健康时尝试回退。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash auto-upgrade.sh
没有输出不一定异常 :已处理过的下载地址、无待处理包或锁被占用时可能静默退出。结合第 6 节运行版本和升级日志判断。相同 URL 不重复下载,旧版本不自动降级,失败版本不循环重试;修复包应发布更高版本并使用新 URL。
6. 日常维护与手动升级
按需要执行对应命令,不要一次执行本节所有操作。配置、数据、缓存和日志由宿主机持久化,镜像升级会保留它们。
作用:查看当前运行状态和最近业务日志,用于日常巡检或排查同步失败。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
# 查看容器运行状态
sudo bash manage.sh status
# 查看最近业务同步日志
sudo bash manage.sh logs
作用:查询正在运行的镜像版本;显示 3.1.6 或更高版本表示已包含 HTTP 406 修复。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
cid="$(sudo docker compose --env-file .env -f docker-compose.yml ps -q hitek-auth-client)"
[[ -n "$cid" ]] || { echo '后台容器未运行。'; exit 1; }
image="$(sudo docker inspect --format '{{.Image}}' "$cid")"
sudo docker image inspect --format '{{index .Config.Labels "org.opencontainers.image.version"}}' "$image"
BASH
查看自动升级日志与处理记录
作用:读取本安装目录对应的升级服务最近 100 条日志。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
suffix="$(printf '%s' /opt/hitek-auth-client | sha256sum)"
sudo journalctl -u "hitek-auth-client-update-${suffix:0:12}.service" -n 100 --no-pager
BASH
作用:查看已成功或失败的升级记录;下载完成不等于升级成功。
Linux 终端命令 复制命令
sudo find /opt/hitek-auth-client/updates/applied /opt/hitek-auth-client/updates/failed -name result.log -exec tail -n 30 {} \;
修改配置后让新配置生效
按顺序暂停定时升级 → 备份并编辑配置 → 检查并重启 → 恢复定时升级。停止定时器不会中断已经开始的一次升级;若仍在执行,等待结束再修改。
作用:停止并禁用本安装目录的升级定时器,同时查看是否仍有升级任务在执行。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
suffix="$(printf '%s' /opt/hitek-auth-client | sha256sum)"
unit="hitek-auth-client-update-${suffix:0:12}"
sudo systemctl disable --now "$unit.timer"
sudo systemctl status "$unit.service" --no-pager || true
BASH
使用第 3.1 节备份和编辑配置;原配置不会因镜像升级自动改写。保存后恢复第 3 节文件权限,CentOS 7 同时恢复 SELinux 标签。
作用:检查配置,随后重启客户端以结束旧等待并加载新配置;会短暂停止同步。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
# 检查成功后停止,再启动,让新配置立即生效
sudo bash manage.sh check && sudo bash manage.sh stop && sudo bash manage.sh start
核对本节运行状态与业务日志,正常后执行第 5 节 enable-auto-upgrade.sh 恢复定时升级。
临时停止客户端或再执行一次同步
作用:停止后台客户端;后续不会继续同步,直到手动启动。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh stop
作用:后台停止后执行一次同步;会写业务库,禁止与后台客户端同时执行。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh once
作用:重新启动后台客户端,恢复持续同步。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh start
手动升级:自动下载失败或需要人工升级时展开
首次安装能下载,自动升级却报 HttpRequestException / HTTP 406
旧版下载 ZIP 时误带 JSON 请求头,文件服务器可能返回 HTTP 406;3.1.6 已修复。旧程序需要先手动升级一次 ,也可在需要人工升级时使用下面的宿主机下载方式。
先由管理员发布本机架构的 3.1.6 或更高兼容版本。命令保留配置、Compose 网络和数据;会在校验、备份后短暂重启客户端。只恢复程序不等于撤销业务数据库变更。
作用:下载并校验最新发布包,检查版本和架构,兼容旧脚本的 TTY 设置,再调用升级脚本并显示状态与日志。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
umask 077
cd /opt/hitek-auth-client
for tool in curl unzip sha256sum docker flock; do
command -v "$tool" >/dev/null || { echo "缺少 $tool,请先安装。"; exit 1; }
done
case "$(uname -m)" in
x86_64) arch=amd64; product_type=HitekAuthClientDockerAmd64 ;;
aarch64|arm64) arch=arm64; product_type=HitekAuthClientDockerArm64 ;;
*) echo '不支持此架构。'; exit 1 ;;
esac
read -r -p '授权中心根地址 [https://auth.qdm123.com/]: ' server </dev/tty
server="${server:-https://auth.qdm123.com/}"
[[ "$server" == http://* || "$server" == https://* ]] || exit 1
[[ "$server" != *'?'* && "$server" != *'#'* && "$server" != *'@'* && "$server" != *[[:space:]]* ]] || exit 1
package_dir="$(mktemp -d /var/tmp/hitek-upgrade.XXXXXX)"
redirect_protocols='=http,https'
[[ "$server" != https://* ]] || redirect_protocols='=https'
curl --fail --show-error --location --connect-timeout 20 --max-time 1800 \
--proto '=http,https' --proto-redir "$redirect_protocols" -H 'Accept: */*' \
--output "$package_dir/package.zip" \
"${server%/}/api/ClientSetup/DownLoadSetupClient?PType=$product_type"
unzip -q "$package_dir/package.zip" -d "$package_dir/unpacked"
(cd "$package_dir/unpacked" && sha256sum --check SHA256SUMS)
shopt -s nullglob
images=("$package_dir/unpacked"/hitek-auth-client-*-linux-"$arch".tar)
[[ ${#images[@]} -eq 1 ]] || { echo '包内镜像数量或架构错误。'; exit 1; }
archive="${images[0]}"
version="$(basename "$archive")"
version="${version#hitek-auth-client-}"
version="${version%-linux-$arch.tar}"
[[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || exit 1
[[ "$(printf '%s\n' 3.1.6 "$version" | sort -V | head -n 1)" == 3.1.6 ]] ||
{ echo '下载类型还没发布 3.1.6 或更高版本,请先发布。'; exit 1; }
exec 7>updates/.watcher.lock
flock -n 7 || { echo '自动升级正在进行,请稍后重试。'; exit 1; }
exec 8>.deployment.lock
flock -n 8 || { echo '部署操作正在进行,请稍后重试。'; exit 1; }
backup="backups/upgrade-before-406-$(date +%Y%m%d-%H%M%S)-$$.sh"
install -m 0600 upgrade.sh "$backup"
sed -i 's/ run --rm --no-deps / run --rm -T --no-deps /g' upgrade.sh
if ! bash -n upgrade.sh; then
install -m 0755 "$backup" upgrade.sh
echo '脚本检查失败,已恢复。'
exit 1
fi
flock -u 8
exec 8>&-
bash upgrade.sh "$archive" "hitek-auth-client:$version-linux-$arch"
bash manage.sh status
bash manage.sh logs
BASH
正常结果包含“升级成功”;再确认业务同步。完成后继续使用第 5 节自动升级。若旧宿主机下载网络尚未修复,按第 7 节处理。
由负责人操作:回退旧镜像
先按“修改配置”中的命令停用定时器,确认正在执行的升级结束。回退期间保持定时器停用,避免再次升级。
作用:列出升级备份中的旧镜像 ID,由负责人选择要恢复的版本。
Linux 终端命令 复制命令
sudo find /opt/hitek-auth-client/backups -name old-image-id.txt -print -exec cat {} \;
作用:输入选定的 sha256 镜像 ID,切换回本机保留的旧镜像;不倒灌旧数据。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
read -r -p '要回退到的完整镜像 ID(sha256:开头): ' image </dev/tty
[[ "$image" =~ ^sha256:[a-f0-9]{64}$ ]] || { echo '镜像 ID 格式不正确。'; exit 1; }
cd /opt/hitek-auth-client
sudo bash upgrade.sh --local "$image"
BASH
回退不能撤销已写入业务数据库的变更。检查业务结果后再决定是否恢复自动升级。
7. 常见问题
数据库连接失败:查看检测报告
作用:重新检查授权中心和数据库连接,不写业务表。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh connections
作用:查看连接检查报告,按失败项定位问题;分享日志前确认没有现场敏感信息。
Linux 终端命令 复制命令
sudo cat /opt/hitek-auth-client/logs/connection-check.json
旧脚本:下载容器没有使用客户端网络
新脚本默认跟随正在运行的客户端网络。旧脚本使用 bridge,可能导致业务连接成功但升级下载失败。镜像升级不会替换宿主机脚本 ,此修复只需执行一次。
作用:取得锁、备份并修复下载脚本的默认网络;已修复则跳过,语法错误会恢复原文件。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
exec 7>updates/.watcher.lock
flock -n 7 || { echo '自动下载或升级正在进行,请稍后重试。'; exit 1; }
exec 8>.deployment.lock
flock -n 8 || { echo '另一个部署操作正在进行,请稍后重试。'; exit 1; }
if grep -Fq '${HITEK_UPDATE_NETWORK:-container:$container}' sync-update-source.sh; then
echo '脚本已默认跟随客户端网络,无需重复修复。'
exit 0
fi
grep -Fq '${HITEK_UPDATE_NETWORK:-bridge}' sync-update-source.sh || { echo '脚本内容与本修复不匹配,请负责人核对版本。'; exit 1; }
backup="backups/sync-update-source-before-network-$(date +%Y%m%d-%H%M%S)-$$.sh"
install -m 0600 sync-update-source.sh "$backup"
sed -i 's/${HITEK_UPDATE_NETWORK:-bridge}/${HITEK_UPDATE_NETWORK:-container:$container}/g' sync-update-source.sh
if ! bash -n sync-update-source.sh; then
install -m 0755 "$backup" sync-update-source.sh
echo '脚本检查失败,已恢复原文件。'
exit 1
fi
printf '已修复自动下载网络。备份:%s\n' "$backup"
BASH
修复后执行第 5 节立即检查更新;HTTP 406 需按第 6 节升级程序,单改网络无法解决。
旧脚本:the input device is not a TTY
旧版 Compose 命令在脚本或定时器中申请交互终端,需添加 -T。
作用:备份并修复检查、升级命令的终端参数,然后重新检查连接;不改数据库配置和网络。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
stamp="$(date +%Y%m%d-%H%M%S)-$$"
for file in manage.sh upgrade.sh; do
install -m 0600 "$file" "backups/$file-before-tty-$stamp"
sed -i 's/ run --rm --no-deps / run --rm -T --no-deps /g' "$file"
bash -n "$file"
done
bash manage.sh connections
BASH
旧 ZIP:中文文件名乱码或找不到说明文件
旧 3.1.3 ZIP 的中文说明文件可能被解压工具改名;新包使用英文文件名。仅这三个说明文件找不到时可恢复,其他校验失败应重新下载正确包。
作用:输入已有下载目录,恢复中文说明文件并重新校验全部文件;部署目录不存在时继续准备首次安装。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
read -r -p '请输入包含 package.zip 的下载目录(绝对路径): ' package_dir </dev/tty
[[ "$package_dir" == /* ]] || { echo '必须使用绝对路径。'; exit 1; }
cd "$package_dir/unpacked"
unzip -p ../package.zip '00-Docker*.md' > '00-Docker上传说明.md'
unzip -p ../package.zip 'LinuxDocker*.html' > 'LinuxDocker部署指南.html'
unzip -p ../package.zip 'LinuxDocker*.md' > 'LinuxDocker部署指南.md'
sha256sum --check SHA256SUMS
case "$(uname -m)" in x86_64) arch=amd64 ;; aarch64|arm64) arch=arm64 ;; *) exit 1 ;; esac
shopt -s nullglob
images=(hitek-auth-client-*-linux-"$arch".tar)
[[ ${#images[@]} -eq 1 ]] || { echo '镜像数量或架构不符。'; exit 1; }
sudo test ! -e /opt/hitek-auth-client || { echo '部署目录已存在,请继续配置或使用升级流程。'; exit 1; }
sudo docker load --input "${images[0]}"
sudo bash docker-deployment/docker-install.sh /opt/hitek-auth-client
echo '目录准备完成,请继续第 3 步填写配置。'
BASH
不要删除校验条目或用 --ignore-missing 跳过检查。
8. 发布包管理与验收范围 管理员入口:下载类型管理 ;amd64 文件版本列表 ;arm64 文件版本列表 。新增类型需要“文件类型管理”权限,上传需要“文件版本添加”权限;看不到入口时联系管理员。
下载当前已发布包:amd64 ZIP · arm64 ZIP 。入口存在不表示新版本已发布。
由发布人员在对应下载类型中新建版本,上传单架构 ZIP 原文件 ,使用新 URL 并保留历史版本;不要混用 Windows 的下载类型。
配置、data、cache、logs 持久化挂载;日志自动滚动,备份和升级归档由管理员按保留策略清理,不删除运行目录。服务器重启恢复需确认 Docker 开机启动并实际验收。
x64 容器和 ARM64 模拟环境已有测试记录;CentOS 7、麒麟及鲲鹏实机、现场数据库、systemd 和整机重启仍需现场验收。
适用于已有 Docker Engine、Compose V2 和 systemd 的 CentOS 7 存量环境。CentOS 7 已停止官方维护;Docker 1.13 / Compose V1 不适用,容器仍依赖宿主机内核,必须完成环境检查和现场验收。配置完成后还需处理本页的 SELinux 标签。
1. 准备与环境检查
准备 sudo 权限、服务器名称、授权中心地址,以及数据库地址、库名、账户和密码。授权中心需已发布本机架构的安装包;发布人员见第 8 节 。服务器能访问授权中心及文件地址即可,不要求访问公网镜像仓库。
作用:查看系统、CPU、Docker / Compose 版本和磁盘空间;确认安装工具齐全。检查失败先处理,建议部署目录和下载目录各预留 2 GB。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
cat /etc/os-release
uname -rm
for tool in curl unzip sha256sum flock docker; do
command -v "$tool" >/dev/null || { echo "缺少 $tool,请管理员安装。"; exit 1; }
done
sudo docker version
sudo docker compose version
systemctl --version
df -h /opt "$HOME"
BASH
缺少工具时:CentOS 7 安装命令
仅在能访问管理员配置的内网 YUM 源时执行;旧公共源不可用时,请管理员提供离线 RPM 和依赖。
作用:安装下载、解压、编辑及 SELinux 标记工具,不安装或升级 Docker。
Linux 终端命令 复制命令
sudo yum install -y ca-certificates curl unzip nano util-linux policycoreutils-python container-selinux
2. 下载并准备部署目录
仅用于首次安装 。已有 /opt/hitek-auth-client 时不要删除重装,请使用手动升级 。输入地址时回车使用正式环境;内网部署填写实际根地址。下载的 ZIP 需为 3.1.6 或更高兼容版本。
展开首次下载与安装命令
作用:自动识别 CPU,下载本机架构的 ZIP,解压并校验全部文件,导入镜像并创建部署目录。此步骤不启动业务同步,也不覆盖已有部署。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
umask 077
install_dir=/opt/hitek-auth-client
for tool in curl unzip sha256sum docker; do
command -v "$tool" >/dev/null || { echo "缺少 $tool,请先完成环境检查。"; exit 1; }
done
sudo -v
sudo test ! -e "$install_dir" || { echo "部署目录已存在,请使用升级步骤:$install_dir"; exit 1; }
sudo docker info >/dev/null
sudo docker compose version
case "$(uname -m)" in
x86_64) arch=amd64; product_type=HitekAuthClientDockerAmd64 ;;
aarch64|arm64) arch=arm64; product_type=HitekAuthClientDockerArm64 ;;
*) echo '当前 CPU 架构暂不支持。'; exit 1 ;;
esac
read -r -p '授权中心根地址 [https://auth.qdm123.com/]: ' server </dev/tty
server="${server:-https://auth.qdm123.com/}"
[[ "$server" == http://* || "$server" == https://* ]] || { echo '地址必须以 http:// 或 https:// 开头。'; exit 1; }
[[ "$server" != *'?'* && "$server" != *'#'* && "$server" != *'@'* && "$server" != *[[:space:]]* ]] || { echo '请输入不含账号、空格、查询参数或片段的系统根地址。'; exit 1; }
mkdir -p "$HOME/hitek-downloads"
package_dir="$(mktemp -d "$HOME/hitek-downloads/release.XXXXXX")"
url="${server%/}/api/ClientSetup/DownLoadSetupClient?PType=$product_type"
redirect_protocols='=http,https'
[[ "$server" != https://* ]] || redirect_protocols='=https'
echo "正在下载 $arch 安装包到:$package_dir"
if ! curl --fail --show-error --location --connect-timeout 20 --max-time 1800 \
-H 'Accept: */*' --proto '=http,https' --proto-redir "$redirect_protocols" \
--output "$package_dir/package.zip.part" "$url"; then
echo '下载失败,未安装。404 通常表示对应下载类型尚未上传可用包;请联系管理员。'
exit 1
fi
mv "$package_dir/package.zip.part" "$package_dir/package.zip"
unzip -tq "$package_dir/package.zip"
unzip -q "$package_dir/package.zip" -d "$package_dir/unpacked"
cd "$package_dir/unpacked"
sha256sum --check SHA256SUMS
shopt -s nullglob
images=(hitek-auth-client-*-linux-"$arch".tar)
[[ ${#images[@]} -eq 1 ]] || { echo '包内镜像数量或架构不符,停止安装。'; exit 1; }
sudo docker load --input "${images[0]}"
sudo bash docker-deployment/docker-install.sh "$install_dir"
printf '下载来源:%s\n解压目录:%s\n部署目录:%s\n' "$server" "$PWD" "$install_dir"
echo '目录准备完成。下一步填写配置;内网部署请把 ServerRoot 改成上面输入的地址。'
BASH
完成后应看到文件校验 OK、Loaded image 和“目录准备完成”。接着填写配置;内网部署还需在配置中填写相同的 ServerRoot。
3. 填写配置
3.1 备份并编辑
作用:备份当前配置,然后用 Nano 打开配置文件;备份仅 root 可读。已有运行中的部署请先按第 6 节暂停定时升级。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
sudo install -m 0600 config/appsettings.json "backups/appsettings-$(date +%Y%m%d-%H%M%S)-$$.json" &&
sudo nano config/appsettings.json
Nano 中按 Ctrl+O、回车保存,Ctrl+X 退出。替换示例值时保留 JSON 的引号和逗号;密码只在服务器上填写。
3.2 常用配置:MySQL 自动发现客户
下面是可替换整个配置文件的示例。改好 ClientName、数据库地址、账户、密码和库名;使用内网授权中心时也改 ServerRoot。同一连接的多个库可追加到 DatabaseNames,不同连接在 Databases 中另加对象。
作用:配置 MySQL 业务库,自动读取库中的单位或项目信息。请粘贴到 appsettings.json,不要在终端直接执行。
配置内容 复制配置
{
"HitekAuthClient": {
"ServerRoot": "https://auth.qdm123.com/",
"AllowInsecureHttp": false,
"ClientName": "请替换为现场服务器名称",
"SyncIntervalMinutes": 10,
"HttpTimeoutSeconds": 30,
"DataDirectory": "/data",
"PluginDirectory": "/app/plugins",
"ApplyAuthorizationPackages": true,
"UploadDiskTelemetry": false,
"ValidateAuthorizationOffline": true,
"Customers": [],
"Databases": [
{
"DatabaseType": "MYSQL",
"ConnectionString": "Server=请替换为数据库IP;Port=3306;User ID=请替换为数据库账户;Password=请替换为数据库密码;",
"DatabaseNames": [
"请替换为实际业务库名"
]
}
]
}
}
MySQL 自动发现需使用支持的业务表:ILIS Java 的 t_s_depart_version / t_unit,或 QDM / HIPMS 的 hipms_project + hipms_unit。单位/项目授权名称应与授权中心登记一致。不是这些结构时由负责人核对,或使用下面的手工配置。
按需:Customers 手工指定客户(完整配置)
与上面的完整 JSON 二选一,不要拼接两份配置。 适用于已明确单位/项目的部署;多个目标在 Customers 中追加对象。两种方式可组合,但同一目标不要重复填写。
单位、项目、192.0.2.x 地址及账户均为虚构示例,使用前替换为现场信息和密码。单位/项目名称与授权中心登记一致;DatabaseName 与连接字符串中的 Database 一致。
作用:配置两个手工目标:ILIS Java + MySQL 单位、QDM + SQL Server 项目;替换完整配置文件,仅需一个目标时删除另一对象及多余逗号。
配置内容 复制配置
{
"HitekAuthClient": {
"ServerRoot": "https://auth.qdm123.com/",
"AllowInsecureHttp": false,
"ClientName": "示例检测中心授权终端-01",
"SyncIntervalMinutes": 10,
"HttpTimeoutSeconds": 30,
"DataDirectory": "/data",
"PluginDirectory": "/app/plugins",
"ApplyAuthorizationPackages": true,
"UploadDiskTelemetry": false,
"ValidateAuthorizationOffline": true,
"Customers": [
{
"CustomerName": "示例市工程检测中心",
"ProjectName": "",
"SystemType": "ILIS_JAVA",
"DatabaseType": "MYSQL",
"DatabaseName": "ilis_lab",
"ConnectionString": "Server=192.0.2.10;Port=3306;Database=ilis_lab;User ID=ilis_auth;Password=请替换为实际MySQL密码;"
},
{
"CustomerName": "示例交通建设有限公司",
"ProjectName": "示例高速公路一期",
"SystemType": "QDM",
"DatabaseType": "MSSQL",
"DatabaseName": "qdm_phase1",
"ConnectionString": "Server=tcp:192.0.2.20,1433;Database=qdm_phase1;User ID=qdm_auth;Password=请替换为实际SQLServer密码;Encrypt=True;TrustServerCertificate=False;"
}
],
"Databases": []
}
}
客户/项目名称须与授权中心一致;QDM、HIPMS、HIDOC 填写 ProjectName。手工目标的 DatabaseName 是单个库名,应与连接字符串中的 Database 一致。
按需:SQL Server 数据源
保留完整配置的其他字段和 Customers: [],仅替换 Databases 数组中的一个对象。
作用:配置一个 SQL Server 自动发现数据源;这是局部对象,不能覆盖整个配置文件。
配置内容 复制配置
{
"DatabaseType": "MSSQL",
"ConnectionString": "Server=tcp:请替换为数据库IP,1433;User ID=请替换为数据库账户;Password=请替换为数据库密码;Encrypt=True;TrustServerCertificate=False;",
"DatabaseNames": [
"请替换为实际业务库名"
],
"SystemType": "ILIS"
}
从 TestUnit 识别 ILIS 单位,从 Project 及对应业务表识别 QDM / HIDOC。SystemType 仅为 TestUnit 缺少有效类型时兜底(桥检用 ILIS_BRIDGE);有效的 AS_SystemType 优先,不会强制覆盖所有结果。加密与证书参数由数据库负责人提供。
按需:内网 HTTP、连接字符串注意事项
作用:指定内网授权中心并明确允许 HTTP;仅替换完整配置中的这两项。
配置内容 复制配置
"ServerRoot": "http://192.168.2.31:8080/",
"AllowInsecureHttp": true
旧配置如有自定义 ServerGetApi / ServerDriverApi,删除这两项才会统一跟随根地址;无法连接时不会自动切回公网。JSON 内的双引号写成 \",反斜杠写成 \\。
若现场 JDBC 明确使用 useSSL=false,MySQL 的对应参数为 SslMode=Disabled;其他现场按数据库实际 TLS 要求配置。不要为了消除报错盲目关闭证书验证。
作用:保存配置后恢复文件所有者与权限,让默认容器账户能读取配置。
Linux 终端命令 复制命令
sudo chown root:1654 /opt/hitek-auth-client/config/appsettings.json && sudo chmod 640 /opt/hitek-auth-client/config/appsettings.json
3.3 CentOS 7:设置目录标签
配置保存后、连接检查前执行;SELinux 为 Disabled 时脚本自动跳过。
作用:为配置、数据、缓存、日志和升级目录设置容器可用的 SELinux 标签;不关闭 SELinux。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
state="$(getenforce)"
if [[ "$state" == Disabled ]]; then
echo 'SELinux 已禁用,无需设置标签。'
exit 0
fi
command -v semanage >/dev/null || { echo '缺少 semanage,请先按第 1 节安装 policycoreutils-python。'; exit 1; }
root_dir=/opt/hitek-auth-client
for directory in config data cache logs updates; do
sudo test -d "$root_dir/$directory" || { echo '请先完成第 2 步目录准备。'; exit 1; }
done
rule='/opt/hitek-auth-client/(config|data|cache|logs|updates)(/.*)?'
sudo semanage fcontext -a -t container_file_t "$rule" 2>/dev/null || sudo semanage fcontext -m -t container_file_t "$rule"
sudo restorecon -RFv "$root_dir/config" "$root_dir/data" "$root_dir/cache" "$root_dir/logs" "$root_dir/updates"
sudo ls -Zd "$root_dir/config" "$root_dir/data" "$root_dir/cache" "$root_dir/logs" "$root_dir/updates"
BASH
输出应包含 container_file_t。类型无效时请管理员核对 container-selinux 与 Docker;恢复备份后可重新执行。
按需:数据库在本机 Docker 中,需接入已有网络
连接本机 Docker 数据库
数据库与客户端由同一 Docker Engine 管理、希望用容器别名连接时执行;使用独立服务器 IP 的部署可跳过。示例网络为 gzsz-runtime,数据库容器为 gzsz-dependencies-mysql-1,别名为 gzsz-mysql,请以现场查询结果为准。
作用:列出运行中的容器、网络和端口,找到数据库容器名称。
Linux 终端命令 复制命令
sudo docker ps --format 'table {{.Names}}\t{{.Networks}}\t{{.Ports}}'
作用:输入数据库容器名称,查询它所在的网络和可用别名。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
read -r -p '请输入数据库容器名称: ' db_container </dev/tty
[[ -n "$db_container" ]] || { echo '容器名称不能为空。'; exit 1; }
sudo docker inspect --format \
'{{range $name, $network := .NetworkSettings.Networks}}网络={{$name}}
网络别名={{json $network.Aliases}}
{{end}}' "$db_container"
BASH
已有运行中的部署先按第 6 节暂停定时升级。以下命令只用于尚未自定义网络的标准 Compose 文件;已成功接入的不必重复执行。
作用:备份 Compose 并将客户端接入指定的已有网络;配置验证失败时恢复原文件。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
umask 077
cd /opt/hitek-auth-client
read -r -p '请输入要接入的已有 Docker 网络名称(例如 gzsz-runtime): ' network </dev/tty
[[ "$network" =~ ^[A-Za-z0-9][A-Za-z0-9_.-]*$ ]] || { echo '网络名称无效。'; exit 1; }
docker network inspect "$network" >/dev/null
exec 8>.deployment.lock
flock -n 8 || { echo '另一个检测、同步或升级操作正在进行,请稍后重试。'; exit 1; }
if grep -Eq '^[[:space:]]*(networks|network_mode)[[:space:]]*:' docker-compose.yml; then
echo '文件已有网络配置,停止追加。已接入的现场直接检查连接和实际网络;需改接其他网络时请负责人修改现有定义。'
exit 1
fi
backup="backups/docker-compose-before-network-$(date +%Y%m%d-%H%M%S)-$$.yml"
install -m 0600 docker-compose.yml "$backup"
cat >> docker-compose.yml <<YAML
networks:
default:
external: true
name: "$network"
YAML
if ! docker compose --env-file .env -f docker-compose.yml config --quiet; then
cp "$backup" docker-compose.yml
echo 'Compose 配置验证失败,已恢复原文件。'
exit 1
fi
printf '已配置外部网络:%s\n备份文件:%s\n' "$network" "$backup"
echo '下一步核对数据库连接地址,再单独执行连接检查。已有后台容器需在检查通过后运行 manage.sh start 重建。'
BASH
在配置中使用数据库别名和容器内部端口 ,例如 Server=gzsz-mysql;Port=3306;。即使显示 3339->3306,同网络仍用 3306;3339 用于访问宿主机映射端口。库名填入 DatabaseNames。
首次部署接着做第 4 步。已有客户端则重新检查连接,成功后执行 manage.sh start,Compose 会按新网络重建容器;随后在第 5 节恢复定时升级。
作用:客户端启动后,查询它实际使用的网络和别名,确认接入结果。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
cid="$(sudo docker compose --env-file .env -f docker-compose.yml ps -a -q hitek-auth-client)"
if [[ -z "$cid" ]]; then
echo '尚未找到正式客户端容器。connections 使用临时容器,检测结束后会自动删除;首次部署请先完成同步验收并启动。'
exit 0
fi
sudo docker inspect --format \
'容器名称={{.Name}}
{{range $name, $network := .NetworkSettings.Networks}}网络={{$name}}
网络别名={{json $network.Aliases}}
{{end}}' "$cid"
BASH
4. 检查、首次同步并启动
检查失败先处理错误;连接通过不代表客户发现和授权写入已成功。
作用:先检查配置与运行环境,再测试授权中心连接和数据库登录(SELECT 1),不写业务表。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
sudo bash manage.sh check && sudo bash manage.sh connections
首次同步前,由负责人确认业务数据库已备份、旧客户端已停止。首次部署此时还没有后台同步进程。
作用:执行一次真实授权同步,会写入业务库;确认识别到预期客户且授权生效后再启动后台服务。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh once
作用:查看首次同步的最近日志,核对客户发现、授权处理及失败原因。
Linux 终端命令 复制命令
sudo tail -n 100 /opt/hitek-auth-client/logs/hitek-auth-client.log
作用:启动后台服务并查看状态;应显示 Up,随后变为 healthy。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
sudo bash manage.sh start && sudo bash manage.sh status
healthy 只表示进程正常,还需在业务系统确认授权生效,并在授权中心核对服务器名称、版本和连接时间。默认每轮同步结束后等待 10 分钟;管理端阈值也是 10 分钟,耗时或网络延迟可能造成短暂超时提示。
5. 开启自动升级
首次同步验收通过、后台容器运行后执行。授权同步默认 10 分钟 ;版本检查为 每分钟 ,两者独立。
作用:启用每分钟检查更新,下载地址跟随配置中的 ServerRoot;修改配置后恢复自动升级也用此命令。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash enable-auto-upgrade.sh
作用:确认自动升级定时器已启用,并查看下一次检查时间。
Linux 终端命令 复制命令
sudo systemctl list-timers 'hitek-auth-client-update-*' --all
作用:立即检查一次版本;有新包时下载、校验、备份并切换镜像,不健康时尝试回退。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash auto-upgrade.sh
没有输出不一定异常 :已处理过的下载地址、无待处理包或锁被占用时可能静默退出。结合第 6 节运行版本和升级日志判断。相同 URL 不重复下载,旧版本不自动降级,失败版本不循环重试;修复包应发布更高版本并使用新 URL。
6. 日常维护与手动升级
按需要执行对应命令,不要一次执行本节所有操作。配置、数据、缓存和日志由宿主机持久化,镜像升级会保留它们。
作用:查看当前运行状态和最近业务日志,用于日常巡检或排查同步失败。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
# 查看容器运行状态
sudo bash manage.sh status
# 查看最近业务同步日志
sudo bash manage.sh logs
作用:查询正在运行的镜像版本;显示 3.1.6 或更高版本表示已包含 HTTP 406 修复。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
cid="$(sudo docker compose --env-file .env -f docker-compose.yml ps -q hitek-auth-client)"
[[ -n "$cid" ]] || { echo '后台容器未运行。'; exit 1; }
image="$(sudo docker inspect --format '{{.Image}}' "$cid")"
sudo docker image inspect --format '{{index .Config.Labels "org.opencontainers.image.version"}}' "$image"
BASH
查看自动升级日志与处理记录
作用:读取本安装目录对应的升级服务最近 100 条日志。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
suffix="$(printf '%s' /opt/hitek-auth-client | sha256sum)"
sudo journalctl -u "hitek-auth-client-update-${suffix:0:12}.service" -n 100 --no-pager
BASH
作用:查看已成功或失败的升级记录;下载完成不等于升级成功。
Linux 终端命令 复制命令
sudo find /opt/hitek-auth-client/updates/applied /opt/hitek-auth-client/updates/failed -name result.log -exec tail -n 30 {} \;
修改配置后让新配置生效
按顺序暂停定时升级 → 备份并编辑配置 → 检查并重启 → 恢复定时升级。停止定时器不会中断已经开始的一次升级;若仍在执行,等待结束再修改。
作用:停止并禁用本安装目录的升级定时器,同时查看是否仍有升级任务在执行。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
suffix="$(printf '%s' /opt/hitek-auth-client | sha256sum)"
unit="hitek-auth-client-update-${suffix:0:12}"
sudo systemctl disable --now "$unit.timer"
sudo systemctl status "$unit.service" --no-pager || true
BASH
使用第 3.1 节备份和编辑配置;原配置不会因镜像升级自动改写。保存后恢复第 3 节文件权限,CentOS 7 同时恢复 SELinux 标签。
作用:检查配置,随后重启客户端以结束旧等待并加载新配置;会短暂停止同步。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client
# 检查成功后停止,再启动,让新配置立即生效
sudo bash manage.sh check && sudo bash manage.sh stop && sudo bash manage.sh start
核对本节运行状态与业务日志,正常后执行第 5 节 enable-auto-upgrade.sh 恢复定时升级。
临时停止客户端或再执行一次同步
作用:停止后台客户端;后续不会继续同步,直到手动启动。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh stop
作用:后台停止后执行一次同步;会写业务库,禁止与后台客户端同时执行。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh once
作用:重新启动后台客户端,恢复持续同步。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh start
手动升级:自动下载失败或需要人工升级时展开
首次安装能下载,自动升级却报 HttpRequestException / HTTP 406
旧版下载 ZIP 时误带 JSON 请求头,文件服务器可能返回 HTTP 406;3.1.6 已修复。旧程序需要先手动升级一次 ,也可在需要人工升级时使用下面的宿主机下载方式。
先由管理员发布本机架构的 3.1.6 或更高兼容版本。命令保留配置、Compose 网络和数据;会在校验、备份后短暂重启客户端。只恢复程序不等于撤销业务数据库变更。
作用:下载并校验最新发布包,检查版本和架构,兼容旧脚本的 TTY 设置,再调用升级脚本并显示状态与日志。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
umask 077
cd /opt/hitek-auth-client
for tool in curl unzip sha256sum docker flock; do
command -v "$tool" >/dev/null || { echo "缺少 $tool,请先安装。"; exit 1; }
done
case "$(uname -m)" in
x86_64) arch=amd64; product_type=HitekAuthClientDockerAmd64 ;;
aarch64|arm64) arch=arm64; product_type=HitekAuthClientDockerArm64 ;;
*) echo '不支持此架构。'; exit 1 ;;
esac
read -r -p '授权中心根地址 [https://auth.qdm123.com/]: ' server </dev/tty
server="${server:-https://auth.qdm123.com/}"
[[ "$server" == http://* || "$server" == https://* ]] || exit 1
[[ "$server" != *'?'* && "$server" != *'#'* && "$server" != *'@'* && "$server" != *[[:space:]]* ]] || exit 1
package_dir="$(mktemp -d /var/tmp/hitek-upgrade.XXXXXX)"
redirect_protocols='=http,https'
[[ "$server" != https://* ]] || redirect_protocols='=https'
curl --fail --show-error --location --connect-timeout 20 --max-time 1800 \
--proto '=http,https' --proto-redir "$redirect_protocols" -H 'Accept: */*' \
--output "$package_dir/package.zip" \
"${server%/}/api/ClientSetup/DownLoadSetupClient?PType=$product_type"
unzip -q "$package_dir/package.zip" -d "$package_dir/unpacked"
(cd "$package_dir/unpacked" && sha256sum --check SHA256SUMS)
shopt -s nullglob
images=("$package_dir/unpacked"/hitek-auth-client-*-linux-"$arch".tar)
[[ ${#images[@]} -eq 1 ]] || { echo '包内镜像数量或架构错误。'; exit 1; }
archive="${images[0]}"
version="$(basename "$archive")"
version="${version#hitek-auth-client-}"
version="${version%-linux-$arch.tar}"
[[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || exit 1
[[ "$(printf '%s\n' 3.1.6 "$version" | sort -V | head -n 1)" == 3.1.6 ]] ||
{ echo '下载类型还没发布 3.1.6 或更高版本,请先发布。'; exit 1; }
exec 7>updates/.watcher.lock
flock -n 7 || { echo '自动升级正在进行,请稍后重试。'; exit 1; }
exec 8>.deployment.lock
flock -n 8 || { echo '部署操作正在进行,请稍后重试。'; exit 1; }
backup="backups/upgrade-before-406-$(date +%Y%m%d-%H%M%S)-$$.sh"
install -m 0600 upgrade.sh "$backup"
sed -i 's/ run --rm --no-deps / run --rm -T --no-deps /g' upgrade.sh
if ! bash -n upgrade.sh; then
install -m 0755 "$backup" upgrade.sh
echo '脚本检查失败,已恢复。'
exit 1
fi
flock -u 8
exec 8>&-
bash upgrade.sh "$archive" "hitek-auth-client:$version-linux-$arch"
bash manage.sh status
bash manage.sh logs
BASH
正常结果包含“升级成功”;再确认业务同步。完成后继续使用第 5 节自动升级。若旧宿主机下载网络尚未修复,按第 7 节处理。
由负责人操作:回退旧镜像
先按“修改配置”中的命令停用定时器,确认正在执行的升级结束。回退期间保持定时器停用,避免再次升级。
作用:列出升级备份中的旧镜像 ID,由负责人选择要恢复的版本。
Linux 终端命令 复制命令
sudo find /opt/hitek-auth-client/backups -name old-image-id.txt -print -exec cat {} \;
作用:输入选定的 sha256 镜像 ID,切换回本机保留的旧镜像;不倒灌旧数据。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
read -r -p '要回退到的完整镜像 ID(sha256:开头): ' image </dev/tty
[[ "$image" =~ ^sha256:[a-f0-9]{64}$ ]] || { echo '镜像 ID 格式不正确。'; exit 1; }
cd /opt/hitek-auth-client
sudo bash upgrade.sh --local "$image"
BASH
回退不能撤销已写入业务数据库的变更。检查业务结果后再决定是否恢复自动升级。
7. 常见问题
数据库连接失败:查看检测报告
作用:重新检查授权中心和数据库连接,不写业务表。
Linux 终端命令 复制命令
cd /opt/hitek-auth-client && sudo bash manage.sh connections
作用:查看连接检查报告,按失败项定位问题;分享日志前确认没有现场敏感信息。
Linux 终端命令 复制命令
sudo cat /opt/hitek-auth-client/logs/connection-check.json
旧脚本:下载容器没有使用客户端网络
新脚本默认跟随正在运行的客户端网络。旧脚本使用 bridge,可能导致业务连接成功但升级下载失败。镜像升级不会替换宿主机脚本 ,此修复只需执行一次。
作用:取得锁、备份并修复下载脚本的默认网络;已修复则跳过,语法错误会恢复原文件。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
exec 7>updates/.watcher.lock
flock -n 7 || { echo '自动下载或升级正在进行,请稍后重试。'; exit 1; }
exec 8>.deployment.lock
flock -n 8 || { echo '另一个部署操作正在进行,请稍后重试。'; exit 1; }
if grep -Fq '${HITEK_UPDATE_NETWORK:-container:$container}' sync-update-source.sh; then
echo '脚本已默认跟随客户端网络,无需重复修复。'
exit 0
fi
grep -Fq '${HITEK_UPDATE_NETWORK:-bridge}' sync-update-source.sh || { echo '脚本内容与本修复不匹配,请负责人核对版本。'; exit 1; }
backup="backups/sync-update-source-before-network-$(date +%Y%m%d-%H%M%S)-$$.sh"
install -m 0600 sync-update-source.sh "$backup"
sed -i 's/${HITEK_UPDATE_NETWORK:-bridge}/${HITEK_UPDATE_NETWORK:-container:$container}/g' sync-update-source.sh
if ! bash -n sync-update-source.sh; then
install -m 0755 "$backup" sync-update-source.sh
echo '脚本检查失败,已恢复原文件。'
exit 1
fi
printf '已修复自动下载网络。备份:%s\n' "$backup"
BASH
修复后执行第 5 节立即检查更新;HTTP 406 需按第 6 节升级程序,单改网络无法解决。
旧脚本:the input device is not a TTY
旧版 Compose 命令在脚本或定时器中申请交互终端,需添加 -T。
作用:备份并修复检查、升级命令的终端参数,然后重新检查连接;不改数据库配置和网络。
Linux 终端命令 复制命令
sudo bash <<'BASH'
set -euo pipefail
cd /opt/hitek-auth-client
stamp="$(date +%Y%m%d-%H%M%S)-$$"
for file in manage.sh upgrade.sh; do
install -m 0600 "$file" "backups/$file-before-tty-$stamp"
sed -i 's/ run --rm --no-deps / run --rm -T --no-deps /g' "$file"
bash -n "$file"
done
bash manage.sh connections
BASH
旧 ZIP:中文文件名乱码或找不到说明文件
旧 3.1.3 ZIP 的中文说明文件可能被解压工具改名;新包使用英文文件名。仅这三个说明文件找不到时可恢复,其他校验失败应重新下载正确包。
作用:输入已有下载目录,恢复中文说明文件并重新校验全部文件;部署目录不存在时继续准备首次安装。
Linux 终端命令 复制命令
bash <<'BASH'
set -euo pipefail
read -r -p '请输入包含 package.zip 的下载目录(绝对路径): ' package_dir </dev/tty
[[ "$package_dir" == /* ]] || { echo '必须使用绝对路径。'; exit 1; }
cd "$package_dir/unpacked"
unzip -p ../package.zip '00-Docker*.md' > '00-Docker上传说明.md'
unzip -p ../package.zip 'LinuxDocker*.html' > 'LinuxDocker部署指南.html'
unzip -p ../package.zip 'LinuxDocker*.md' > 'LinuxDocker部署指南.md'
sha256sum --check SHA256SUMS
case "$(uname -m)" in x86_64) arch=amd64 ;; aarch64|arm64) arch=arm64 ;; *) exit 1 ;; esac
shopt -s nullglob
images=(hitek-auth-client-*-linux-"$arch".tar)
[[ ${#images[@]} -eq 1 ]] || { echo '镜像数量或架构不符。'; exit 1; }
sudo test ! -e /opt/hitek-auth-client || { echo '部署目录已存在,请继续配置或使用升级流程。'; exit 1; }
sudo docker load --input "${images[0]}"
sudo bash docker-deployment/docker-install.sh /opt/hitek-auth-client
echo '目录准备完成,请继续第 3 步填写配置。'
BASH
不要删除校验条目或用 --ignore-missing 跳过检查。
CentOS 7:目录无权限或容器启动失败
先核对第 3 节文件权限和 SELinux 标签。若是线程创建、不支持的系统调用等错误,由管理员核对内核、Docker 和 libseccomp。
作用:查看近期 SELinux 拒绝记录,辅助定位权限问题;需已安装 audit 包。
Linux 终端命令 复制命令
sudo ausearch -m AVC,USER_AVC -ts recent
不使用 chmod 777、关闭 SELinux、--privileged 或禁用 seccomp 绕过问题。
8. 发布包管理与验收范围 管理员入口:下载类型管理 ;amd64 文件版本列表 ;arm64 文件版本列表 。新增类型需要“文件类型管理”权限,上传需要“文件版本添加”权限;看不到入口时联系管理员。
下载当前已发布包:amd64 ZIP · arm64 ZIP 。入口存在不表示新版本已发布。
由发布人员在对应下载类型中新建版本,上传单架构 ZIP 原文件 ,使用新 URL 并保留历史版本;不要混用 Windows 的下载类型。
配置、data、cache、logs 持久化挂载;日志自动滚动,备份和升级归档由管理员按保留策略清理,不删除运行目录。服务器重启恢复需确认 Docker 开机启动并实际验收。
x64 容器和 ARM64 模拟环境已有测试记录;CentOS 7、麒麟及鲲鹏实机、现场数据库、systemd 和整机重启仍需现场验收。