添加 LANraragi 服务器

Koharia 内置 LANraragi 连接，兼容目标为 LANraragi 0.9.70 及更高版本。每个 Archive 会作为独立作品显示，Tankoubon 可以按合集浏览，服务器 Category 会显示为书架筛选。

准备信息

• 设备可以访问的 LANraragi 地址。
• API Key。未启用鉴权的服务器可以留空；需要写入阅读进度或限制访问的服务器通常需要填写。
• 如果服务器同时提供 Wi-Fi 内网地址，可以配置公网地址和内网地址。

添加步骤

1. 在“库连接管理”中选择“添加连接 → LANraragi”。
2. 输入连接名称、服务器地址和 API Key（如服务器要求）。
3. 选择默认 Category，并决定是否将 Tankoubon 合集分组显示。
4. 选择打开 Archive 时直接进入阅读器，或先显示带逐页缩略图的作品预览。
5. 保存并同步书库。

缓存与阅读

联网时 Koharia 会缓存书库元数据，因此断网后仍可以浏览和搜索已经缓存的 Archive。元数据缓存不代表页面正文已经下载；需要离线阅读时，请对作品执行手动下载。

阅读进度按 Archive 同步。服务器必须启用进度记录，并授予当前 API Key 相应权限。“标记未读”只会重置本地状态，不会清零服务器上的进度。

常见问题

• 找不到 Category：先保存连接并完成一次书库同步，再重新打开连接设置。
• 预览为空：页面缩略图和正文由服务器提供，检查 Archive 是否仍然可用。
• 进度无法上传：确认服务器开启进度记录，并使用具备写入权限的 API Key。
• 断网无法阅读：检查作品是否已经完成下载，而不是只有书库元数据缓存。