在线服务器模式部署教程
在线墨水屏看板说明
Kindle 在线看板是专为闲置 Kindle 打造的动态水墨屏显示系统,将墨水屏的温润质感与云端 API 实时数据无缝融合。
不同于静态离线日历,在线模式的最大魅力在于「内容是完全动态的」!Kindle 采取低频率按需定时唤醒(如白天每 2
小时联网拉取一次,夜间自动停止唤醒休眠)的智能策略。仅在唤醒换图的几十秒内开启 WiFi
下载最新画面并贴屏,随后立即切断网络重回挂起状态——既保证了信息流的绝对时效,又兼顾了极低功耗!
🏆 特点:
- 【实时动态,内容丰富】 可动态同步天气预报、 个人日程、Anki 学习统计与 HomeAssistant 传感器状态。
- 【低频唤醒,数月续航】 采用 RTC 硬件闹钟实现白天低频率唤醒更新(如 8:00 - 22:00),平时 99.9% 的时间保持 Suspend to RAM 深度休眠,充一次电坚守数月。
- 【墨水屏去极化保护】
内置黑白强力重置与二次电荷极性反转算法(
-f+-s),彻底消除网络状态栏覆盖与动态刷图可能产生的显存残影。
kindle
Weather · Dark
部署适用环境与设备要求
在获取资源包并开始部署前,请先确认您的 Kindle 当前具备以下条件:
- 设备越狱 设备需已成功越狱,并安装了 KUAL 开源程序启动器。
- 固件限制 推荐系统固件版本低于 5.14,这样 KUAL 插件天生拥有最高权限,无需额外配置即可刷屏与强制睡眠。
- 无线网络 🌐 可靠的 WiFi 网络:Kindle 唤醒时需连接局域网或外网拉取图片。
- 开箱即用 ⚡ 客户端插件已内置默认公网测试服务器:无需自己搭建 Docker 服务端即可直接解压安装并测试使用!若后续想接入个人 Anki 或 Calendar 日程,可随时自建 Docker 服务端。
⚡
针对固件 ≥ 5.14 的设备:由于较新系统采用了强力降级沙箱隔离,KUAL 默认降权没有屏幕控制权。您需要先在 Kindle 上额外安装并启用
USBNetwork 插件,接着采用本教程中提及的
ssh root@127.0.0.1 环回连接方式来调用和执行脚本。
📖
新手推荐:如果您对 Kindle 越狱、KUAL 安装,以及 USBNetwork 等插件的安装 and 使用尚不熟悉,强烈推荐访问专业 Kindle
教程网站 书伴 (BookFere),查找对应的详细图文安装指南。
下载并解压客户端插件包到 Kindle 📦 下载客户端插件包 (online-dashboard-plugin.zip)
将 Kindle 连接至电脑的 USB 接口。点击右上方按钮下载在线主控程序核心插件,直接解压出插件包移入 Kindle 根目录。 解压后,请确保 Kindle 设备内的根路径拥有以下完整的文件目录关系:
📁 Kindle 根目录
📁 online-dashboard (在线端主控及运行时脚本,内置 xh)
📄 device_info.conf (保存服务器终端 API 的配置文件)
📁 extensions (Kindle KUAL 插件父目录)
📁 online-dashboard (KUAL 触控菜单插件,配置与调试脚本分布)
📌
开箱即用公网测试地址:插件中
online-dashboard/device_info.conf 默认已配置好了公网免费测试
Server 地址(无需修改),解压放入 Kindle 后直接拔掉数据线即可在 KUAL 启动测试。后续若您在第三步搭建了专属 Docker 服务端,只需打开该文件修改
SERVER_URL 换成您自己的 IP 即可。
触屏调节设置与开箱运行
安全拔开 USB 数据线。在 Kindle 主界面打开 KUAL(Kindle 统一应用启动器),你将发现 “在线看板 (Online Dashboard)” 菜单:
- 设置在线拉取源 (Set Online Endpoint):根据喜好点击切换为
默认天气,可选日程,Anki统计。 - 设置主题颜色 (Set Theme Color):支持
白底黑字 (Light)与黑底白字 (Dark)的高对比切换。 - 设置屏幕旋转 (Set Screen Rotate):支持
普通正屏 (Normal)与转向挂墙 (Rotated 180°)。 - 自定义天气城市 (Set Weather City):编辑
online-dashboard/device_info.conf中的CITY字段填入目标高德 Adcode 编码(如310104代表上海市徐汇区,您可点击 城市 Adcode 编码在线查询 快速检索全国各地区代码)。 - 请求更新频率 (Set Fetch Interval):可选
每两小时更新、每六小时更新,或选择日间两小时更新(只在 8:00 - 22:00 唤醒刷新,深夜彻底停机断网挂起,极力保电);调试时可选择每五分钟调试快速预览。 - 点击最顶端的 “启动在线看板 (Start Online Service)”。
⚙️ 点击展开查看 online-dashboard/device_info.conf 配置文件模板 展开/折叠
online-dashboard/device_info.conf
# Kindle Online Dashboard Configuration
VERSION="1.0.0"
SERVER_URL="https://k.122103.xyz"
ENDPOINT="api/stats/weather/kindle/image"
THEME="light"
ROTATE="true"
SHOW_BAT_TIME="false"
UPDATE_INTERVAL="120"
SCHEDULE="0 8,10,12,14,16,18,20,22 * * *"
TIMEZONE="Asia/Shanghai"
# 【城市代码设置】填入目标高德 Adcode 编码 (如 310104 代表上海市徐汇区,查询工具:/adcode.html)
CITY="310104"
💡
退出:启动后系统接管屏幕。如果您想退出在线循环或需要对 Kindle
执行充电等其他触控操作,只需短按一下机身的物理电源键,程序将感应唤醒中断并恢复 WiFi、释放枕头保护以自动返回系统主界面。
自建服务端(Docker)环境部署 📦 下载服务端源码包 (online-server.zip)
如果您需要接入自己的 Anki 学习统计、个人日程或自定义数据,可点击右上方按钮下载源码包,使用 Docker Compose 快速一键部署专属渲染服务器:
📚
Anki 数据同步服务部署(可选):如果您需要接入个人 Anki 统计,需先部署自建
anki-sync-server
服务。核心在于将 Anki 数据目录持久化挂载为 ./anki_data:/anki_data,后续在线看板容器即可直接读取并分析
collection.anki2 数据库。
📦 点击展开查看 anki-sync-server 的 docker-compose.yaml 配置模板 展开/折叠
docker-compose.yaml (anki-sync-server)
services:
anki_sync_server:
image: jeankhawand/anki-sync-server:25.07
restart: unless-stopped
ports:
- "8888:8080"
environment:
- SYNC_USER1=admin:admin
- TZ=Asia/Shanghai
volumes:
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
- ./anki_data:/anki_data
在解压后的服务端目录下,复制模版生成配置文件:
cp .env.example .env
📄 点击展开查看 .env 环境变量完整配置模板 展开/折叠
.env.example
# Anki 数据同步目录配置 (宿主机路径)
ANKI_DATA_DIR="./anki_data"
ANKI_DATA_DIR_DOCKER="/anki_data"
# Anki 指定用户数据同步目录配置
ANKI_DB_PATH="/anki_data/admin/collection.anki2"
# 高德地图 API 配置 (前往高德开放平台申请 Web服务 API Key)
AMAP_KEY="your_amap_api_key_here"
AMAP_CITY="310104"
# 高德 API 日级限流器 (true=开启, false=关闭)
# 开启后: 每个地区每天只实际调 API 一次,每天最多查询 AMAP_DAILY_CITY_LIMIT 个不同地区
AMAP_RATE_LIMIT_ENABLED="true"
AMAP_DAILY_CITY_LIMIT="100"
# 日历数据存储路径
CALENDAR_JSON_PATH="/app/calendar.json"
填入高德天气 API Key 与 Anki 数据路径后,在终端运行以下指令拉起服务:
docker compose up -d
📋
修改客户端配置:部署成功后,别忘了回到 Kindle 根目录,修改
online-dashboard/device_info.conf 中的 SERVER_URL 改为你的 Docker 物理
Server IP。
1 / 4