ADX 跨域文件传输系统 · 安装文档

ADX 离线安装包安装指南

本文档对应 Drogon 服务端离线安装包，覆盖 Linux 完全离线安装、升级、回滚、卸载和 Windows 10 服务端运行边界。Qt GUI、b4adxc、sfxc 已退役，不属于当前交付目标。

1. Linux 离线安装

1.1 安装前准备

建议准备一台 Ubuntu 24.04 Server 运行机，并为 ADX 数据目录准备独立数据盘。

默认目录：

执行文件和依赖：`/opt/adx`
数据目录：`/data/adx/<节点编号>`
配置文件：`/opt/adx/conf/adxs.json`
安装状态：`/opt/adx/install-state/installation.json`
日志目录：`/opt/adx/log`

数据盘建议使用 XFS。若当前文件系统不是 XFS，安装器仍允许继续运行，但大文件合并会使用普通合并路径，耗时可能更长。

安装器默认要求数据目录所在分区至少有 500 GiB 可用空间。测试环境可通过 `ADX_OFFLINE_MIN_FREE_KB` 临时降低检查阈值；正式环境不建议降低。

1.2 安装命令

将离线包复制到目标机器后执行：


tar -xzf b4adxs-offline-YYYYMMDD-HHMMSS-<commit>-linux-x86_64.tar.gz
cd b4adxs-offline-YYYYMMDD-HHMMSS-<commit>-linux-x86_64
sudo ./installer/install.sh

安装器会询问或使用以下默认值：

安装目录：`/opt/adx`
数据根目录：`/data/adx`
节点编号：`N1`
企业编号：`C1`
Web 访问端口：`19080`
后端 API 端口：`19019`

无人值守安装可使用环境变量：


sudo ADX_OFFLINE_ASSUME_DEFAULTS=1 \
  ADX_OFFLINE_NODE_ID=N1 \
  ADX_OFFLINE_CORP_ID=C1 \
  ADX_OFFLINE_DATA_ROOT=/data/adx \
  ADX_OFFLINE_HTTP_PORT=19080 \
  ADX_OFFLINE_ADXS_PORT=19019 \
  ./installer/install.sh

如果端口被占用，交互模式会提示重新输入端口；无人值守模式会直接失败，需调整端口后重试。

1.3 安装完成确认

安装完成后，终端会输出浏览器入口、健康检查入口和初始管理员信息。

检查服务：


systemctl status b4adxs-backend.service
systemctl status b4adxs-nginx.service
systemctl status b4adxs-clamav.service

检查健康状态：


curl http://127.0.0.1:19080/api/health

浏览器访问：


http://<服务器地址>:19080/web/

如果使用非默认端口，将 `19080` 替换为安装时选择的端口。

2. 升级

升级使用新版本离线包里的同一个安装脚本。安装器会先停止已有 ADX 服务，保留数据目录，再切换到新 release。


tar -xzf b4adxs-offline-NEW-linux-x86_64.tar.gz
cd b4adxs-offline-NEW-linux-x86_64
sudo ADX_OFFLINE_ASSUME_DEFAULTS=1 ./installer/install.sh

升级后检查：


curl http://127.0.0.1:<Web端口>/api/health
systemctl is-active b4adxs-backend.service b4adxs-nginx.service b4adxs-clamav.service

升级不会主动删除 `/data/adx/<节点编号>` 下的业务数据。

3. 回滚

每次安装或升级前，安装器会记录回滚信息。需要回滚时执行当前包内的回滚脚本：


sudo /opt/adx/current/installer/rollback.sh

回滚后检查：


curl http://127.0.0.1:<Web端口>/api/health
systemctl is-active b4adxs-backend.service b4adxs-nginx.service b4adxs-clamav.service
cat /opt/adx/install-state/installation.json

回滚默认不删除业务数据。

4. 卸载

保留业务数据卸载：


sudo /opt/adx/current/installer/uninstall.sh

清理业务数据卸载：


sudo ADX_OFFLINE_PURGE_DATA=1 /opt/adx/current/installer/uninstall.sh

清理业务数据是不可逆操作，执行前必须确认已完成备份。

5. Windows 10 服务端运行边界

当前验证边界是 Windows 10 干净运行机。Windows 10 环境不依赖 XFS/reflink；大文件分片上传完成后会走普通文件合并路径。

Windows Server、ReFS、Windows 7 属于单独兼容边界，不能由 Windows 10 验收结果自动外推。

Windows 服务端包运行前应确认：

端口未被占用。
数据目录有足够空间。
服务端配置中的节点编号、企业编号、数据目录和端口正确。
不把 Windows 运行包和 Linux 离线包混用。

6. 常见问题

6.1 健康检查失败

先检查服务是否 active：


systemctl is-active b4adxs-backend.service b4adxs-nginx.service b4adxs-clamav.service

再查看日志：


journalctl -u b4adxs-backend.service -n 200 --no-pager
journalctl -u b4adxs-nginx.service -n 200 --no-pager

6.2 Web 页面打不开

确认 Web 端口是否被监听：


ss -ltnp | grep ':19080'

若安装时选择了自定义端口，请使用自定义端口访问。

6.3 数据盘不是 XFS

Linux 正式环境建议挂载 XFS 数据盘到 `/data/adx`。如果不是 XFS，安装器会提示继续运行但使用普通合并路径。大文件场景下性能可能低于 XFS/reflink。

6.4 磁盘空间不足

安装器默认要求数据目录可用空间至少 500 GiB。空间不足时，请扩容或更换 `ADX_OFFLINE_DATA_ROOT`。