Nextcloud AIO 远程 Borg 备份在 Synology NAS 上的解决方案

问题背景

在使用 Nextcloud All-in-One (AIO) 容器化部署方案时，许多用户会选择配置远程 Borg 备份功能，将数据备份到外部存储设备。当目标设备是 Synology NAS 时，可能会遇到 Borg 备份初始化失败的问题，错误提示显示"borg: command not found"。

问题分析

这个问题的根源在于 Synology 系统的特殊路径配置。通过 SynoCommunity 软件包安装的 Borg 备份工具会被放置在非标准路径：

1. 标准 Borg 安装路径：/usr/bin/borg
2. Synology 实际安装路径：/usr/local/bin/borg

当 Nextcloud AIO 容器尝试通过 SSH 连接到 Synology NAS 执行 Borg 命令时，系统默认在标准路径中查找 Borg 可执行文件，导致命令无法找到。

解决方案

方法一：创建符号链接（推荐）

1. 登录 Synology DSM 管理界面
2. 打开"控制面板" → "任务计划"
3. 创建新任务，选择"用户定义的脚本"
4. 在脚本内容中输入：

   ln -s /usr/local/bin/borg /usr/bin/borg
   

5. 设置任务以 root 权限运行
6. 立即执行该任务

此方法创建了一个从标准路径指向实际安装位置的符号链接，使系统能够在标准路径下找到 Borg 命令。

方法二：修改环境变量（备选）

对于高级用户，也可以通过修改 SSH 环境变量来指定 Borg 的正确路径：

1. 编辑 Synology 上的 ~/.ssh/environment 文件（如不存在则创建）
2. 添加以下内容：

   PATH=$PATH:/usr/local/bin
   

3. 修改 SSH 配置，允许环境变量传递：
   • 编辑 /etc/ssh/sshd_config
   • 确保包含 PermitUserEnvironment yes
   • 重启 SSH 服务

验证解决方案

完成上述任一方法后，可以通过以下方式验证：

1. 从任意客户端通过 SSH 连接到 Synology NAS：

   ssh username@nas_ip -p port_number "borg --version"
   

2. 应该能够正确显示 Borg 版本信息，而非"command not found"错误
3. 在 Nextcloud AIO 界面重新尝试配置远程 Borg 备份

技术原理

这个问题的本质是 Linux 系统的 PATH 环境变量配置问题。当通过 SSH 执行远程命令时，系统会使用最小化的环境变量集，通常不包括 /usr/local/bin 路径。通过创建符号链接或修改环境变量，我们确保了系统能够在标准搜索路径中找到 Borg 可执行文件。

注意事项

1. 使用符号链接方法时，确保 Synology 系统更新不会覆盖此修改
2. 定期检查 Borg 备份是否正常运行
3. 对于生产环境，建议先在小规模测试环境中验证解决方案
4. 确保 SSH 密钥认证已正确配置，Nextcloud AIO 生成的公钥已添加到 Synology 的 authorized_keys 文件中

通过以上步骤，Nextcloud AIO 应该能够成功地将数据备份到 Synology NAS 上的 Borg 存储库，实现可靠的远程备份解决方案。