在企业使用Synology NAS进行数据备份时，ABB Agent（Active Backup for Business Agent）是连接NAS与客户端设备、实现高效备份的核心组件。很多时候，用户需要远程管理NAS或批量部署多台设备，此时图形界面操作效率低，通过命令行安装ABB Agent更便捷。但该操作需满足DSM版本要求、开启SSH服务，且需掌握基础命令语法，不少用户因步骤不清晰导致安装失败。本文将从前提环境准备、SSH连接配置、命令行安装全步骤，到常见故障排查，为你提供 step-by-step 指导，帮你高效完成Synology ABB Agent的命令行安装。

一、前提环境：安装前必须满足的4个核心条件

命令行安装ABB Agent并非适用于所有Synology NAS环境，需先确认以下4个条件是否达标，避免操作中断。

1. DSM版本要求：需DSM 7.0及以上

ABB Agent的命令行安装仅支持 DSM 7.0或更高版本，低于该版本的NAS（如DSM 6.2）需先升级系统，否则无法兼容安装包。 

- 升级方法：登录DSM管理界面 → 进入“控制面板”→ 选择“更新和还原”→ 点击“更新设置”→ 选择“手动下载最新版本”（或开启“自动更新”）→ 按提示完成升级（升级前建议备份NAS数据，防止意外丢失）。 

- 版本验证：升级后可在“控制面板”→“信息中心”→“常规”中，查看“DSM版本”是否满足7.0+要求。

2. 开启DSM SSH服务（关键步骤）

命令行操作需通过SSH协议连接NAS，默认情况下DSM的SSH服务未启用，需手动开启： 

1. 登录DSM图形界面，进入“控制面板”→ 在左侧导航栏找到“终端机和SNMP”→ 点击进入设置界面； 

2. 在“终端机”标签页中，勾选“启用SSH服务”； 

3. 确认SSH端口（默认22，若需自定义，可修改为1024-65535之间未被占用的端口，如2222，后续连接需用新端口）； 

4. 点击页面底部“应用”，系统弹出“服务将立即启动”提示，点击“确定”，SSH服务正式启用。

3. 管理员权限账号（需root权限）

安装ABB Agent需执行系统级命令，必须使用属于“administrators”群组的账号（如默认admin账号），且后续需切换为root用户。普通用户无权限执行安装、服务启停等操作，若当前账号为普通用户，需先在“控制面板”→“用户与群组”中，将其加入“administrators”群组。

4. 存储空间要求：至少500MB空闲空间

ABB Agent安装包大小约100-300MB（因NAS架构不同而异），加上运行依赖文件，需确保NAS目标分区（通常为/volume1）有 至少500MB空闲空间。 

- 空间查看：进入DSM“存储管理器”→ 查看“卷”列表中目标卷的“可用空间”，若不足需清理无用文件（如旧备份、日志）。

二、核心步骤：通过命令行安装ABB Agent的6个关键操作

满足前提条件后，即可通过SSH工具连接NAS，执行命令行安装。以下以Windows系统用PuTTY连接为例（Mac/Linux可直接用终端，步骤一致），详细说明每一步操作。

步骤1：准备SSH连接工具并连接NAS

1. 工具选择：Windows用户推荐使用PuTTY（免费）、Xshell；Mac/Linux用户直接打开“终端”即可，无需额外安装工具； 

2. 以PuTTY为例，打开工具后，在“Session”界面配置连接参数： 

- Host Name（或IP地址）：输入Synology NAS的局域网IP（如192.168.1.100），若需外网连接，输入NAS的外网域名； 

- Port：输入DSM中设置的SSH端口（默认22，若自定义则填修改后的端口，如2222）； 

- Connection type：选择“SSH”； 

3. 点击“Open”，首次连接会弹出“PuTTY Security Alert”提示，点击“是”确认； 

4. 在弹出的命令行窗口中，输入DSM管理员账号（如admin），按Enter后输入对应密码（输入时密码不显示，输完直接按Enter），成功登录后会显示NAS的命令行提示符（如“admin@Synology:~$”）。

步骤2：切换为root用户（获取最高权限）

安装ABB Agent需root权限，登录后需执行命令切换用户： 

1. 在命令行输入以下命令，按Enter： 

```bash

sudo -i

``` 

2. 系统会提示输入当前管理员账号的密码（即步骤1中登录的密码），输入后按Enter，成功切换后，命令行提示符会从“admin@Synology:~$”变为“root@Synology:~”，表示已获取root权限（后续所有命令均需在root权限下执行）。

步骤3：查看NAS架构，下载匹配的ABB Agent安装包

ABB Agent安装包需与NAS的CPU架构匹配（如x86_64、armv8），若下载错误会导致安装失败，需先查看架构再下载。

（1）查看NAS架构

在root权限命令行中输入以下命令，按Enter： 

```bash

uname -m

``` 

执行后会显示架构信息，常见类型及对应安装包后缀如下表：

| NAS架构（uname -m输出） | 对应ABB Agent安装包后缀       | 适用NAS型号举例               |

|--------------------------|--------------------------------|--------------------------------|

| x86_64                   | _x86_64.deb                    | DS920+、DS1621+、RS822+        |

| armv8                    | _armv8.deb                     | DS220j、DS423+、DS120j         |

| aarch64                  | _armv8.deb（与armv8通用）      | DS723+、DS923+                 |

（2）下载ABB Agent安装包

1. 打开浏览器，访问Synology官方下载中心（https://www.synology.com/zh-cn/support/download），在搜索框输入NAS型号（如DS920+），进入对应型号的下载页面； 

2. 在“套件”分类中找到“Active Backup for Business Agent”，根据步骤3（1）获取的架构，下载对应版本的.deb安装包（如x86_64架构下载“abba-agent_x86_64.deb”）； 

3. 复制下载链接（部分浏览器可右键“复制链接地址”），回到NAS命令行窗口，使用`wget`命令下载安装包（若NAS未安装wget，需先执行`apt-get install wget -y`安装）： 

```bash

替换为实际下载链接，示例为x86_64架构包

wget https://global.download.synology.com/download/Package/ActiveBackupBusinessAgent/2.5.0-1072/DSM7.0/abba-agent_x86_64.deb

``` 

4. 下载完成后，执行`ls`命令，若能看到下载的.deb文件（如abba-agent_x86_64.deb），表示下载成功。

步骤4：执行安装命令，部署ABB Agent

1. 在命令行中，输入以下安装命令（将“abba-agent_x86_64.deb”替换为实际下载的文件名）： 

```bash

dpkg -i abba-agent_x86_64.deb

``` 

2. 执行后系统会显示安装进度，若出现“Setting up abba-agent (x.x.x-xxx) ...”提示，且无“error”字样，说明安装过程无异常； 

3. 若提示“依赖关系问题”（如“depends on xxx but it is not installed”），需先修复依赖，执行以下命令： 

```bash

apt-get -f install -y

``` 

修复完成后，重新执行`dpkg -i`安装命令。

步骤5：验证安装是否成功（2种方法）

安装完成后需验证Agent是否正常运行，避免后续备份时出现服务未启动的问题，推荐2种验证方法：

方法1：查看ABB Agent服务状态

执行以下命令，查看服务是否处于“active (running)”状态： 

```bash

systemctl status abba-agent

``` 

- 若输出中显示“active (running)”（绿色字体），表示服务正常运行； 

- 若显示“inactive (dead)”，需执行`systemctl start abba-agent`启动服务，并执行`systemctl enable abba-agent`设置开机自启。

方法2：查看ABB Agent版本

执行以下命令，确认Agent已正确安装并能识别版本： 

```bash

abba-agent --version

``` 

执行后会显示版本信息（如“abba-agent 2.5.0-1072”），表示安装成功。

步骤6：关闭SSH服务（可选，提升安全性）

若仅临时安装Agent，无需后续命令行操作，可关闭SSH服务避免安全风险： 

1. 回到DSM图形界面，进入“控制面板”→“终端机和SNMP”； 

2. 取消勾选“启用SSH服务”，点击“应用”，SSH服务即关闭。

三、特殊场景：批量部署多台NAS的ABB Agent

若企业需在10台以上Synology NAS中安装ABB Agent，逐一手动操作效率低，可通过“脚本批量执行”简化流程，核心思路如下：

1. 准备批量脚本：在本地电脑创建Shell脚本（如install_abba.sh），包含切换root、下载、安装、验证的完整命令（需将安装包链接替换为通用架构包，或按架构分类脚本）； 

2. 批量SSH连接：使用工具（如Ansible、PuTTY批量工具）同时连接多台NAS，确保所有设备已开启SSH且账号权限一致； 

3. 执行脚本：将本地脚本上传到所有NAS的同一目录（如/tmp），通过批量命令执行`bash /tmp/install_abba.sh`，完成批量安装； 

4. 统一验证：批量执行`systemctl status abba-agent`，检查所有设备的Agent服务状态，确保无异常。

四、常见问题排查：安装失败的5种典型原因与解决方法

很多用户在命令行安装时会遇到报错，以下是5种高频问题的诊断与解决方案：

1. 问题1：执行`sudo -i`提示“permission denied”（权限不足）

- 原因：当前登录账号未加入“administrators”群组，无sudo权限； 

- 解决：登录DSM图形界面→“控制面板”→“用户与群组”→选中当前账号→点击“编辑”→“所属群组”→勾选“administrators”→“确定”，重新SSH登录后执行命令。

2. 问题2：`wget`命令提示“command not found”

- 原因：NAS未安装wget工具； 

- 解决：执行`apt-get install wget -y`，等待安装完成后，重新执行下载命令。

3. 问题3：安装时提示“architecture not supported”（架构不支持）

- 原因：下载的安装包与NAS架构不匹配（如armv8架构用了x86_64的包）； 

- 解决：重新执行`uname -m`确认架构，到Synology官网下载对应架构的安装包，替换文件名后重新安装。

4. 问题4：服务启动提示“failed to start abba-agent.service”

- 原因：安装包损坏或依赖未修复； 

- 解决：1. 执行`dpkg -r abba-agent`卸载已安装的损坏包；2. 重新下载安装包；3. 执行`apt-get -f install -y`修复依赖；4. 重新安装并启动服务。

5. 问题5：SSH连接提示“Connection refused”（连接被拒绝）

- 原因：DSM未开启SSH服务，或端口被防火墙拦截； 

- 解决：1. 确认DSM“终端机和SNMP”中已启用SSH；2. 检查NAS防火墙（“控制面板”→“安全性”→“防火墙”）是否允许SSH端口（如22）的入站连接；3. 若外网连接，确认路由器已做端口转发（SSH端口映射）。

五、总结：命令行安装ABB Agent的核心要点

通过命令行安装Synology ABB Agent，核心优势是“远程便捷、批量高效”，但需牢记3个关键要点： 

1. 版本与权限是前提：DSM必须7.0+，且需用管理员账号切换root权限； 

2. 架构匹配是关键：通过`uname -m`确认架构，下载对应安装包，避免安装失败； 

3. 验证步骤不可少：安装后需通过服务状态和版本查看，确保Agent正常运行，为后续备份打下基础。

若在操作中遇到官网文档未覆盖的问题，可访问Synology官方技术支持（https://www.synology.com/zh-cn/support）提交工单，获取针对性帮助。

要不要我帮你整理一份Synology ABB Agent命令行安装速查手册？手册会汇总所有核心命令（含切换root、下载、安装、验证）、架构与安装包对应表，及常见问题的“问题-解决”对照表，方便你直接复制命令操作，无需反复查阅长文。