UniFi Drive 支持将 UNAS 数据备份到多个目的地，包括另一台 UNAS 设备、SMB/CIFS 服务器或云服务（如 Google Drive、OneDrive、Dropbox、Amazon S3、Backblaze B2、Wasabi）。同时支持将 Microsoft 365 OneDrive 数据备份到 UNAS。这些选项有助于实现 3-2-1 备份策略，提高数据保护能力。

要创建备份任务，请前往 Drive > 备份任务 > 创建备份任务。

UNAS 数据备份到其他目的地

1. 问题 1：备份过程中出现文件冲突
   • 可能原因：备份运行时文件被修改（例如，Time Machine 正在运行）。
   • 解决方法：
   • 避免在备份期间修改文件。
   • 在备份前暂停 Time Machine 或类似服务。
2. 问题 2：目标文件名无效
   • 可能原因：某些系统不接受包含特殊字符的文件（例如，Synology 下的 @eadir，QNAP 下的 .@__thumb）。
   • 解决方法：使用 全部文件 视图定位并重命名有问题的文件。参考各系统文件命名规范：
   • Synology
   • Dropbox
   • OneDrive
3. 问题 3：控制台名称更改导致备份暂停
   • 可能原因：为防止重复条目，控制台名称更改时备份会暂停。
   • 解决方法：
   • 会弹出提示引导你重命名备份文件夹。
   • 在备份目的地找到文件夹“UniFi Drive_[旧控制台名称]”：
   • UNAS 或 SMB/CIFS 服务器：你的目标文件夹 > UniFi Drive_[旧控制台名称]
   • Google Drive：我的云端硬盘 > UniFi Drive_[旧控制台名称]
   • OneDrive：我的文件 > UniFi Drive_[旧控制台名称]
   • Dropbox：全部文件 > 应用 > UniFi Drive 备份 > UniFi Drive_[旧控制台名称]
   • 将该文件夹重命名为“UniFi Drive_[新控制台名称]/[新控制台名称]_[任务名称]”。
     • 如果同名文件夹已存在，请在 UNAS 中更改任务名称避免冲突。
   • 返回 UNAS 备份任务，点击 忽略并恢复备份。
4. 问题 4：区分大小写的文件名冲突
   • 可能原因：如果源文件夹内有仅大小写不同的文件（如 test.txt 和 Test.txt），向另一台 UNAS 或 CIFS/SMB 服务器备份时，只有其中一个会被备份。
   • 解决方法：
   • 备份前重命名文件，消除仅大小写的差异。
   • 如果出现部分成功提示，找到并重命名冲突文件后重试备份。
5. 问题 5：加密驱动器上的文件或文件夹路径过长
   • 可能原因：两台 UNAS 之间进行异地备份时，如果备份到加密驱动器且文件路径超过 143 个字符，会因加密路径长度限制而失败。
   • 解决方法：
   • 缩短源文件夹或文件名，确保总路径长度在 143 字符以内。
   • 如需避免此限制，可选择未加密的驱动器作为备份目标。
6. 问题 6：远程备份时出现“服务器连接失败”错误
   • 描述：尝试两台 UNAS 之间远程备份时出现“服务器连接失败”错误，表示本地系统无法连接远程服务器。
   • 可能原因：
   • 网络不可达：远程 UNAS 离线或无法访问。
   • VPN 未连接：VPN 或 Site Magic 未激活或配置错误。
   • IP 冲突：本地与远程 UNAS 使用相同 LAN 子网（如 192.168.1.x），导致 VPN 无法路由。
   • SMB 已禁用：远程 UNAS 未开启 SMB 服务或权限配置错误。
   • 解决方法：
   • 检查网络与 VPN：
   • 确保两台 UNAS 均在线并可访问。
   • 在本地网络中 ping 远程 UNAS。
     • 在 Site Manager > UniFi Console > 设置 > 控制面板 > 控制台 > 高级 > SSH 中启用 SSH 并记住 SSH 密码。
     • 在连接到 UniFi Console 网络的电脑上运行以下命令：
       • 将 UNIFI_GATEWAY_LAN_IP 替换为你控制台的 LAN IP。
       • 将 UNAS_IP 替换为问题设备的实际 IP。

       ssh root@UNIFI_GATEWAY_LAN_IP
       ping UNAS_IP

   • 确认 Site Magic 或 VPN 状态为“已连接”。
   • 检查 IP 配置：本地与远程 UNAS 使用不同子网（如 192.168.1.x/192.168.11.x）避免冲突。
   • 检查 SMB 服务与权限：
     • 确保远程 UNAS 开启 SMB 服务。
     • 确认远程访问权限已正确设置。
7. 问题 7：控制台名称变化未体现在 Amazon S3、Backblaze B2 或 Wasabi 备份任务中
   • 描述：如果你重命名控制台，在 Amazon S3、Backblaze B2、Wasabi 的备份任务中，文件夹或对象名称不会改变。
   • 原因：这些云存储服务不支持已创建文件夹或对象的重命名，因此目标端会一直保留任务创建时的控制台名称。
   • 结果：备份任务会正常运行，不影响功能与数据完整性。

   详见 UNAS 数据备份到 Amazon S3、Backblaze B2、Wasabi 的最佳实践文章。
8. 问题 8：远程备份时出现“Backblaze B2 transaction cap exceeded”错误
   • 描述：在设置或运行备份到 Backblaze B2 时出现“Backblaze B2 transaction cap exceeded. Please update your cap settings or try again tomorrow.”错误。
   • 原因：该错误表示您的 Backblaze B2 账户的 24 小时 API 事务总数已超出配额，Backblaze 通过事务上限来管理成本与 API 使用。事务包括：
   • 应用密钥连接
   • 创建或列举存储桶
   • 上传单个文件（b2_upload_file）
   • 列举文件或获取元数据
   • 常见触发情形：
   • 权限错误或存储桶名错误导致频繁重试
   • 单个任务上传大量小文件
   • 同一账户下多个任务使用不同应用密钥，共享配额
   • 频繁自动备份（如每小时增量备份）
   • 解决方法：
   • 等待每日重置：配额每 24 小时（UTC）重置，任务在重置后会自动重试。
   • 提高事务配额：如使用付费 B2 方案，可在 Backblaze 控制台 Caps & Alerts 中提升 每日事务上限。
9. 问题 9：因文件名冲突导致 USB 备份（exFAT/FAT32）失败
   • 描述：本地备份到 exFAT 或 FAT32 格式的 USB 设备时，任务可能以“部分成功”状态完成并返回错误码 “E_FAILED”。通常源文件夹中存在仅大小写不同的文件（如 Photo.jpg 和 photo.jpg）时会出现。
   • 原因：exFAT 和 FAT32 属于大小写不敏感文件系统，会将不同大小写的文件名视为同一个。
   • 解决方法：
   • 在 UNAS 的共享盘内将冲突文件重命名，保证文件名无论大小写都唯一。
   • 如条件允许，建议将 USB 盘格式化为支持大小写敏感且与 UNAS 完全兼容的 ext4 文件系统。
10. 问题 10：USB 备份不保留扩展属性（xattr）
    • 描述：将数据备份到外部 USB 设备时，拓展属性（xattr，例如文件标签或应用元数据）不会被保留，但任务仍会以“成功”状态完成。
    • 原因：
    • 兼容性考虑：USB 设备常在不同操作系统（Windows、macOS、Linux）间使用，各自对 xattr 的处理不同。为确保文件跨平台可访问，UniFi Drive 优先保障核心文件数据。
    • 系统专用元数据：扩展属性主要供 UNAS 内部功能（如索引）使用，普通文件访问并不需要。
    • 结果：文件本身不受影响但部分元数据（如标签、索引信息）在备份后将不再保留。
11. 问题 11：加密目标导致文件名长度限制备份失败
    • 描述：备份到加密共享文件夹或加密目标时，如果文件名（包括扩展名）超过允许长度，任务会失败。
    • 原因：加密文件系统需要额外空间存储元数据。标准 Linux 系统（Btrfs/ext4）文件名最长支持 255 字符，但加密层通常限制在大约 140 - 143 字符。
    • 解决方法：
    • 将源文件重命名，确保文件名（含后缀）远小于 140 字符，以预留加密开销和备份临时后缀。
    • 如需使用长文件名，建议选用支持 255 字符限制的非加密目标。
12. 问题 12：备份进度停留在 100%
    • 描述：本地备份任务过程中，进度条可能达到 100% 后长时间无变化，同时系统负载较高但 UI 无明显进展。
    • 原因：如遇某些文件出现错误（如目标端加密导致文件名过长或网络暂时异常），系统会自动重试。每次重试都需要重新扫描与比对全部文件，以保证数据完整性。若备份源有大量小文件（如几万个），此过程会耗时较长。
    • 解决方法：
    • 耐心等待处理完成，无需手动干预。重试时中止任务可能导致备份不完整。
    • 检查文件名与日志：如有“文件名过长”或大小写冲突等错误，建议缩短文件名或排查命名冲突，可减少重试提升速度。
13. 问题 13：某些远程 rsync 服务器无法向 UNAS 备份
    • 描述：用其它 NAS 或服务器通过 rsync 推送备份到 UniFi Drive 时，可能出现：
    • 连接失败
    • 任务卡住或超时，即使文件列表可见
    • 原因：部分设备仅支持基于 SSH 的 rsync，这与 UniFi Drive 要求不兼容。UniFi Drive 需要使用带有安全策略的 rsync 守护进程模式，包括：
    • 路径隔离：备份用户只能访问分配的备份文件夹
    • 无 shell 访问权限：防止通过备份连接在 NAS 上执行命令
    • 结果：连接可能部分可用（如能列出文件），但数据传输时失败或超时。
    • 解决方法：
    • 在源设备上：确保启用 rsync 守护进程服务（通常端口 873）。
    • 在 UniFi Drive 中：
    • 前往备份任务 > 创建备份任务 > 本地备份 > rsync
    • 输入源设备信息
    • 选择传输加密为 守护进程模式
    • 连接并选择要备份的文件夹
    • 创建任务

最佳实践

1. 如何在备份时保留硬链接和稀疏文件？
   • 迁移大型数据集或系统备份时，如用到硬链接（多个文件名指向同一个数据）或稀疏文件，建议保留原始存储结构以避免额外空间占用。
   • 为保证数据完整性及存储高效，可使用 UniFi Drive 的 rsync 引擎（支持保留硬链接和稀疏文件）。可根据需求选择：
     • 拉取数据到 UniFi Drive。前往备份任务 > 创建备份任务 > rsync，配置从你的 rsync 源服务器拉取数据。
     • 允许远程服务器从 UniFi Drive 拉取数据。在设置 > 服务中启用 rsync 服务，然后由远端服务器发起以 UniFi Drive 为源的备份。

Microsoft 365 OneDrive 备份至 UNAS

故障排查

1. 问题 1：租户设置在授权阶段失败
   • 描述：租户在 UniFi Drive 初次连接或授权时设置失败。
   • 可能原因：
     • Microsoft Entra ID 安全策略：已启用 阻止应用中的新密码凭据，阻止了认证。
     • 网关限制：UniFi Gateway 上区域封锁或广告拦截阻止访问 Microsoft 认证端点。
   • 解决方法：
     • 以全局管理员身份登录 Microsoft Entra 管理中心，临时关闭 阻止应用中的新密码凭据 设置。
     • 确保 UniFi Gateway 未封锁 Microsoft 服务需用的区域或端口。
     • 返回 UniFi Drive 完成设置。
2. 问题 2：安全组未恢复
   • 可能原因：Microsoft 365 安全组用于访问控制（如 SharePoint、OneDrive、Teams 与管理角色），通常无关联邮箱。因此依赖邮箱识别的权限无法恢复。
   • 解决方法：还原数据后手动重新分配权限。后续建议采用支持邮箱与权限恢复的 Microsoft 365 群组。
3. 问题 3：部分用户未被备份
   • 可能原因：
     • 无许可证用户：未购买 Microsoft 365 许可的账号不会被备份。
     • 来宾账户：外部来宾账号不会被纳入备份范围。
     • OneDrive 未初始化：用户若从未登录 OneDrive 网页端，个人存储（Personal Site）可能未创建。
   • 解决方法：
     1. 核实许可证与账号类型
        1. 确认用户拥有有效的 Microsoft 365 商业版或企业版许可证。
        2. 确保账号为内部用户（非 Guest）。
     2. 初始化 OneDrive
        1. 让用户至少登录一次 OneDrive 网页端。
        2. 确认其文件和文件夹均可见。
     3. 重试备份
        1. 等待 5-10 分钟，让 Microsoft 服务同步。
        2. 刷新用户列表，或在 UniFi Drive 重新运行备份任务。