← 返回管理端在线操作手册 · 核对日期 2026-10-26 · 可用 Ctrl+F 查找、Ctrl+P 打印

开始前先看

  1. 让负责人提供匹配平台的正式交付包、服务器名称、授权中心及数据库配置,并确认本次使用的版本。实际数据库账户和密码由负责人安全提供。
  2. 安排维护时间,备份业务数据库;同一业务库切换客户端前,确认旧客户端和后台同步进程均已停止。
  3. 按步骤复制代码框中的命令,每块成功后再继续;多行脚本须整块复制执行。“复制配置”只用于配置编辑器,不要当作命令执行。示例字段必须换成负责人提供的值。遇到错误先停在这一步,保存脱敏后的错误与日志。
平台不要混用:Windows 仍是 Windows Service(.NET Framework);Linux 镜像已包含 .NET 8,无需给 Linux 另装 .NET。Docker 命令只在 Linux 服务器终端执行。

WINDOWS SERVICE

Windows Service 部署指南

适用于现有 HitekAuthClientServiceSetup.exe 安装器及 Windows 服务交付包。请使用同一批次的安装器、升级组件和客户端,不要从开发输出目录拼装文件。

1. 准备安装资料

  1. 使用具有本机管理员权限的账户登录 Windows。请负责人准备与服务器及正式交付包匹配的 .NET Framework 运行环境,按随包 exe.config 和发布说明核对;不能用 .NET 8 代替。
  2. 把安装器压缩包完整解压到长期保留的目录,例如 D:\HitekAuthClient。不要在 ZIP 内直接运行,不要安装到临时下载目录。
  3. 负责人核对安装器的 HitekAuthClientServiceSetup.exe.config 中 RootURL 以及客户端授权中心设置。安装器会连接授权中心获取当前 Windows 服务包;仅有 Setup 文件不能完成离线安装。
  4. 如已有服务,先打开 services.msc(Win+R 输入后回车),查找“海特授权服务终端”,记录服务可执行文件路径、登录账户及启动类型。不要在另一目录重复安装。
首次安装会启动服务并触发业务处理。点击安装前须确认业务库已备份,配置属于本单位,旧客户端已经停止。另附的 Windows 跨平台环境检测工具不会安装这里的 Windows 服务。

2. 填写并保存配置

  1. 右键 HitekAuthClientServiceSetup.exe,选择“以管理员身份运行”。
  2. 在“服务器名称”填写负责人指定的名称,它对应 ClientName。不要随意更名或复用另一台机器的名称。
  3. 点击“新增连接”,填写连接名称,明确选择“SQL Server”或“MySQL”。在“完整连接字符串”中粘贴负责人提供的内容;有多条连接时逐条录入。
  4. 需要向导时打开“生成向导”,填写数据库地址、端口、库名和身份验证方式,点击“生成并填入字符串”,再检查最终字符串。只修改向导字段不会自动应用。
  5. 点击“保存全部配置”。未安装时只保存本地缓存;已经安装时会卸载、重装服务并应用配置,造成短暂停服并重新触发业务处理,须安排维护时间。

配置缓存为安装器目录下的 HitekAuthClientConfig.Json。安装及升级将连接名称、类型和完整字符串写入服务目录内的 HitekAuthClientService.exe.config 与 HitekAuthClientApplication.exe.config。后续通过 Setup 保存,避免只改服务配置而没有更新缓存。

授权中心地址与缓存优先级(3.1.3)

默认正式地址是 https://auth.qdm123.com/。首次安装前,在 HitekAuthClientServiceSetup.exe.config 的 appSettings 中核对或设置 RootURL;安装器会把它保存为客户端的 ServerRoot。

已有安装先备份安装器目录中的 HitekAuthClientConfig.Json,关闭 Setup 后修改其中的 AppSettings.ServerRoot,再打开 Setup 并执行“保存全部配置”。缓存中的 ServerRoot 优先于安装器 RootURL,后续服务升级会沿用现场地址;直接手改服务 exe.config 不能替代更新缓存。

ServerGetAPI、ServerDriverAPI 可以省略并自动跟随根地址;旧正式 API 值会跟随。曾经填写的自定义 API 覆盖仍保留,需删除或清空后才会统一跟随。安装工具自身的 HitekAuthClientServiceSetupUpdateConsole.exe.config 具有独立 RootURL,内网部署也要单独核对。Windows 仍使用 HitekAuthClient 下载类型和 Windows Service,不使用 Linux 的 AllowInsecureHttp。

保存成功不等于连接成功。保存只检查类型和字符串格式。SQL Server Windows 身份验证使用服务实际运行账户,安装器默认是 LocalSystem,并非当前桌面用户。MySQL 的 SslMode=None 表示不使用 TLS,只能在负责人确认允许时选择。

3. 安装与首次验收

  1. 再次确认数据库备份和停旧客户端已完成,然后点击“立即安装”,等待窗口日志完成下载、解压、写入配置与安装。
  2. 点击“打开服务目录”。默认位于安装器目录下的 HitekAuthClientService 子目录;不要在安装后移动或删除父目录中的 Setup。
  3. 打开 services.msc,检查下面两个服务均存在、正在运行且启动类型为“自动”。也可以按下一节的查询命令核对。
  4. 检查本次时间的程序日志、授权管理端终端状态,以及目标业务系统的授权结果。服务显示“正在运行”只能证明服务启动,不能替代业务验收。
服务名(命令中原样使用)用途
HitekAuthClientService授权主服务,启动时执行一次,后续按 TaskInterval 周期处理。
HitekAuthClientServiceDeamons守护服务,约每 3 秒检查并拉起已停止的主服务。名称中的 Deamons 是实际拼写。

4. 启停与日志

开始菜单搜索“PowerShell”,右键“以管理员身份运行”。先查询服务和实际路径:

PowerShell 命令

Get-Service -Name HitekAuthClientService,HitekAuthClientServiceDeamons
sc.exe qc HitekAuthClientService
sc.exe qc HitekAuthClientServiceDeamons

停止:先守护服务,再主服务

PowerShell 命令

Stop-Service -Name HitekAuthClientServiceDeamons
Stop-Service -Name HitekAuthClientService
Get-Service -Name HitekAuthClientService,HitekAuthClientServiceDeamons

确认两项都是 Stopped。如果服务不存在或停止失败,先交给负责人核对,不要继续覆盖文件。

主服务启动的业务程序和更新程序是独立进程,停服务后还需检查:

PowerShell 命令

Get-Process -Name HitekAuthClientApplication,HitekAuthClientServiceSetup,HitekAuthClientServiceSetupUpdateConsole -ErrorAction SilentlyContinue

关闭自己打开的 Setup 窗口,等待后台任务自然退出。若仍有进程,由负责人判断后处理;不要直接强杀正在写库的进程。需要跨重启维护时,请负责人同时管理两项服务的启动类型,结束后恢复原设置。

启动:先主服务,再守护服务

PowerShell 命令

Start-Service -Name HitekAuthClientService
Start-Service -Name HitekAuthClientServiceDeamons
Get-Service -Name HitekAuthClientService,HitekAuthClientServiceDeamons

查看日志

在 Setup 点击“打开服务目录”,查看 Logs 中当天的 AT_yyyyMMdd.log 和 ERROR_yyyyMMdd.log;安装器自身日志在其所在目录的 Logs。滚动日志可能带附加序号,具体位置以随包 log4net.config / log4netDeamons.config 为准。启动失败且未产生日志时,打开“事件查看器 → Windows 日志 → 应用程序 / 系统”。

5. 升级与人工回退

升级前和升级后

  1. 安排维护窗口,先停两项服务并确认后台进程退出,再将整个安装器目录复制到另一个备份目录,保留 Setup、配置缓存、服务程序、业务文件及日志,同时备份业务数据库。
  2. 负责人确认授权中心发布的是目标 Windows 版本;更新 Setup 时须使用匹配的 HitekAuthClientServiceSetup.exe、HitekAuthClientUpdate.dll、HitekAuthClientServiceSetupUpdateConsole.exe 等正式文件,保留本机 JSON 缓存,不带入打包机器的配置。
  3. 以管理员身份运行 Setup,核对名称和连接后点击“立即安装”。只有负责人明确要求重新覆盖安装时才使用“强制重新安装”。检查窗口日志、服务状态和业务授权结果。

主服务启动及定时任务会调用父目录 Setup 的 backupdate 检查远端版本。当前 Windows 流程按授权中心版本下载更新,不使用 Linux 的 updates/inbox、镜像或 .ready 文件。

升级失败时如何回退

Windows 安装器没有一键回退或自动恢复备份功能。“强制重新安装”仍会获取授权中心当前版本,不能当作回退。先请发布负责人把更新源调整到批准的旧版本,或提供受控的恢复方案,否则恢复后启动可能再次下载新版本。
  1. 先按上一节停止守护和主服务,确认业务与升级进程退出。保留失败现场和日志,不要删除当前目录。
  2. 由负责人确认旧程序与当前配置、业务数据兼容,并已处理更新源。若有可用的已批准旧包,可通过 Setup 重新安装;若采用完整目录备份恢复,按下面步骤在原路径恢复。
  3. 在原服务目录,以管理员身份打开命令提示符(cmd),执行随包 unstall.bat,确认两项目标服务已卸载。记录其他报错交负责人判断;脚本中的旧 vshost 项不一定存在。
  4. 保留当前目录副本后,把确认可用的完整备份恢复到原安装路径,保留负责人确认的本机配置与业务状态;不要仅混拷某一个 DLL,也不要盲目覆盖升级后已产生的数据。
  5. 在恢复后的服务目录,以管理员 cmd 执行 install.bat。脚本会注册、启动两项服务并设为自动。重新完成服务、日志、业务结果验收。

回退程序不能撤销已写入业务数据库的变更。没有备份、服务无法卸载或数据兼容性不明时,应停在故障现场,由负责人处理。

6. Windows 常见故障

看到的情况下一步
停止后主服务又运行先停止 HitekAuthClientServiceDeamons,再停主服务;检查是否有未退出的 Setup / 更新进程。
拒绝访问、服务安装失败用管理员权限打开 Setup,核对目录写权限、正式包的 .NET Framework 要求及事件日志。
未获取到安装包、下载失败请负责人检查 RootURL、授权中心连通性及已登记的 Windows 包版本。Setup 不是独立离线服务包。
配置已保存但数据库连接失败核对实际数据库类型、地址、端口、库名、账户权限及 TLS 参数。Windows 身份验证检查服务登录账户。
服务运行但授权不生效看当天 ERROR / AT 日志;核对客户端名称、授权中心终端审核状态、数据库连接及目标单位授权,不要反复安装。
升级后配置不对检查本机 HitekAuthClientConfig.Json 与两份 exe.config,使用匹配版本的 Setup 核对保存;不要用旧版 Setup 保存新版 JSON。
返回页首 ↑

LINUX DOCKER · 3.1.6 指南

Linux Docker 部署指南

发布状态(2026-10-26):3.1.4 客户端源码已修复 Linux 上报字段大小写问题;当前准备版本为 3.1.6,新增 ZIP 下载请求头的 HTTP 406 修复,默认同步间隔仍为 10 分钟。3.1.6 包尚未上传生产。本页的版本、包名和升级步骤用于发布准备,不表示线上已经修复;下载入口仍返回管理端当前已发布的包,须核对实际运行版本。

适用程序:3.1.6 及以上兼容版本 · 更新日期:2026-10-26。

首次部署依次完成第 1~5 步;已经运行正常的服务器,直接看第 6 节日常维护。 折叠项仅在符合对应条件时展开。每段命令上方说明用途,点击“复制命令”后整段粘贴到 SSH 终端;JSON 点“复制配置”后粘贴到配置文件。

镜像包含 .NET 8,服务器无需另装 .NET;Windows 继续使用 Windows 服务。默认授权中心为 https://auth.qdm123.com/,支持现场指定的 HTTP/HTTPS 根地址。

适用于 Ubuntu 22.04 / 24.04;需要已安装 Docker Engine、Compose V2 和 systemd。

1. 准备与环境检查

准备 sudo 权限、服务器名称、授权中心地址,以及数据库地址、库名、账户和密码。授权中心需已发布本机架构的安装包;发布人员见第 8 节。服务器能访问授权中心及文件地址即可,不要求访问公网镜像仓库。

位置 用途
/opt/hitek-auth-client 推荐部署目录,后续命令统一使用此路径
config/appsettings.json 授权中心、服务器名称、数据库等配置,只读挂载给容器
data/、cache/、logs/ 数据、缓存和日志,升级保留
backups/、updates/ 升级备份和处理记录,保存在宿主机
~/hitek-downloads/ 安装包下载目录,与运行目录分开

作用:查看系统、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": [
          "请替换为实际业务库名"
        ]
      }
    ]
  }
}
配置项 填写规则
ServerRoot 授权中心根地址,支持端口和虚拟目录;同步与自动升级均跟随此地址
AllowInsecureHttp HTTPS 为 false;现场明确使用 HTTP 时改为 true
ClientName 真实服务器名称,显示在授权中心
SyncIntervalMinutes 默认 10;每轮同步完成后等待 10 分钟,不是升级检查间隔
ConnectionString .NET 连接字符串,不直接粘贴 jdbc:mysql://…;容器内的 localhost 指容器自身
DatabaseNames 明确列出实际库名;空数组或省略会枚举账户可见的非系统库
ApplyAuthorizationPackages 正式运行保持 true,同步会写入业务授权数据
UploadDiskTelemetry 是否上报磁盘信息;false 不影响授权同步和服务器名称上报

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": []
  }
}
业务系统 SystemType DatabaseType
ILIS Java ILIS_JAVA MYSQL
ILIS / ILIS 桥检 ILIS / ILIS_BRIDGE MSSQL
QDM QDM 按实际填 MYSQL 或 MSSQL
HIPMS HIPMS 或 HIPMS_JAVA MYSQL
HIDOC HIDOC MSSQL

客户/项目名称须与授权中心一致;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. 常见问题

现象 先检查什么
下载返回 404、解压或校验失败 核对根地址、下载类型和 ZIP 发布文件;校验失败不继续安装
提示部署目录已存在 保留现场目录,使用手动升级
数据库连接失败 核对地址、端口、账户权限和 TLS;Docker 别名须接入同一网络
healthy 但授权未生效 查看第 6 节业务日志,连接检查与容器健康不等于业务验收
名称或版本显示 null 旧上传协议问题已在 3.1.4 修复,升级到当前版本;旧 null 记录由管理员核对处理
很久未再次上报 检查间隔是否仍为 1440(每天一次);改为 10 后按第 6 节重启
自动升级没有输出 检查定时器、运行版本及升级日志;无新任务、已处理地址或锁占用可能静默退出
首次下载成功,升级报 HTTP 406 按第 6 节手动升级到 3.1.6 或更高版本
其他 HttpRequestException 分别核对查询接口和文件下载阶段的状态码、DNS、网络、TLS;旧脚本网络修复见下方
HTTPS 证书错误 核对时间、证书域名和信任链,不使用 curl -k 绕过
数据库连接失败:查看检测报告

作用:重新检查授权中心和数据库连接,不写业务表。

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 的下载类型。

服务器 CPU 下载类型编码 3.1.6 发布包
x86_64 / Intel / AMD HitekAuthClientDockerAmd64 hitek-auth-client-3.1.6-linux-amd64-upload.zip
aarch64 / ARM64 / 鲲鹏 HitekAuthClientDockerArm64 hitek-auth-client-3.1.6-linux-arm64-upload.zip

配置、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 节。服务器能访问授权中心及文件地址即可,不要求访问公网镜像仓库。

位置 用途
/opt/hitek-auth-client 推荐部署目录,后续命令统一使用此路径
config/appsettings.json 授权中心、服务器名称、数据库等配置,只读挂载给容器
data/、cache/、logs/ 数据、缓存和日志,升级保留
backups/、updates/ 升级备份和处理记录,保存在宿主机
~/hitek-downloads/ 安装包下载目录,与运行目录分开

作用:查看系统、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": [
          "请替换为实际业务库名"
        ]
      }
    ]
  }
}
配置项 填写规则
ServerRoot 授权中心根地址,支持端口和虚拟目录;同步与自动升级均跟随此地址
AllowInsecureHttp HTTPS 为 false;现场明确使用 HTTP 时改为 true
ClientName 真实服务器名称,显示在授权中心
SyncIntervalMinutes 默认 10;每轮同步完成后等待 10 分钟,不是升级检查间隔
ConnectionString .NET 连接字符串,不直接粘贴 jdbc:mysql://…;容器内的 localhost 指容器自身
DatabaseNames 明确列出实际库名;空数组或省略会枚举账户可见的非系统库
ApplyAuthorizationPackages 正式运行保持 true,同步会写入业务授权数据
UploadDiskTelemetry 是否上报磁盘信息;false 不影响授权同步和服务器名称上报

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": []
  }
}
业务系统 SystemType DatabaseType
ILIS Java ILIS_JAVA MYSQL
ILIS / ILIS 桥检 ILIS / ILIS_BRIDGE MSSQL
QDM QDM 按实际填 MYSQL 或 MSSQL
HIPMS HIPMS 或 HIPMS_JAVA MYSQL
HIDOC HIDOC MSSQL

客户/项目名称须与授权中心一致;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. 常见问题

现象 先检查什么
下载返回 404、解压或校验失败 核对根地址、下载类型和 ZIP 发布文件;校验失败不继续安装
提示部署目录已存在 保留现场目录,使用手动升级
数据库连接失败 核对地址、端口、账户权限和 TLS;Docker 别名须接入同一网络
healthy 但授权未生效 查看第 6 节业务日志,连接检查与容器健康不等于业务验收
名称或版本显示 null 旧上传协议问题已在 3.1.4 修复,升级到当前版本;旧 null 记录由管理员核对处理
很久未再次上报 检查间隔是否仍为 1440(每天一次);改为 10 后按第 6 节重启
自动升级没有输出 检查定时器、运行版本及升级日志;无新任务、已处理地址或锁占用可能静默退出
首次下载成功,升级报 HTTP 406 按第 6 节手动升级到 3.1.6 或更高版本
其他 HttpRequestException 分别核对查询接口和文件下载阶段的状态码、DNS、网络、TLS;旧脚本网络修复见下方
HTTPS 证书错误 核对时间、证书域名和信任链,不使用 curl -k 绕过
数据库连接失败:查看检测报告

作用:重新检查授权中心和数据库连接,不写业务表。

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 的下载类型。

服务器 CPU 下载类型编码 3.1.6 发布包
x86_64 / Intel / AMD HitekAuthClientDockerAmd64 hitek-auth-client-3.1.6-linux-amd64-upload.zip
aarch64 / ARM64 / 鲲鹏 HitekAuthClientDockerArm64 hitek-auth-client-3.1.6-linux-arm64-upload.zip

配置、data、cache、logs 持久化挂载;日志自动滚动,备份和升级归档由管理员按保留策略清理,不删除运行目录。服务器重启恢复需确认 Docker 开机启动并实际验收。

x64 容器和 ARM64 模拟环境已有测试记录;CentOS 7、麒麟及鲲鹏实机、现场数据库、systemd 和整机重启仍需现场验收。

返回页首 ↑