同步与网络问题 —— Kosync、calibre 无线、云存储连接不上

排查顺序

所有同步和网络问题都遵循相同排查路径：

1. 设备网络：KOReader 设备能上网吗？（打开 OPDS 浏览器或 RSS 测试）
2. Wi-Fi 信号：信号够强吗？
3. 局域网：设备和服务器在同一个网络吗？
4. 凭据：用户名、密码、Token 都对吗？
5. 防火墙：电脑或路由器防火墙有没有拦截？

Kosync 进度同步问题

进度同步不上

检查：

1. Kosync 服务器配置正确吗？地址、用户名、密码、设备 ID
2. Kosync 插件是否已启用？
3. 同步频率：是自动（每次打开书）还是手动？

手动触发同步

进入 KOReader → Kosync 插件 → 手动同步。手动同步更可靠，避免后台同步被打断。

自建 Kosync vs 公共 Kosync

如果公共 Kosync 不可用，考虑自建——或者用手动复制 metadata 的方式同步（见下）。

手动同步（最后手段）

KOReader 的阅读进度、书签、高亮保存在每本书的 .sdr/ 子目录下。手动同步：

1. 从设备 A 找到书 X 的 .sdr/ 目录
2. 复制到设备 B 书 X 的对应位置
3. 前提：设备 A 和 B 上的书 X 文件名和路径完全一致

calibre 无线连接不上

calibre 端

1. calibre 正在运行吗？（托盘图标是否存在）
2. 无线服务器正在运行吗？（calibre → 连接/共享 → 启动无线内容服务器）
3. calibre 显示的 IP 和端口是多少？

KOReader 端

1. 输入的 URL 格式正确吗？（如 http://192.168.1.100:8080/opds）
2. 带 /opds 结尾很重要——KOReader 用 OPDS 协议连接 calibre
3. 用户名密码对吗？（calibre 无线服务器如果设置了密码）

网络层

• 设备和 calibre PC 在同一个 Wi-Fi 吗？
• calibre PC 上有没有防火墙拦截入站连接？
• 某些公共 Wi-Fi（酒店、校园）会阻止设备间互访

Dropbox/WebDAV 认证失败

Dropbox

Dropbox 用 OAuth 认证，需要 KOReader 弹出浏览器授权：

1. KOReader → Dropbox → 点击登录
2. 设备浏览器打开 Dropbox 授权页
3. 确认授权
4. 回到 KOReader

如果设备没有浏览器（某些 Kindle/Kobo），Dropbox 认证会失败。改用 WebDAV 或 FTP。

WebDAV

检查清单：

1. URL 是否正确（很多 WebDAV 需要以 / 结尾）
2. 用户名密码对吗？
3. SSL/HTTPS 证书问题？（某些私有云自签名证书可能被 KOReader 拒绝）
4. 云服务是否真的开启了 WebDAV？（坚果云需要在设置里手动开启）

OTA 检查不到更新

设备无法访问 GitHub

某些地区访问 GitHub Releases 不稳定：

1. 在设备浏览器里打开 github.com/koreader/koreader/releases 测试连通性
2. 连不上？用 SourceForge 镜像手动下载更新

Wi-Fi 时才检查

如果设置了"Wi-Fi 时才检查"而当前是移动数据（Android 上可能），OTA 会跳过检查。

手动更新替代 OTA

OTA 不可用时，按第二章各平台安装手动下载最新安装包覆盖安装——不会丢失配置。

SSH/SFTP 连接问题

KOReader SSH 服务器

1. KOReader 里 SSH 服务器正在运行吗？
2. 端口是 2222 吗？（默认，可能被改过）
3. 密码对吗？重启 KOReader 后密码会变
4. 设备 IP 地址对吗？（重启设备后 IP 可能变）

电脑 SSH 客户端

# 测试连接（替换 IP 和密码）
ssh -p 2222 root@设备IP
# 如果超时：设备网络问题；如果拒绝：密码错或 KOReader SSH 没开

常见问题速查

继续阅读

• 云存储 —— 云存储传书
• SSH传书 —— SSH/SFTP 传书
• OTA 更新 —— OTA 更新