数据与文件的同步​

Are you an LLM? You can read better optimized documentation at /user-guidesync.md for this page in Markdown format数据与文件的同步 ​我们在这里把同步分为「数据的同步」和「文件的同步」。

数据的同步指 条目字段信息、批注、笔记 的同步，这些数据仅能通过 Zotero 官方提供的服务同步。

文件的同步指 PDF 附件、网页附件、Word 文档、EPub 文件 等所有附件的同步。这些文件既可以通过 Zotero 官方服务同步，也可以通过 WebDAV 网盘来同步。

危险

无论你选择何种同步方案，切勿将 Zotero 的 数据存储位置/Data Directory 自定义为任何网盘的同步文件夹中（包括 iCloud），也切勿使用任何网盘/同步盘的备份功能直接同步/备份这一目录!（包括但不限于直接使用坚果云的官方客户端直接同步备份这一文件夹）

这样做在某些情况下可能会导致你的 Zotero 数据库损坏，带来严重的问题！官方对于这一问题的说明见这两篇文章：

How can I access my library from multiple computers?Can I store my Zotero data directory in a cloud storage folder?如果您已经将 Zotero 数据文件夹直接同步到网盘中，请您做好备份，根据 自定义数据文件夹 的教程将数据文件夹迁移到本地的其他位置，且确保未使用任何工具直接同步这一数据文件夹。

数据的同步初级 ​提示

无论如何，您都需要注册一个 Zotero 的官方账户，用于同步条目信息、批注以及笔记。如果您没有注册，可 快速创建一个 Zotero 账户。

您可以在「Zotero」→「编辑」→「设置」→「同步」→「数据同步」中输入您的 Zotero 账户的用户名和密码，然后点击「启用同步」进行登录。

提示

无论附件采用何种方式同步，条目信息、批注、笔记始终是通过 Zotero 官方的服务同步的。

条目信息、批注、笔记都是不占用 Zotero 官方的免费存储空间的，目前也没有总量的限制。

文件的同步 ​常用的文件同步方式有：

Zotero 官方存储空间：Zotero 官方提供的存储空间，300 MB 免费。WebDAV 同步：坚果云网盘、InfiniCLOUD 等支持 WebDAV 的网盘，部分服务商有免费的使用额度。第三方同步盘：如 OneDrive、百度网盘、iCloud 等，结合 Attanger 等插件进行同步。其中，Zotero 官方存储空间和 WebDAV 同步是官方推荐的同步方式，附件直接由 Zotero 进行管理，使用起来最为简单。第三方同步盘的方式则是通过 Attanger 等插件将附件转换为链接的附件进行同步，使用起来较为复杂，容易出现问题，且不支持 Zotero 官方的移动客户端。我们始终建议通过官方服务或 WebDAV 网盘进行附件同步。

同步方案对比以下是各种方式的对比：

对比项Zotero 官方存储空间 / WebDAV 同步Attanger + 同步盘 方案配置难度简单复杂多台电脑上同步附件是是更改附件存储位置/自定义存放附件的文件夹名否是支持的网盘种类很少较多是否可以在移动端 Zotero/Papership 打开附件是否简单来说，如果你只是需要在两个电脑之间同步数据，在设置正确的前提下，两者个方案都可以实现同步，但在文件的管理方式上存在区别。移动端则在应用的支持和使用体验上都有明显区别，主要体现在：「WebDAV 方案」可以选择的是官方的 Zotero 应用；「Attanger + 同步盘 方案」则更适合用 PDF Expert 或 Drawboard PDF 这一类的第三方 PDF 阅读器搭配 iCloud 或 OneDrive 直接从（整理好的）文件目录里打开 PDF 并批注和编辑。警告

我们始终建议通过官方服务或 WebDAV 网盘进行附件同步。网上流传较广的 ZotFile/Attanger + 同步盘 方案已经过时，且无法在移动端 Zotero 应用上进行同步，不再被官方所推荐。

目前 Zotero 已经内置了较为完善 PDF 批注功能，且由 Zotero 内置阅读器标记的批注会直接存储在 Zotero 的数据库中，不会直接写入到 PDF 文件中。即便您使用 Attanger + 同步盘 方案，在用第三方阅读器直接打开 PDF 文件时，仍然是无法看到由 Zotero 内置阅读器标记的批注的。正因如此，我们不再建议使用 Attanger + 同步盘 方案。

Zotero 官方存储空间初级 ​Zotero 官方提供了存储空间用于存储文件附件，您可以在 Zotero-编辑-设置-同步-文件同步中选择 Zotero 作为附件的同步方式。

每个 Zotero 用户都可以获得 300 MB 的免费 Zotero 存储空间，用于存储附加文件，并可 购买更大的存储空间。如果您拥有钞能力，这是最简单的备份方法，在登录您的 Zotero 账户并完成购买后无需其他任何设置。

购买 Zotero 官方存储空间的费用存储空间费用 (USD)300 MBFree2 GB$20/year (equal to $1.67 per month)6 GB$60/year (equal to $5 per month)Unlimited 无限$120/year (equal to $10 per month)如果您想免费进行进行文件的同步，那么您具有两种网盘同步方式：支持 WebDAV 的网盘（推荐）和第三方同步盘。对于大多数用户，我们建议使用 WebDAV 网盘同步。

提示

不要担心，条目信息、批注、笔记都是不占用 Zotero 官方 300 MB 的免费存储空间的。只有文件附件同步才会占用空间，因此只要不使用 Zotero 官方的存储空间同步附件，就完全不用关心这一限制。

通过 WebDAV 同步附件初级 ​什么是 WebDAV

WebDAV 是一组基于超文本传输协议的技术集合，有利于用户间协同编辑和管理存储在万维网服务器文档。 通俗一点儿来说，WebDAV 就是一种互联网技术，应用此方法可以在服务器上划出一块存储空间，可以使用用户名和密码来控制访问，让用户可以直接存储、下载、编辑文件。

目前常用的支持 WebDAV 同步的网盘包括坚果云网盘（有免费额度）、123 云盘（需购买会员）、阿里云盘（需购买三方权益包）、InfiniCLOUD（有免费额度）。常见的如百度网盘、iCloud、OneDrive 等均不支持 WebDAV 同步。

提示

我们只推荐使用坚果云网盘，后续教程也将以坚果云网盘为例。

如果您没有坚果云网盘的账户，请先 注册坚果云。

坚果云免费用户的流量限制说明坚果云免费用户具有以下限制：

流量与空间限制：每月上传流量 1GB/月、下载流量 3GB/月，空间受限于上传流量，

文件上传大小限制：当前 WebDAV 客户端和网页端上传大小的限制是一致的，默认为 500MB（私有云可以通过相关设置调整）。

访问频率限制：由于 WebDAV 协议比较占用系统资源，免费版用户限制访问频率为每 30 分钟不超过 600 次请求。付费用户限制访问频率为每 30 分钟不超过 1500 次请求。

当然对于大部分用户免费账户是完全够用的（虽然每个月只有 1GB 上传流量，但是好处是每个月都可以有 1GB，一年最多可以拥有 12GB）。如果您对容量（流量）的需求很高，可付费购买坚果云专业版，或者使用其他支持 WebDAV 同步的网盘。

PC 端 ​提示

目前坚果云官方团队已经开发了 Zotero 的坚果云官方 Zotero 同步插件 Nutstore SSO，可以直接通过插件登录坚果云账户并自动配置好 WebDAV。坚果云官方同步插件的使用方法请阅读： 坚果云官方 Zotero 同步插件使用教程。

如果您不希望使用插件进行配置，您仍然可以参照下面的手动配置步骤进行配置。

提示

如果您使用了 WebDAV 同步，则不需要下载坚果云官方的电脑客户端，也不需要下载其他用于同步的第三方软件或插件。您只需在各个电脑/移动设备上都参照本文档的教程，在 Zotero 同步设置中填写相应的同步设置即可。

这里以坚果云网盘为例，介绍如何在 PC 端配置 WebDAV 同步。

获取 WebDAV 文件同步的登录信息使用 WebDAV 同步时，您需要提供 WebDAV 服务器地址、用户名和应用密码。通常来说，如果您使用的网盘支持 WebDAV，这三个信息均可在网盘的设置中找到。

获取坚果云的 WebDAV 登录信息和应用密码在坚果云官网登录您的坚果云账户。

登录后点击 右侧用户名->账户信息

选择安全选项，下滑到底，点击添加应用。

完成后，记录下生成的密码。

在 Zotero 中配置 WebDAV 同步

打开 Zotero，编辑 → 设置 → 同步 → 文件同步，将 「我的文库」附件同步方式 由 Zotero 改成 WebDAV，并填写你的 WebDAV 服务器地址（坚果云需填写：dav.jianguoyun.com/dav）。 用户名是坚果云账号，密码是生成的应用密码（非坚果云账号的登录密码），设置好后点击 Verify Server 即可。

注意

请注意，这里使用的密码是网站上生成的应用密码，而不是直接在网页上登录时的密码。大多数云盘的 WebDAV 同步都需要使用专门的应用密码进行登录，您可以在云盘的设置中找到相关选项。

到此处，电脑上关于 WebDAV 的同步设置就完成了。

回到首页，点击界面右上角的同步按钮就可以进行同步。如果是第一次设置，会提示在 WebDAV 网盘里自动创建一个名叫 zotero 的文件夹，用于存放同步更新的文件。

自定义存放路径如果在坚果云里新建了一个文件夹，想将文件放在那个文件夹里的话，那么在填写服务器地址时，需要添加对应的文件夹名字（建议文件夹用英文或数字命名），例如 work，那么服务器地址填写如下：

此时，你的 Zotero 的同步文件将会放在 根目录/work/Zotero 中。

iOS ​Zotero 的 iOS/iPadOS 官方客户端的配置教程见：移动端配置教程。

Android ​Zotero 的 Android 官方客户端和第三方客户端的配置教程见：移动端配置教程。

通过第三方网盘同步附件高级 ​危险

我们不建议使用第三方网盘结合 Attanger 等插件的方式进行同步。这会导致很多问题。除非你具备较强的问题排查能力，且对 Attanger 所提供的功能有刚性需求，否则请不要使用这种方法！

如果您希望通过第三方同步盘来进行附件的同步，您可以使用 Zotero Attanger、ZotMoov 等插件来实现。

如何配置 Attanger/ZotMoov + 同步盘 同步方案Zotero Attanger 这一类插件会将 Zotero 的 PDF 附件转换为链接的附件，并将其存储在指定的文件夹中。您可以直接将存储附件的目标文件夹放置在 百度网盘同步盘、阿里云盘备份盘、iCloud、OneDrive 等云盘目录中，也可以使用坚果云官方客户端等工具在不同设备之间同步这一文件夹。不过，请务必注意，请不要将存储附件的目标文件夹选为 Zotero 的数据目录，更不要将 Zotero 的数据目录用任何手段进行同步。

在使用这一方案时，附件会由「存储的附件」转换为「链接的附件」，这样会导致无法直接通过 Zotero 本身的「删除条目」功能来删除附件。您需要使用 Zotero 的「显示文件位置」功能，手动删除文件夹中的文件。此时，您可能需要借助 Del Item With Attachment 插件提供的「删除条目和附件」功能进行删除。详见：删除 Zotero 中链接的附件时，同时删除系统中的文件

如果您确定要使用第三方网盘同步附件，您可以参考下面的教程：

Zotero Attanger 插件教程您也可以使用 ZotMoov 插件 作为替代来实现附件的同步。但我们仍然建议您先阅读 Zotero Attanger 插件教程，完全理解每一项设置的含义后再进行使用。

提醒

选用这一同步方式时，我们强烈建议您仔细地阅读 Zotero Attanger 插件教程，详细了解各项设置的含义和使用方法，以及文档中提到的各个注意事项。错误的设置可能会导致附件丢失或无法同步。

问题排查及同步方案之间的切换 ​如果您在同步中遇到报错、文件无法打开、文件无法删除等问题，请参照这篇文档处理：Zotero 同步问题排查。

如果您希望从其他同步方案切换到 WebDAV 同步，请阅读这个教程：迁移到 WebDAV 同步方案。

如果您希望其他同步方案切换到 Attanger + 同步盘方案，请阅读这个教程：迁移到 Attanger + 同步盘方案。

贡献者 Northword 可口可乐 Chikit-L l0o0 Roland页面历史 最后编辑于 10 个月前查看完整历史0b3fe5b-维护：重构 formatter 工具，优化文档格式 (#379)7c7536b-修复一些标题锚点错误34c4866-同步：增加备份提示和坚果云SSO插件教程指引 (#373)e7434a8-完善同步、备份、恢复、抓取教程 (#370)bc2658f-修订同步文档: 更新配图，新增同步盘方案，新增FAQ，调整大纲902964a-使用坚果云单点登录插件来配置 WebDAV (#367)0ac1789-更新文档风格指南：使用直角引号 (#224)60ce344-整理和更新图标图片资源 (#253)8258fad-添加两处待办链接：从备份恢复数据和第三方同步496e97c-添加图标资源f08740d-更新转换器更新提示、Style用法、同步盘部分内容 (#177)43e9d0f-refactor: migrate SSG to VitePress, migrate website to zotero-chinese/website repo (#172)e3618fa-chore(deps): update all non-major dependencies (#157)5d43a76-首选项->设置 (#135)848be56-添加安卓端信息，将移动端单独显示 (#124)250ca63-启用RSS，更新依赖 (#108)dce7f7a-维护：增加Prettier和Git Hooks (#107)7b98e05-修复图片大小错误 (#99)e1b10a6-修改 iOS 示例图尺寸 (#54)c6ce342-修复了部分文章中连续图片不能居中的问题，更新了zoo同步教程 (#25)d13c959-完成ios同步部分内容 (#22)d3fda8b-部分完成数据与文件的同步 (#18)2a3d126-减少子目录78f4258-替换文件名为全英文，取消文件名编号6486b76-tweak, stage updatef91d373-update md files