同步常见问题
同步失败和常见错误码(507、20016、-10、forbidden)、同步卡住、覆盖方向弄反、误删找回、只同步部分书、一家人共用书库、改了正文另一台没更新、云端文件名是编号、主题背景和字体没过来、iOS 后台同步,以及多设备使用的常见问题。
Reeden 会提供云存储吗?
不会。Reeden 不提供内置云盘空间。
数据同步需要你自己准备云存储,例如 WebDAV、S3、iCloud、百度网盘、本地目录等。
同步失败应该先检查什么?
先按下面顺序检查:
- 网络是否正常
- 云盘账号、密码、密钥或授权是否过期
- 云端空间是否足够
- 同步目录是否还能访问
- 是否修改过云存储类型、文件夹、多网盘配置或文件名策略
- 同步历史里是否有明确错误
解决错误后,再点击重试或重新执行同步。
具体报错在「数据同步」页的「历史」里看(同步历史,只保留最近 200 条)。常见提示的意思见下面的 常见错误提示和错误码。
还是不行,可以依次试试:
- 换一个网络,或关掉代理、VPN 再试
- 授权登录的网盘(百度网盘、123 云盘等)先取消授权(百度网盘叫「撤销授权」),再重新授权。浏览器授权失败时换一个浏览器
- 把 Reeden 从后台彻底关掉,重新打开后停在「数据同步」页再点同步
- 在书架上打开一本书的菜单,选「上传到云端」,看单独上传能不能成功
都不行时,在「关于」里点「分享日志」,把日志发给开发者。
常见错误提示和错误码
| 提示里出现 | 意思 | 怎么处理 |
|---|---|---|
507 | WebDAV 服务返回「空间不足」 | 清理网盘空间或扩容。网盘会员到期后空间可能变小 |
20016、-6、31045,或「百度网盘访问令牌无效或已过期,请重新授权」「百度网盘授权已过期,请取消授权后重新授权」 | 百度网盘授权失效 | 撤销授权后重新授权,见 百度网盘 |
百度网盘的 -10 或 10,比如 BaiduPan API error (10) | 百度网盘空间已满。后面的文字可能是「网盘空间已满」,也可能显示成「未知错误」或「转存文件已经存在」 | 清理网盘或扩容后再同步 |
| 「该资源已被百度网盘封禁,无法下载」 | 这个文件在百度网盘被限制下载 | 见 百度网盘 |
| 「123云盘访问令牌无效或已过期,请重新授权」 | 123 云盘授权失效 | 取消授权后重新授权 |
| 「已达到坚果云请求频率限制,请稍后重试」 | 坚果云限制了请求次数 | 见 坚果云 |
「未授权,请检查用户名和密码是否正确」、401 | WebDAV 用户名或密码不对 | 核对账号和密码,坚果云等服务要填应用密码 |
| 「文件名过长,请修改书籍名称后重试」 | WebDAV 上的文件路径太长 | 见下面的「个别书一直上传失败」 |
forbidden、Access Denied、403 | 没有访问权限,多见于 S3 类存储 | 检查密钥权限、Bucket 和服务器地址,见 S3 |
| 「无法创建同步目录,请到网盘手动创建 …… 目录」 | Reeden 没能在网盘里建出同步文件夹 | 到网盘里按提示手动建好这个文件夹,并确认账号有写入权限 |
| 「读取云端同步信息超时……」 | 连不上网盘或读取太慢 | 检查网络、授权和同步目录是否还在 |
| 「网盘文件未找到……」 | 云端找不到要下载的文件 | 见下面的「提示“网盘文件未找到”怎么办?」 |
| 「云端图书文件与同步元数据不一致……」 | 云端这本书的文件和书籍记录对不上 | 在保存这本书的设备重新同步,或对这本书单独上传后再试 |
| 「索引文件损坏,请删除网盘同步目录中的 indexes 文件后重试」 | 云端的索引文件坏了 | 按提示删掉同步目录里的 indexes 文件,再同步 |
| 「网络连接超时」「网络连接中断」「网络连接失败」 | 网络问题 | 换网络、检查代理后重试 |
同步卡住、一直「等待中」,或者点了没反应
先把 Reeden 从后台彻底关掉,重新打开,停在「数据同步」页再点同步。
同步按钮是灰的、点了没反应:
- 先看「网盘」里的配置是否完整、「验证连接」能不能通过
- 开了「多网盘同步」时,「元数据」和「文件」两栏都要配置好,只配了一栏时不能同步。用不上多网盘就把它关掉
停在「正在对比本地和云端数据」:书和笔记多时,对比要等一会儿,先别反复点。
长时间还是卡着不动:在出问题的这台设备上用「云端覆盖本地」(见下面的「同步方向弄反了怎么办?」),让它直接以云端为准。
网盘要走代理才能访问怎么办?
可以设置应用代理:
- 进入「更多设置 > 网络」
- 打开「应用代理」
- 选择代理类型(HTTP 或 SOCKS5),填写代理地址和代理端口,需要认证时再填用户名和密码
- 点「测试连接」确认能连通
应用代理用于同步和云盘书库访问,AI 等联网功能也会走这个代理。它只对当前设备生效,不参与同步,也不会被「从其他设备恢复」带过去。
提示“网盘文件未找到”怎么办?
这个错误表示 Reeden 准备从云端下载某个图书文件或资源文件,但在当前同步配置对应的网盘位置没有找到它。
常见原因:
- 云端同步目录里的文件被手动删除、移动或重命名
- 某台设备改过同步目录、云存储类型或多网盘同步配置
- 多台设备的「按原始文件名存储」设置不一致
- 原来有文件的设备还没有把图书文件上传完成
- 当前设备同步到了书籍信息,但图书文件本身没有在云端
建议按这个顺序处理:
- 先不要清空云端目录,也不要反复切换同步配置
- 检查网盘里的 Reeden 同步目录,确认提示中的文件是否还存在
- 确认所有设备使用同一套同步配置,包括云盘、同步目录、多网盘同步和「按原始文件名存储」(设置里叫「使用原始文件名存储」)
- 如果另一台设备还有这本书的本地文件,在那台设备重新执行同步,把图书文件上传到云端
- 回到报错设备点击「重试」
- 如果你确定不需要下载这个文件,可以点击「跳过此项」,之后再手动导入或从完整设备重新同步
如果这个错误出现在多本书上,通常说明文件类同步配置不一致,或云端文件目录被改动过。先找数据和文件最完整的设备做备份,再决定是否重新上传文件数据。
什么时候使用“云端数据对比”?
当你怀疑本地和云端的文件不同步时,可以在「数据同步」页面右上角「⋯」里打开「云端数据对比」(也常被叫作「云端对比」)。
它适合这些情况:
- 同步提示文件缺失或下载失败
- 书架有书,但当前设备下载不到图书文件
- 云端目录被手动清理、移动或重命名过
- 换设备后发现部分图书、字体、背景图或图片资源不完整
- 想清理云端已经不再使用的多余文件
页面里通常会看到两类结果:
- 云端多余:云端有、本地不再使用的文件。确认不需要后可以删除。
- 待上传:本地有、云端缺少的文件。可以提交上传任务,让其他设备后续能下载。
如果你看到大量“云端多余”或“待上传”,先不要直接全部删除。建议先确认所有设备的同步目录、多网盘同步和「按原始文件名存储」配置一致,再从数据和文件最完整的设备重新同步。
感觉数据丢失或变少怎么办?
先不要反复点击同步,也不要马上清空云端目录或卸载重装。先保住现有数据,再判断是哪一类问题。
建议按这个顺序处理:
- 暂时停止其他设备继续同步或编辑
- 找到数据最完整的那台设备
- 在这台设备上先导出一份备份文件
- 到「书库整理」里的「已删除书籍」检查是否可以还原
- 到「数据同步 > 备份」检查「元数据备份」和「云端元数据备份」,看是否有丢失前的备份
- 使用「云端数据对比」检查是否只是图书文件、字体、图片等文件类资源没有上传或无法下载
- 确认是书籍信息、笔记、进度变少,还是只是图书文件没有下载
- 确认数据最完整的一侧后,再决定恢复备份、重新同步或执行覆盖类操作
如果只是书架上有书,但打开时提示下载,通常不是书籍信息丢失,而是当前设备还没有图书文件。可以先看下面的“为什么书架有书,但打开时要下载?”。
如果一台设备上数据仍然完整,优先在那台设备导出备份。不要先让数据不完整的设备继续同步,否则可能把不完整状态继续带到云端和其他设备。
如果需要让云端重新以某台设备为准,请先确认这台设备的数据最完整,再使用覆盖类操作。
同步方向弄反了怎么办?
也就是「平板把手机的数据覆盖了」「用旧设备的数据盖掉了新数据」这类情况。
普通同步和覆盖的区别
- 普通同步:书架或「数据同步」页上的「立即同步」。它会把本机和云端合并成一份,笔记、书签也会合并。有冲突时不会弹窗让你选,按修改时间以新的为准
- 覆盖:手动放弃其中一边。入口在「数据同步」页「立即同步」按钮右侧的下拉箭头里:
- 「云端覆盖本地」:用云端元数据替换本机,本机多出来的笔记、书籍、标签、分类等记录会被删除
- 「本地覆盖云端」:用本机元数据替换云端。云端多出来的书籍、字体等文件不会被删除
想让一台设备拿到另一台的数据:先在数据对的那台设备「本地覆盖云端」,完成后等十几秒,再到另一台设备「云端覆盖本地」。两台设备在身边时,也可以用 从其他设备恢复 直接传过去。
弄反了怎么救
先停止其他设备继续同步,再按情况处理:
- 在某台设备上错点了「云端覆盖本地」:覆盖前 Reeden 会在这台设备自动建一份本地元数据备份(「合并云端数据前自动创建本地数据备份」默认开启)。到「数据同步 → 备份」,找覆盖前那份,点「恢复」,选「覆盖本地数据」。恢复后再「本地覆盖云端」,让云端也回到正确状态
- 在某台设备上错点了「本地覆盖云端」:它不会在本机建备份。找一台还没同步、数据还对的设备,在那台「本地覆盖云端」;如果其他设备也已经同步过了,到它们的「数据同步 → 备份」里找同步前自动建的那份恢复
- 普通同步后被旧数据覆盖:同样到「数据同步 → 备份」,找出问题前的那份恢复
「备份」列表里的历史备份只有元数据,不含书籍、字体、图片等文件。文件缺了,在还有文件的设备打开「云端数据对比」补传,见上面的「什么时候使用“云端数据对比”?」。
只丢了某本书的几条笔记时,也可以先把这本书现在的笔记导出成 JSON,恢复备份后再用「导入阅读数据」里的「通用阅读数据模板」导回去,避免恢复时把新笔记一起退回去,见 从其他 App 导入阅读数据。
以后怎么避免
- 很久没用的设备,先「云端覆盖本地」再开始用
- 在一台设备改东西前,先同步一次
- 所有设备先升级到同一个版本再同步,旧版本不认识新功能的数据
- 各设备的同步内容开关保持一致
误删了书、主题或图片,其他设备也跟着删了,怎么救?
删除会马上同步到云端,不管有没有开「自动同步」。所以一台设备删了,其他设备同步后也会删掉。
按删的是什么处理:
- 书:删除时勾了「保留笔记与统计信息」的,到「书库整理」→「已删除书籍」还原,见 已删除书籍。没勾的,在执行删除的那台设备恢复删除前的元数据备份(「数据同步 → 备份」),再在还有这本书文件的设备上传这本书
- 主题:恢复删除前的元数据备份,能找回主题本身和配色。背景图是文件,只能从还保留着这些图片的设备补传
- 我的图库里的图片、封面图集等:恢复元数据备份后,在还有图片的设备打开「云端数据对比」,把「待上传」里的文件传上去
元数据备份只在「合并云端数据」时自动创建,只有一台设备同步时一直没有自动备份,见 恢复历史元数据备份。重要操作前,自己先建一份。
能不能只同步部分书、某个分类,或者只同步进度?
不能按书、按分类、按主题挑着同步。元数据(书架、分类、笔记、进度、主题、规则等)是一个整体,不能关,也不能拆开。
可以做到的是:
- 只关心阅读进度:打开「阅读进度单独同步」(默认开启),打开书、关闭书时单独同步当前书的进度,不用等完整同步,见 实时进度同步
- 不想把书传到云端:在「数据同步 → 选项 → 同步内容」里关掉「图书文件」。关着时,编辑过的书籍正文也不会上传
- 只想传其中几本:关着「图书文件」,在书架上选中这几本,选「上传到云端」手动上传
- 字体、图库图片、词典等只能整类开或关
一家人共用书库,能各自分开进度吗?
同一套同步里分不开。书架、阅读进度、阅读统计都在同一份元数据里,连到同一个同步位置的设备,看到的是同一个书架、同一份进度,一个人读了会改掉另一个人的进度和最近阅读。
想各自分开,就各用各的同步位置:
- 用不同的网盘账号
- 或者用 WebDAV、S3、123 云盘时,每个人填不同的「文件夹」
这样两边的书架也是分开的,书要各自导入、各自上传。
百度网盘的同步目录是固定的,一个百度账号只能放一套 Reeden 数据,见 百度网盘。
为什么另一台设备没有看到最新进度?
常见原因:
- 旧设备还没有上传最新进度
- 新设备打开书前没有同步
- 阅读进度单独同步没有开启
- iCloud 或云盘还没完成系统层上传
- 两台设备离线阅读后产生了不同进度
建议开启「阅读进度单独同步」「打开书时同步」「关闭书时同步」。频繁切换设备时,离开前手动同步一次更稳。
如果关闭了自动跳转,目标设备不会直接跳到云端位置。打开这本书后,点击阅读页顶部「历史」按钮,在「云端历史」里手动选择。
如果看不到历史按钮,说明当前书还没有可查看的跳转历史或云端历史;如果有历史按钮但没有云端进度,可能只是本机跳转历史,或云端还没有这本书的可用进度。
如果你主要想优化跨设备继续阅读体验,请看 实时进度同步。
为什么书架有书,但打开时要下载?
这通常说明书籍信息已经同步了,但图书文件还没有下载到当前设备。
你可以:
- 开启图书文件同步
- 打开书时按提示下载
- 在 Wi-Fi 下手动同步文件
- 如果不想同步书籍文件,在当前设备重新导入对应书籍
想一次下载多本:在书架上选中这些书,点「下载选中」;或到「数据同步」页右上角「⋯」→「云端数据对比」→「待下载」,点「一键全部下载」。
另一台设备的主题背景图、字体、封面图集没有出现
主题、字体、封面图集、底栏图集的配置属于元数据,会同步过去。但背景图、字体文件、图集图片这些文件,同步时不会自动下载到另一台设备,要用时自己下载:
| 缺的是 | 在哪里下载 |
|---|---|
| 阅读主题的背景图 | 阅读主题页或「我的图库」里的「下载云端背景图」 |
| 封面图集图片 | 「封面图集」页的「下载全部」 |
| 底栏图集图片 | 「底栏图集」页的「下载全部」 |
| 字体 | 字体列表里选中后点「下载选中」 |
| 书籍 | 书架上选中后点「下载选中」 |
下载前先确认原来那台设备打开了对应的同步开关(「数据同步 → 选项 → 同步内容」里的「字体」「图库图片」「封面图集图片」「底栏图集图片」等),并且已经同步上传过。原设备关着这些开关时,云端没有这些文件,另一台设备也就下载不到。
云端目录可以手动改吗?
不建议手动改 Reeden 同步目录里的文件。
手动删除、移动、重命名或替换云端文件,可能导致其他设备下载失败、重复上传或无法匹配资源。
如果必须清理云端数据,先确认所有设备都已备份,并准备重新同步。
直接把书拷进网盘的同步目录,能同步吗?
不能。书要先在 Reeden 里导入,登记到书架上,才会参与同步。直接拷进同步目录(比如 books 文件夹)的文件,Reeden 不认识,不会出现在任何设备的书架上,「云端数据对比」里还会把它们算作「云端多余」。
网盘里已经有一批书的,用「网盘书库」从网盘挑书下载到书架,再同步,见 导入书籍 里的「网盘书库(网盘导入)」。
可以换一个云盘继续同步吗?
可以,但不要直接在已有数据上随意切换。
建议:
- 在当前设备完成同步
- 导出本地备份
- 配置新的云盘
- 如果新云盘目录为空,从数据最完整的设备重新同步
- 其他设备再改成同一套新配置
如果开启了多网盘同步,所有设备也必须保持相同配置。
网盘里的文件名为什么是一串编号?
这是正常的。默认情况下,云端的书籍、字体等文件用唯一 ID 命名,只影响你在网盘里看到的文件名,不影响 Reeden 使用。
想在网盘里看到书名,打开「数据同步 → 选项 → 存储策略 → 使用原始文件名存储」(以前也叫「按原始文件名存储」)。开之前要知道:
- 所有设备必须一致。这个开关会随同步带到其他设备,但不要反复开关
- 有同名书(比如两本都叫《三体》)时,只有先上传的那本能传上去
- 切换后,已经上传的文件不会自动改名,需要清空云端后重新上传。清空时删掉网盘同步目录里的
books和fonts两个文件夹即可,不要用书架上的「全部删除」 - 最好在第一次同步前就决定
不确定某台设备该开还是关,就看网盘里的文件:书籍文件是书名,就开着;是编号,就关着。两边不一致时,会出现「网盘文件未找到」。
个别书一直上传失败
其他书都正常,只有某几本反复失败,常见原因:
- 开了「使用原始文件名存储」,而书名里有网盘不接受的字符,比如 emoji 或特殊符号。不同网盘不接受的字符不一样
- 开了「使用原始文件名存储」,而且有同名的书,只有先上传的那本能传
- WebDAV 上文件路径太长,会提示「文件名过长,请修改书籍名称后重试」
处理方法:打开这本书的「编辑信息」,改最下面的「网盘文件名」(只在开着「使用原始文件名存储」时显示),去掉特殊字符或改短、改成不重名,再对这本书单独「上传到云端」。改的是云端文件名,书架上显示的书名不变。只能一本一本改。
如果这本书以前已经传上去过,改了「网盘文件名」后,要到网盘里把原来的文件也改成同样的名字,否则其他设备下载不到。
在一台设备改了书的正文或章节,另一台还是旧的
改过正文的书,要把新文件重新传到云端,另一台设备再下载新版:
- 在改过的设备上,确认「数据同步 → 选项 → 同步内容」里开着「图书文件」
- 点同步按钮做一次完整同步(书架、阅读页或「数据同步」页的同步按钮都可以),等它完成。「阅读进度单独同步」只传进度,不会带上新文件
- 另一台设备也做一次完整同步,再打开这本书。发现云端有新版时会弹出「发现书籍新版」,点「下载」,用新文件覆盖本机的旧文件
没有弹出「发现书籍新版」,还是旧内容:在另一台设备上对这本书「移除下载项」,再打开它从云端重新下载。
仍然不对,在改过的设备上对这本书单独「上传到云端」,等十几秒再到另一台设备同步。
TXT 编辑和重新分章相关的问题,见 TXT 常见问题。
自动同步要不要开?
多设备使用时建议开启。
推荐组合:
- 启动时同步
- 打开书时同步
- 关闭书时同步
- 阅读进度单独同步
- 仅在 Wi-Fi 下自动同步
如果你只在一台设备阅读,偶尔备份,可以只手动同步。
电脑端还可以开启「退出时同步」(在「数据同步 > 选项 > 自动同步」里)。开启后,关闭软件时会先隐藏窗口,等同步完成再真正退出。
自动同步什么时候触发?
「自动同步」默认关闭,每台设备要各自打开,这个开关不会随同步带到其他设备。
打开后,按「自动同步时机」里勾选的时机同步。默认勾选「启动时」「关闭书时」「数据变化时」,另外可以勾「打开书时」「网络连接时」。
- 「数据变化时」:数据变化后,等「自动同步间隔」(默认 2 分钟)再同步,避免频繁同步
- 「定时同步间隔」:默认「禁用」。设了间隔后,Reeden 开着时按间隔同步;App 没有打开时不会同步
- 「仅在 Wi-Fi 下自动同步」:用移动数据时不自动同步
删除操作不受这个开关影响,不管有没有开,都会立即同步到云端。
多台设备都开着自动同步、又在同一段时间改了同一类数据时,可能产生冲突,旧数据可能盖掉新数据。在一台设备上改东西前,先手动同步一次。
安卓切到后台还会继续同步吗?
会。安卓上同步开始后会显示通知,切到后台时同步会继续进行。
如果同步报错「无法启动后台同步,请允许通知和后台运行权限后重试」,到系统设置里允许 Reeden 发送通知和后台运行,再重新同步。
不想看到同步通知:不用同步的话,把「自动同步」和「阅读进度单独同步」都关掉;只是不想看通知,可以在系统设置里关掉 Reeden 的通知。之后如果同步提示「无法启动后台同步……」,再把通知权限打开。
iPhone、iPad 切到后台还会同步吗?
不会。iPhone、iPad 上没有后台同步,切到其他应用或锁屏后,同步会暂停。
第一次上传大量书籍、或同步内容很多时,请停在 Reeden 里等同步完成。退出阅读页后稍等几秒,让当前书的进度传完再锁屏。
换设备后要重新填网盘账号和各种密钥吗?
默认要。网盘账号、AI 和听书服务的密钥默认不会同步到其他设备。
有两种办法省掉重新填写:
- 开启「账号密码同步」:WebDAV、S3、听书服务、AI 服务商、OCR、KOReader 等账号密码会加密后随元数据同步,其他设备打开同一个开关就能用,见 账号密码同步
- 旧设备在身边时,用「从其他设备恢复」勾选「本机设置与密钥」,一次带过去,见 从其他设备恢复
OneDrive、Dropbox、Google Drive、百度网盘、123 云盘是网页授权,开启「账号密码同步」后每台设备仍要各自授权一次。
账号密码同步的保护密码忘了怎么办?
保护密码没有找回方式。
如果还有设备在正常使用,到那台设备的「数据同步 > 选项 > 账号密码同步」,点「保护密码」输入框里的眼睛图标,就能看到当前密码。
如果所有设备都没有这个密码,只能在一台设备重新填一遍账号密码,设一个新的保护密码并同步,其他设备再填新密码。详见 账号密码同步。
我不是不同步主题吗,为什么另一台设备还有?
数据同步里没有「不同步主题」开关。应用主题和阅读主题属于元数据,会一直同步,不能单独拆出去。
容易混淆的开关是:
- 「阅读主题排版配置」:只同步阅读主题绑定的排版(字号、边距、行距等),不决定主题会不会出现或删除
- 图库图片、封面图集图片、底栏图集、启动图:只同步图片文件,不决定主题或图集配置会不会同步
关掉这些开关后,主题列表、主题配色和删除操作仍会同步到其他设备。更完整的说明见 同步内容说明。
为什么我在一台设备删除主题,另一台也跟着删了?
删除会参与同步。主题是元数据的一部分,不能拆成「只在这台设备删除」。
一台设备删除主题并完成同步后,云端和其他设备也会删除同一条主题。这和书籍、笔记、标签的删除逻辑一样。
如果你只是不想在当前设备使用某个主题,不要删除它;优先换用其他主题,或先导出备份。删除前的注意事项见 同步前必读。
已经误删了,见上面的「误删了书、主题或图片,其他设备也跟着删了,怎么救?」。
不同设备想用不同的主题怎么办?
比如手机和墨水屏想用不同的主题。
主题列表是所有设备共用的:各设备导入的主题同步后会合并到一起,删除也对所有设备生效。但同步不会替你切换主题,每台设备正在用哪个主题,各自决定。
建议这样用:
- 不要为了「这台设备用不上」去删主题,否则其他设备也会删掉
- 用主题分组区分,比如建「手机用」「墨水屏用」两个分组
- 背景图不会自动下载,哪台设备要用哪个主题,就在那台设备下载它的背景图
- 想让各设备的字号、边距各自调,见 同步内容说明
同步和备份有什么区别?
同步会让多台设备的数据保持一致,删除和修改也会传播。
备份是保留某个时间点的数据副本,用来防止误操作或迁移失败。
重要操作前建议先备份,再同步。导出和恢复完整备份的方法,以及「覆盖本地数据」和「与本地数据合并」的区别,见 完整备份。
Reeden