【免费下载链接】CrossInkE-reader firmware for ESP32 devices. Personal fork of Crosspoint Reader.项目地址https://gitcode.com/gh_mirrors/cr/CrossInk点击查看免费下载CrossInk 是一款面向 ESP32 设备的开源电子书E-reader固件是 Crosspoint Reader 的个人分支。它内置KOReader 进度同步KOReader Sync功能可让你在不同设备之间无缝接续同一本书的阅读进度。本教程将带你快速完成 CrossInk 的 KOReader 进度同步配置覆盖官方免费服务器与自建 Docker 服务器共 3 种方案全部免费、开箱即用。KOReader 进度同步是如何工作的在配置之前先简单理解同步原理方便排查问题CrossInk 使用KOReader 同步协议KOSync与服务器通信因此只要服务器和账号相同就能与 KOReader 生态设备互通进度每本书会用「文件名」或「文件内容 MD5」生成文档哈希作为进度在服务器上的唯一标识认证使用密码的MD5 摘要CrossInk 会在设备内部自动计算你只需输入明文密码账号、服务器地址等凭据保存在 SD 卡/.crosspoint/koreader.json中并已做混淆处理。相关实现见 KOReaderSyncClient.hAPI 端点说明与 KOReaderCredentialStore.h凭据存储。方案一免费 CrossPoint 同步服务器默认推荐Sync Server URL 留空时CrossInk 默认使用免费的 CrossPoint 同步服务器https://sync.crosspointreader.com见 KOReaderCredentialStore.cpp。它完全兼容 KOReader 协议还会额外保存精确章节/页码位置实现 CrossInk 设备之间无损同步。一键式配置步骤进入Settings → System → KOReader Sync设置Username和Password输入明文密码即可Sync Server URL 保持为空或手动填写https://sync.crosspointreader.com在第一台设备上执行一次Sign Up注册账号其余每台设备只需执行Authenticate认证即可。 账号是「按服务器隔离」的旧sync.koreader.rocks上的账号在 CrossPoint 服务器上不存在需要重新 Sign Up可用相同的用户名/密码。方案二KOReader 官方公共服务器sync.koreader.rocks如果你已经在用 KOReader 生态设备对接官方公共服务器可以继续沿用它进度与 KOReader 应用互通进入Settings → System → KOReader Sync将Sync Server URL设为https://sync.koreader.rocks此项必填因为留空现在会指向 CrossPoint 服务器填入你现有的 KOReader Sync 账号用户名和密码执行Authenticate没有账号的话先执行Sign Up注册。方案三自建 Docker 同步服务器数据自己掌控希望数据完全私有化用官方koreader/kosync镜像 5 分钟即可自建一台同步服务器在服务器上创建compose.yamlservices: kosync: image: koreader/kosync:latest ports: - 7200:7200 # HTTPS - 17200:17200 # HTTP volumes: - ./data/redis:/var/lib/redis environment: - ENABLE_USER_REGISTRATIONtrue restart: unless-stopped启动服务docker compose up -d验证服务curl -H Accept: application/vnd.koreader.v1json http://服务器IP:17200/healthcheck返回{state:OK}即成功在设备端Settings → System → KOReader Sync中填入账号将Sync Server URL设为http://服务器IP:17200执行Authenticate。⚠️安全提示明文 HTTP 传输 MD5 派生密码并不安全请为同步创建专用账号、不要复用主账号密码流量离开可信局域网时请优先使用https://服务器IP:7200。所有用户创建完成后建议将ENABLE_USER_REGISTRATION改为false。提示同步前请确认设备已连上 WiFi。可通过 CrossInk 内置 Web 服务器的状态页如上图查看 Wi-Fi 状态与 IP 地址确保它与同步服务器在同一网络可达。日常使用中如何触发进度同步配置完成后同步只需一步阅读时按确认键打开阅读菜单选择Sync Progress或者在Settings → Controls → Long-press Menu中设置为KOSync之后长按确认键即可直达同步省去两次按键。智能同步Smart sync自动决策Sync Behavior提供两种行为新配置默认开启 Smart sync行为说明Ask every time每次手动选择「应用远端」或「上传本地」Smart sync自动决策远端无进度→直接上传两端一致→不做更改哪边进度更靠前就用哪边Smart sync 还会同时探测「文件名」和「二进制」两种文档哈希避免另一台 KOReader 设备用不同匹配方式同步时出现进度覆盖问题。进阶设置文档匹配方式怎么选Document Matching可在两种策略间切换见 KOReaderCredentialStore.hFilename文件名默认按文件名生成哈希即使两台设备里的文件略有不同如重新打包的 EPUB也能匹配上Binary二进制按文件内容 MD5 匹配更精确但要求各设备上的文件完全一致。若开启Send Metadata同步时还会附带书名、作者等元数据方便自建服务器端做更友好的展示。常见问题排查报错可能原因与处理Couldnt reach the sync server检查 WiFi 连接与 Sync Server URL 是否正确Username or password was rejected账号属于另一台服务器在对应服务器上重新 Sign Up 或核对 URLSync endpoint not found (404)URL 未指向有效的 KOSync 服务器检查地址结尾不要带多余路径Username is already registered账号已存在直接 Authenticate 即可更多细节可参考官方文档 KOReader Sync Quick Setup 章节以及设备间阅读统计同步说明 reading-stats-sync.md。赞分享【免费下载链接】CrossInkE-reader firmware for ESP32 devices. Personal fork of Crosspoint Reader.项目地址https://gitcode.com/gh_mirrors/cr/CrossInk点击查看免费下载相关推荐magnetW配置同步服务搭建自建服务器方案magnetW配置同步服务搭建自建服务器方案 你是否还在为多设备间同步magnetW配置而烦恼本文将详细介绍如何搭建magnetW配置同步服务通过自建服务桌面应用网页爬虫Logseq数据库版本网络同步自建服务器 vs 官方服务的对比Logseq数据库版本网络同步自建服务器 vs 官方服务的对比 在知识管理工具Logseq的使用过程中数据库版本的网络同步是一个关键环节。你是否还在为选择自知识管理桌面应用前端跨平台Captura配置同步服务多设备偏好共享实现方案Captura配置同步服务多设备偏好共享实现方案 痛点与解决方案概述 你是否经常在多台设备间切换使用Captura屏幕捕获工具时需要重复配置快捷键、输出桌面应用屏幕录制音视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/17 9:28:12 · 阅读 1.2k CrossInk KOReader进度同步配置教程：官方免费服务器与自建Docker共3种方案
【免费下载链接】CrossInkE-reader firmware for ESP32 devices. Personal fork of Crosspoint Reader.项目地址https://gitcode.com/gh_mirrors/cr/CrossInk点击查看免费下载CrossInk 是一款面向 ESP32 设备的开源电子书E-reader固件是 Crosspoint Reader 的个人分支。它内置KOReader 进度同步KOReader Sync功能可让你在不同设备之间无缝接续同一本书的阅读进度。本教程将带你快速完成 CrossInk 的 KOReader 进度同步配置覆盖官方免费服务器与自建 Docker 服务器共 3 种方案全部免费、开箱即用。KOReader 进度同步是如何工作的在配置之前先简单理解同步原理方便排查问题CrossInk 使用KOReader 同步协议KOSync与服务器通信因此只要服务器和账号相同就能与 KOReader 生态设备互通进度每本书会用「文件名」或「文件内容 MD5」生成文档哈希作为进度在服务器上的唯一标识认证使用密码的MD5 摘要CrossInk 会在设备内部自动计算你只需输入明文密码账号、服务器地址等凭据保存在 SD 卡/.crosspoint/koreader.json中并已做混淆处理。相关实现见 KOReaderSyncClient.hAPI 端点说明与 KOReaderCredentialStore.h凭据存储。方案一免费 CrossPoint 同步服务器默认推荐Sync Server URL 留空时CrossInk 默认使用免费的 CrossPoint 同步服务器https://sync.crosspointreader.com见 KOReaderCredentialStore.cpp。它完全兼容 KOReader 协议还会额外保存精确章节/页码位置实现 CrossInk 设备之间无损同步。一键式配置步骤进入Settings → System → KOReader Sync设置Username和Password输入明文密码即可Sync Server URL 保持为空或手动填写https://sync.crosspointreader.com在第一台设备上执行一次Sign Up注册账号其余每台设备只需执行Authenticate认证即可。 账号是「按服务器隔离」的旧sync.koreader.rocks上的账号在 CrossPoint 服务器上不存在需要重新 Sign Up可用相同的用户名/密码。方案二KOReader 官方公共服务器sync.koreader.rocks如果你已经在用 KOReader 生态设备对接官方公共服务器可以继续沿用它进度与 KOReader 应用互通进入Settings → System → KOReader Sync将Sync Server URL设为https://sync.koreader.rocks此项必填因为留空现在会指向 CrossPoint 服务器填入你现有的 KOReader Sync 账号用户名和密码执行Authenticate没有账号的话先执行Sign Up注册。方案三自建 Docker 同步服务器数据自己掌控希望数据完全私有化用官方koreader/kosync镜像 5 分钟即可自建一台同步服务器在服务器上创建compose.yamlservices: kosync: image: koreader/kosync:latest ports: - 7200:7200 # HTTPS - 17200:17200 # HTTP volumes: - ./data/redis:/var/lib/redis environment: - ENABLE_USER_REGISTRATIONtrue restart: unless-stopped启动服务docker compose up -d验证服务curl -H Accept: application/vnd.koreader.v1json http://服务器IP:17200/healthcheck返回{state:OK}即成功在设备端Settings → System → KOReader Sync中填入账号将Sync Server URL设为http://服务器IP:17200执行Authenticate。⚠️安全提示明文 HTTP 传输 MD5 派生密码并不安全请为同步创建专用账号、不要复用主账号密码流量离开可信局域网时请优先使用https://服务器IP:7200。所有用户创建完成后建议将ENABLE_USER_REGISTRATION改为false。提示同步前请确认设备已连上 WiFi。可通过 CrossInk 内置 Web 服务器的状态页如上图查看 Wi-Fi 状态与 IP 地址确保它与同步服务器在同一网络可达。日常使用中如何触发进度同步配置完成后同步只需一步阅读时按确认键打开阅读菜单选择Sync Progress或者在Settings → Controls → Long-press Menu中设置为KOSync之后长按确认键即可直达同步省去两次按键。智能同步Smart sync自动决策Sync Behavior提供两种行为新配置默认开启 Smart sync行为说明Ask every time每次手动选择「应用远端」或「上传本地」Smart sync自动决策远端无进度→直接上传两端一致→不做更改哪边进度更靠前就用哪边Smart sync 还会同时探测「文件名」和「二进制」两种文档哈希避免另一台 KOReader 设备用不同匹配方式同步时出现进度覆盖问题。进阶设置文档匹配方式怎么选Document Matching可在两种策略间切换见 KOReaderCredentialStore.hFilename文件名默认按文件名生成哈希即使两台设备里的文件略有不同如重新打包的 EPUB也能匹配上Binary二进制按文件内容 MD5 匹配更精确但要求各设备上的文件完全一致。若开启Send Metadata同步时还会附带书名、作者等元数据方便自建服务器端做更友好的展示。常见问题排查报错可能原因与处理Couldnt reach the sync server检查 WiFi 连接与 Sync Server URL 是否正确Username or password was rejected账号属于另一台服务器在对应服务器上重新 Sign Up 或核对 URLSync endpoint not found (404)URL 未指向有效的 KOSync 服务器检查地址结尾不要带多余路径Username is already registered账号已存在直接 Authenticate 即可更多细节可参考官方文档 KOReader Sync Quick Setup 章节以及设备间阅读统计同步说明 reading-stats-sync.md。赞分享【免费下载链接】CrossInkE-reader firmware for ESP32 devices. Personal fork of Crosspoint Reader.项目地址https://gitcode.com/gh_mirrors/cr/CrossInk点击查看免费下载相关推荐magnetW配置同步服务搭建自建服务器方案magnetW配置同步服务搭建自建服务器方案 你是否还在为多设备间同步magnetW配置而烦恼本文将详细介绍如何搭建magnetW配置同步服务通过自建服务桌面应用网页爬虫Logseq数据库版本网络同步自建服务器 vs 官方服务的对比Logseq数据库版本网络同步自建服务器 vs 官方服务的对比 在知识管理工具Logseq的使用过程中数据库版本的网络同步是一个关键环节。你是否还在为选择自知识管理桌面应用前端跨平台Captura配置同步服务多设备偏好共享实现方案Captura配置同步服务多设备偏好共享实现方案 痛点与解决方案概述 你是否经常在多台设备间切换使用Captura屏幕捕获工具时需要重复配置快捷键、输出桌面应用屏幕录制音视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考