koreader 中文文档 下载 App

SSH/SFTP 传书 —— KOReader 自带 SSH 服务器

KOReader 自带 SSH 服务器

这是 KOReader 一个很少有人注意但功能强大的特性——KOReader 自身可以作为 SSH 服务器，让你从电脑直接通过 SFTP/SCP 传书到设备，不需要额外的传输工具或 App。

原理

KOReader 在设备上监听 SSH 端口，电脑上用标准 SSH 客户端（命令行、FileZilla、WinSCP 等）就能访问 KOReader 的文件系统。

启用 SSH 服务器

  1. 打开 KOReader
  2. 主菜单 → SSH Server（可能在"开发工具"或"网络服务"子菜单下）
  3. 点击启用 SSH 服务器
  4. KOReader 显示：

从电脑连接

命令行（Linux/macOS）

# 查看 KOReader 文件系统
ssh -p 2222 root@192.168.1.50

# 把一本书传上去
scp -P 2222 ~/Downloads/三体.epub root@192.168.1.50:/mnt/us/documents/

# 下载一本书
scp -P 2222 root@192.168.1.50:/mnt/us/documents/技术/深入理解计算机系统.pdf ~/Books/

FileZilla（Windows/macOS/Linux）

  1. FileZilla → 站点管理器 → 新建站点
  2. 协议：SFTP - SSH File Transfer Protocol
  3. 主机：KOReader 设备 IP
  4. 端口：2222
  5. 登录类型：正常
  6. 用户：root
  7. 密码：KOReader 显示的临时密码
  8. 连接

WinSCP（Windows）

类似 FileZilla，选 SFTP 协议。配置好后可以直接在 WinSCP 里拖拽文件到 KOReader 设备。

优点

内置 FTP 客户端 vs KOReader SSH

维度KOReader SSH 服务器内置 FTP 客户端
角色KOReader 是服务器KOReader 是客户端
方向电脑 → KOReader（推书）KOReader → FTP 服务器（拉书）
适用想给 KOReader 传书想从 FTP 取书
安全性SSH（加密）FTP（默认不加密）

实际上这两个功能是互补的——一个推一个拉。

SFTP vs SCP vs rsync

KOReader SSH 服务器支持所有标准 SSH 协议操作：

如果你的书库经常更新，rsync 配合 KOReader SSH 是最高效的方式——第一次传了 500MB，第二次只传新增的几本，可能只有几 MB。

KOReader 内置终端模拟器

KOReader 还自带一个终端模拟器插件——可以在 KOReader 里直接跑 shell 命令（ls、cd、mkdir 等）。对喜欢折腾的人来说：

安全说明

KOReader SSH 服务器的密码每次启动随机生成，重启 KOReader 后密码变化。这意味着：

常见问题

SSH 服务器在哪些设备上能用？

理论上所有 KOReader 支持的平台都能用，但实际受限于设备：

端口 2222 被占用？

可以在 KOReader SSH 服务器设置中改成其他端口（如 2223、8022）。

连接超时？

检查：

  1. 设备和电脑在同一 Wi-Fi
  2. KOReader SSH 服务器确实正在运行（KOReader 界面显示"SSH Server: Running"）
  3. 端口和 IP 地址正确
  4. 密码正确（重启 KOReader 后密码会变）

继续阅读