> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/zh/nas/volume-syncs.md).

# 卷同步

卷同步可用于在两个卷之间同步数据。卷同步可用作一次性传输或周期性任务，以便按固定计划同步数据。卷同步可以涉及两者 [**远程卷**](/run-the-platform/zh/nas/nas-remote-volumes.md) 和 [**本地卷**](/run-the-platform/zh/nas/nas-local-volumes.md)，从而具备以下能力：

* 轻松将外部文件系统迁移到 VergeOS 存储中。
* 将 VergeOS 用作外部系统按文件级别备份的目标。
* 将数据从 VergeOS NAS 传输到外部存储系统。
* 将 VergeOS 原生 NAS 数据定期备份到另一台 VergeOS 系统或第三方存储。

## 创建卷同步

1. 导航到 **NAS** > **卷同步**.
2. 单击 **新建** 左侧菜单中的。
3. 选择 ***NAS 服务*** （承载待同步卷的 NAS 服务）
4. 请为 ***名称*** 指定一个新卷同步名称。注意：不允许有空格。
5. 选择 ***卷同步*** 在 ***类型*** 下拉列表。
6. 输入一个 ***描述*** 用于该卷同步（可选）。
7. 请指定 ***最大运行时间*** ，方法是输入一个整数并从下拉列表中选择 ***单位*** （小时/天）， **或** 选择 **“Forever”** 在单位字段中设置无限运行时间。
8. 该 ***最大错误数*** 设置将默认为 1000。这将决定同步任务达到多少错误数时会自动中止。
9. Verge.io 同步是默认同步 ***方法***。虽然此方法可能提供更好的性能，但也可以选择 **rsync** 方法，以包含 CIFS 文件权限的同步。
10. 选择 ***目标删除*** 下拉列表中的设置。此设置指定如何处理那些存在于目标端、但（不再）存在于源端的文件。
    * **传输后删除** - 在所有数据传输完成后，文件将从目标端删除；同步操作中的删除部分将额外遍历一次文件系统。
    * **从不删除（默认）** - 文件不会被删除（即使它们在源端已不存在）。
    * **传输前删除** - 在传输数据之前删除文件。
    * **传输后删除（传输中查找）** - 要删除的文件会在传输过程中被查找，但直到数据传输完成后才真正删除。（这不涉及对源数据的多次遍历。）
    * **传输中删除** - 文件在传输过程中遇到时即被删除。
    * **从目标端删除文件** - 文件会以系统自动确定的方式删除。
11. 选择 ***源卷*** 下拉列表中的选项。（可以是本地卷或远程卷。）
12. 请为 ***源起始目录*** （或留空以从根目录同步整个卷）。末尾带斜杠将仅复制目录内容；末尾不带斜杠将按目录名复制该目录。例如：/data/ 将复制 data 文件夹下的所有内容，但不会在目标端创建 data 文件夹；/data 将复制 data 文件夹及其全部内容。
13. 请指定 ***包含文件/目录*** （可选），用于仅同步特定文件、目录和/或文件模式。示例模式：/foldername/
14. 请指定 ***排除文件/目录*** （可选），用于跳过特定文件、目录和/或文件模式。注意：snapshots、lost+found 和 quarantine 文件夹默认被排除。

{% hint style="info" %}
**在&#x20;*****源起始目录*****&#x20;和&#x20;*****包含/排除*****&#x20;条目中使用的路径始终使用正斜杠（'/'），而不是反斜杠。这包括涉及远程 CIFS 卷的路径。**
{% endhint %}

15. 选择 ***目标卷*** 下拉列表中的选项。（可以是本地卷或远程卷。）
16. 请为 ***目标起始目录*** （或留空以同步到该卷的根目录）。
17. ***启动配置文件*** 选项应启用，以提供周期性、按计划运行的同步；对于一次性同步或只能手动启动的同步，请禁用启动配置文件。选择一个 ***启动时间配置文件*** 从下拉列表中 **或** 保留 **-- 默认 -** 设置，以使用内置 **“NAS Volume Syncs”** 配置文件的启动时间。 ***启动时间配置文件*** 决定周期性同步何时开始。 [快照配置文件](/automate-protect-and-extend/zh/bei-fen-yu-dr/snapshot-profiles.md) 用于控制卷同步的启动配置文件。

{% hint style="warning" %}
**该&#x20;*****启动时间配置文件*****&#x20;设置只决定同步的启动时间；它不控制该卷的快照！**
{% endhint %}

18. **高级选项**

* 请为 ***以用户身份运行*** （可选）。默认情况下，同步操作以“root”身份运行
* ***冻结文件系统*** （默认 - 禁用）- 仅当源卷是本地 VergeOS 卷时适用；在刷新缓冲区、分支文件系统并为同步操作拍摄干净状态快照期间，暂时阻止写入操作。虽然没有崩溃一致性快照操作那么瞬时，但文件系统冻结也可以相对快速完成。
* ***保留 ACL*** （默认 - 启用）- 当目标端不需要 ACL 时可禁用，以提升性能（例如：将 Linux 卷转换为 Windows）
* ***保留扩展属性*** （默认 - 启用）- 可禁用以在同步传输中省略扩展属性。
* ***复制符号链接*** （默认 - 启用）- 当符号链接指向外部/独立文件系统时可禁用。
* ***保留权限*** （默认 - 启用）- 适用于 Linux 权限；可禁用以避免传输到目标端。
* ***保留修改时间*** （默认 - 启用）- 可禁用以在后续同步操作中强制完整传输所有数据。
* ***保留组*** （默认 - 启用）- 可禁用以避免将组设置传输到目标端。
* ***保留所有者*** （默认 - 启用）- 可禁用以避免将所有者设置传输到目标端。
* ***保留设备文件*** （默认 - 禁用）- 可启用以便进行机器备份等。 **此选项应谨慎使用！** 需要超级用户权限。
* ***不设置目录时间*** （默认 - 禁用）- 目录时间基于备份时间分配，而不是源数据时间。
* ***不设置符号链接时间*** （默认 - 禁用）- 符号链接时间不会从源数据传输。
* ***就地更新目标文件*** （默认 - 禁用）- 当文件需要更新时，同步将直接更新数据，而不是默认的方式：创建文件的新副本并在完成后将其移动到位。
* ***保留 CIFS ACL*** （默认 - 启用）- 同步将把目标 ACL 更新为与源 ACL 相同。源系统和目标系统必须具有兼容的 ACL 条目，此选项才能正常工作。
* ***扩展属性*** - 可指定扩展属性，以为此同步提供额外功能/约束；如需有关扩展属性的帮助，请联系 VergeOS 支持。
* ***同时工作线程数*** （默认 - 4）- 指定同步操作使用的线程数。增加此数值可改善同步完成时间，尤其是在高延迟连接上执行同步时。

19. 单击 **提交** 以保存设置并创建新的卷同步。

新卷同步的仪表板将显示。同步任务将处于离线状态，直到手动运行或按照指定的启动配置文件自动启动。

## 启动卷同步

要手动启动同步，请选择 **启动同步** 从卷同步仪表板左侧菜单中。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/zh/nas/volume-syncs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
