原创插件分享:为 Kindle 打造一个极简、原生、轻量化的 FTP 传书服务
项目地址:https://github.com/zzy-ac/kindle-ftp-server
前言
对于很多 Kindle 老玩家来说,越狱后的第一件事就是寻找一个优雅的无线传书方案。虽然 KOReader 的 SFTP、或者是老牌的 FileBrowser 网页版已经非常成熟,但对于追求“极简主义”和“原生体验”的极客来说,用电脑自带的资源管理器直接拖拽传书,才是最无感的体验。
今天,我为大家分享一款由零开始编写的 Kindle FTP 插件。它直接调用 Kindle 底层 BusyBox 内置的 ftpd 服务端,轻量且无需后台,最棒的是——它能像filebrowser插件一样在 Kindle 屏幕最顶端常驻显示 ftp 链接,且完全不影响你正常的看书翻页。
一、 为什么选择纯 FTP 方案?
相比其他无线方案,这个插件的优势在于:
- 极度轻量:不依赖 Python,不依赖 Go 语言编译的庞大体,直接唤醒 Kindle 系统自带的
busybox ftpd,零内存占用压力。 - 单次点击启动:完美融入 KUAL 菜单,点一下“Start”,无需掏出手机或电脑查看 IP,链接直接浮现在屏幕顶端。
- 常驻且透明:通过底层的
eips命令结合守护进程,将ftp://IP:21的文字“印”在最顶端,即使你正常翻页看书,它也会每隔2秒自动覆盖上来,永远不走丢。 - 完美清理:在 KUAL 中点击“Stop”后,会执行系统级的进程清洗,并在屏幕上短暂显示
killall ftpd字样,3秒后自动擦除所有痕迹,不留残影。
二、 功能展示与运行原理
- 启动服务:点击
Start FTP时,脚本会检查防火墙、放行 21 端口,并映射 root 权限到/mnt/us目录。随后后台拉起一个显示脚本,将 IP 居中固定在屏幕最上方。 - 客户端连接:电脑浏览器或 FileZilla 地址栏直接输入
ftp://你的Kindle IP:21,账户名为anonymous,密码留空,即可直接读写/mnt/us下的所有文件。(客户端需要调整为主动模式) - 停止服务:点击
Stop FTP时,脚本会瞬间清理后台的驻留进程,关闭 21 端口,解除 Kindle 的防休眠状态,然后干净地抹去屏幕上的字迹。
三、 插件安装教程
前置条件:
你的 Kindle Voyage 等机型已完成越狱,并安装了 KUAL(Kindle Unified Application Launcher)。
kual版本
之后将下载到的插件包解压,并将其中的extensions文件夹拷贝到kindle根目录下。
Koreader版本
将koreader的插件包ftpmanager.koplugin解压并放置到kindle根目录下的koreader/plugins目录下。
四、 使用方法与注意事项
- 在 Kindle 上打开 KUAL,找到
FTP服务器。 - 点击
启动FTP服务。此时如果一切正常,你的 Kindle 屏幕最顶端正中央会出现ftp://192.168.x.x:21。 - 在电脑上打开文件管理器(Windows 资源管理器或 Mac 访达),输入该地址。用户名填
anonymous,密码留空,即可无线上传电子书。 - 传书完成后,记得在 KUAL 中点击
关闭FTP。 - koreader中同理,在插件中找到
ftp manager。 - 点击
start ftp。 - 其它跟原生版本一样。
- 点击
stop ftp关闭程序。 - koreader版中增加了一个
status显示按钮用于查看相关的端口等信息。
⚠️ 安全与耗电提示:
- 由于该插件使用了
-a root映射匿名登录,并放行了本地端口,请仅在绝对可信的局域网环境下使用。 - 为了防止屏幕被系统刷新覆盖,插件在运行期间会阻止 Kindle 休眠。因此,传完书后务必点击 Stop,以免设备持续耗电。
- 如果在使用中遇到部分 FTP 客户端无法列出目录,请在客户端设置中切换为**主动模式 (Active)**。
- 本程序直接调用kindle自带的接口,所以程序极度精简,仅仅2kb左右的空间占用
附上使用效果截图:




本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!