ABB Linux Agent 快速上手：安装、连 NAS、跑第一次备份
把 ABB Linux Agent 的最短路径单独拎出来：系统版本要求、依赖安装、连接 NAS、手动触发备份与还原验证，适合第一次部署时照着做。
教程介绍Synology Active Backup for Business在Linux系统上的备份还原操作，包括系统要求、依赖安装和操作步骤。
#Synology ABB#Linux备份#备份还原#系统要求#依赖安装一、概述 — 本教程适用场景
本教程面向使用 Synology Active Backup for Business (ABB) 的 Linux 客户端，涵盖以下核心场景：
| 场景 | 说明 |
|---|---|
| 首次安装 | 在 Linux 主机上安装 ABB Agent 并连接到 NAS |
| 手动备份 | 通过 CLI 手动触发备份任务，将指定目录/文件备份到 NAS |
| 还原文件 | 从 NAS 的备份快照中还原指定文件或目录到本地 |
| 整机还原 | 在新机器或故障恢复时，通过 ABB 任务还原整台 Linux 主机 |
| 计划任务 | 配合 DSM 端策略实现定时自动备份 |
二、系统要求与前置准备
2.1 支持的系统
- Debian 10 – 12 (buster / bullseye / bookworm)
- Ubuntu 16.04 – 24.04 (x86_64)
2.2 必需依赖
| 依赖 | 最低版本 | 用途 | 安装命令 |
|---|---|---|---|
linux-headers | 匹配当前内核 | 编译内核模块 | sudo apt install linux-headers-$(uname -r) |
make | ≥ 4.1 | 构建工具 | sudo apt install make |
dkms | ≥ 2.2.0.3 | 动态内核模块支持 | sudo apt install dkms |
gcc | ≥ 4.8.2 | C 编译器 | sudo apt install gcc |
2.3 一键安装全部依赖
$ sudo apt update $ sudo apt install -y linux-headers-$(uname -r) make dkms gcc2.4 验证依赖是否就绪
$# 检查内核版本$ uname -r 6.8.0-138-generic$# 检查 make 版本$ make --version | head -1 GNU Make 4.3$# 检查 dkms 版本$ dkms --version dkms-2.8.7$# 检查 gcc 版本$ gcc --version | head -1 gcc (Ubuntu 11.4.0-1ubuntu1~22.04.3) 11.4.0$# 检查内核头文件是否已安装$ dpkg -l | grep linux-headers-$(uname -r) ii linux-headers-6.8.0-138-generic amd64 6.8.0-138.142 ... 提示：如果
linux-headers 安装失败，请先执行 sudo apt update 更新软件源后再试。 三、安装 ABB Agent
3.1 获取安装包
从 Synology 官网下载 Linux 版 ABB Agent 安装包（.run 文件），或从 NAS 的 Active Backup for Business → 计算机 → 新增 → Linux 页面下载。
3.2 安装步骤
进入安装包所在目录：
$ cd /path/to/download赋予可执行权限：
$ chmod +x install.run以 root 权限执行安装：
$ sudo ./install.run验证安装是否成功（确认服务已安装）：
$ dpkg -l | grep synology-active-backup ii synology-active-backup-business-linux-service 2.0.0-xxxx ...$# 检查 abb-cli 是否可用$ which abb-cli /usr/bin/abb-cli 注意：安装完成后会自动启动
abb-service 服务。如果安装失败，请检查依赖是否完整安装。 3.3 卸载方式（备用）
# 卸载备份服务$ sudo dpkg -r synology-active-backup-business-linux-service # 卸载 Agent 引擎（synosnap）$ sudo dpkg -r synosnap四、连接到 Synology NAS
4.1 基本连接（交互式）
首次连接时会提示输入 NAS 地址、用户名和密码：
$ sudo abb-cli -c Please input NAS address: 192.168.1.10Please input username: nasadminPlease input password: ********Connected successfully.4.2 直接指定参数连接
$ sudo abb-cli -c -a 192.168.1.10 -u nasadmin -p YourPassword123| 参数 | 说明 |
|---|---|
-a, --address | NAS 的 IP 地址或域名 |
-u, --username | NAS 登录用户名 |
-p, --password | NAS 登录密码 |
-q, --quiet | 静默模式，不输出过程信息 |
4.3 通过代理连接（可选）
$ sudo abb-cli -c \ -a 192.168.1.10 \ -u nasadmin \ -p YourPassword123 \ --proxy-address 10.0.0.1 \ --proxy-port 8080 \ --proxy-username proxyuser \ --proxy-password proxypass4.4 验证连接状态
$ sudo abb-cli -c Already connected 说明：
Already connected 表示 Agent 已经和 NAS 保持连接，可以直接进行备份/还原操作。连接信息保存在 /etc/synology_abb.conf。 4.5 断开连接
$ sudo abb-cli -d五、查看 Agent 与备份信息
abb-cli -i查看客户端信息（NAS IP、连接状态等）abb-cli -s显示当前服务运行状态abb-cli -l列出当前已创建的备份任务abb-cli -v显示 Agent 版本号abb-cli -h显示完整帮助信息abb-cli -e导出 Agent 日志abb-cli -e --output-file /tmp/abb.log将日志导出到指定文件abb-cli -r重新加载服务配置查看备份任务详情示例
$ sudo abb-cli -l Task ID: 1 Task Name: daily-home-backup Source: /home Destination: NAS Status: Completed Last Backup Time: 2026-08-24 23:00:00六、执行备份操作
6.1 备份方式概览
ABB 支持两种备份触发方式：
| 方式 | 操作位置 | 说明 |
|---|---|---|
| DSM 策略备份 | NAS Web UI | 在 Active Backup for Business 中创建备份任务，设定计划策略（推荐） |
| CLI 手动触发 | Linux 客户端 | 通过命令行手动发起即时备份 |
6.2 通过 DSM 创建备份任务（推荐）
登录 NAS DSM → 打开 Active Backup for Business
进入 计算机 → 找到已注册的 Linux 客户端 → 点击 新增
选择备份来源（目录/卷），设置排除规则和计划任务
客户端只需保持 abb-cli -c 连接状态，备份任务会在计划时间自动执行
6.3 CLI 手动触发备份
如果需要立即执行备份（而非等待计划），可以使用以下命令：
# 在客户端上手动触发备份（备份任务需已创建）$ sudo abb-cli --run-task <task_id> # 例如：立即执行 task_id=1 的备份任务$ sudo abb-cli --run-task 1 Backup task started successfully.6.4 备份完成后查看结果
# 查看备份状态$ sudo abb-cli -l Task ID: 1 | Status: Completed | Time: 2026-08-25 10:30:00# 导出详细日志用于排查$ sudo abb-cli -e --output-file /tmp/backup-log.txt 说明：备份数据通过 TCP 4444 端口传输到 NAS，NAS 端自动进行重复数据删除（Single Instance Storage），节省存储空间。
七、还原操作 — 文件级还原
7.1 在 DSM 中浏览备份快照
登录 NAS DSM → 打开 Active Backup for Business
进入 计算机 → 找到目标 Linux 客户端 → 点击 浏览
选择要还原的备份版本（快照时间点）
勾选要还原的文件/目录 → 点击 还原
7.2 通过 Web Station 下载还原
DSM 也支持通过浏览器直接下载备份文件到本地：
在 DSM 备份浏览界面 → 选择文件 → 点击 下载
下载到本地后，通过 scp 或其他方式传输到 Linux 客户端
7.3 还原到原始位置
在 DSM 备份浏览界面 → 勾选文件 → 选择 还原到原始位置
确认覆盖选项 → Agent 会自动将文件还原到 Linux 客户端对应路径
注意：还原到原始位置会覆盖现有文件。请确保当前没有程序正在使用目标文件，建议在维护窗口内操作。
八、整机还原（灾难恢复）
当 Linux 主机发生硬件故障或系统崩溃时，可以通过 ABB 进行整机还原：
8.1 还原流程
准备新机器/修复硬件 → 安装 Ubuntu/Debian 基础系统 → 安装 ABB Agent → 连接 NAS → 执行整机还原8.2 详细步骤
准备一台新的 Linux 机器，安装相同版本的操作系统（Ubuntu 22.04 等）
安装 ABB Agent（参照第三部分）：
$ sudo apt update $ sudo apt install -y linux-headers-$(uname -r) make dkms gcc $ sudo chmod +x install.run $ sudo ./install.run连接到 NAS：
$ sudo abb-cli -c -a 192.168.1.10 -u nasadmin -p YourPassword123 Connected successfully.在 DSM 中执行整机还原：
- 打开 Active Backup for Business → 计算机
- 选择目标客户端 → 点击 还原
- 选择 整机还原（Bare-metal Restore）
- 选择要还原的备份版本
- 选择目标磁盘 → 开始还原
还原完成后重启，系统将恢复到备份时的状态：
$ sudo reboot 重要：整机还原会覆盖目标磁盘上的所有数据。请确保目标磁盘上没有需要保留的数据，或提前做好备份！
九、日志与故障排查
9.1 查看日志
# Agent 日志文件$ cat /var/log/synology_abb.log # 使用 journalctl 查看服务日志$ journalctl -u abb-service -f # 导出完整日志到文件$ sudo abb-cli -e --output-file /tmp/abb-full-log.txt # 查看最近 100 行日志$ tail -100 /var/log/synology_abb.log9.2 常见问题排查
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
abb-cli -c 连接失败 | 网络不通 / 端口被防火墙拦截 | 检查 NAS 的 TCP 4444 端口是否开放；确认防火墙规则 |
| 备份任务无法执行 | 服务未启动 | sudo systemctl start abb-service |
| 安装时编译失败 | 缺少内核头文件 | sudo apt install linux-headers-$(uname -r) |
| 还原文件权限错误 | 当前用户无权限 | 使用 sudo 执行还原操作 |
| 备份速度过慢 | 网络带宽不足 | 检查网络连接；考虑使用千兆/万兆网络 |
9.3 服务管理命令
# 启动 ABB 服务$ sudo systemctl start abb-service # 停止 ABB 服务$ sudo systemctl stop abb-service # 重启 ABB 服务$ sudo systemctl restart abb-service # 查看服务状态$ sudo systemctl status abb-service # 设置开机自启$ sudo systemctl enable abb-service # 取消开机自启$ sudo systemctl disable abb-service9.4 网络安全配置
# 如果使用 ufw 防火墙，允许 ABB 端口$ sudo ufw allow 4444/tcp $ sudo ufw reload # 如果使用 iptables$ sudo iptables -A INPUT -p tcp --dport 4444 -j ACCEPT $ sudo iptables-save > /etc/iptables/rules.v4十、最佳实践与注意事项
| 类别 | 建议 |
|---|---|
| 备份频率 | 建议关键数据每天备份一次，非关键数据每周备份一次 |
| 备份验证 | 定期在 DSM 中浏览备份快照，确认数据完整性 |
| 版本保留 | 在 DSM 备份策略中设置合理的版本保留策略（如保留 30 天） |
| 网络稳定 | 确保备份期间网络稳定，避免中断导致备份失败 |
| 密码管理 | 不要在脚本中硬编码密码，使用环境变量或密钥文件 |
| 监控告警 | 设置 DSM 通知，备份失败时及时收到告警 |
| 日志归档 | 定期导出日志 abb-cli -e 并归档，便于事后审计 |
| 系统更新 | 内核更新后需重新安装 ABB Agent（因为内核模块需要重新编译） |
内核更新后的重装流程
# 1. 更新内核$ sudo apt update && sudo apt upgrade # 2. 安装新内核对应的头文件$ sudo apt install linux-headers-$(uname -r) # 3. 重新安装 ABB Agent$ sudo ./install.run # 4. 验证连接$ sudo abb-cli -c Already connected十一、完整操作速查表
| 操作 | 命令 / 方法 |
|---|---|
| 安装依赖 | sudo apt install -y linux-headers-$(uname -r) make dkms gcc |
| 安装 Agent | sudo ./install.run |
| 连接 NAS | sudo abb-cli -c -a <IP> -u <用户> -p <密码> |
| 断开连接 | sudo abb-cli -d |
| 查看状态 | sudo abb-cli -s |
| 查看任务 | sudo abb-cli -l |
| 手动备份 | sudo abb-cli --run-task <task_id> |
| 导出日志 | sudo abb-cli -e --output-file /tmp/abb.log |
| 还原文件 | DSM → Active Backup → 浏览 → 选择文件 → 还原 |
| 整机还原 | 新机器安装 Agent → 连接 NAS → DSM 执行 Bare-metal Restore |
| 卸载服务 | sudo dpkg -r synology-active-backup-business-linux-service |
| 启动服务 | sudo systemctl start abb-service |
| 查看日志 | tail -100 /var/log/synology_abb.log |
本文整理自郑州鼎益技术资料《LinuxABB备份还原教程》，公开发布前已做脱敏与校订 · 最后校订 2026-11-11