Legado 书源
连接 Legado 书源，访问海量网络小说资源
Legado（开源阅读）是一款拥有丰富书源生态的开源阅读应用。小幻阅读支持连接 Legado 服务端，访问其书源中的海量网络小说资源。
支持的服务类型
小幻阅读支持两种 Legado 服务：
| 类型 | 说明 | 适用场景 |
|---|---|---|
| 开源阅读 | Android 应用，通过内网端口提供服务 | 同一局域网内使用 |
| Reader 服务端 | 自部署的阅读服务端（hectorqin/reader） | 跨网络远程访问 |
开源阅读（Android）
开源阅读是运行在 Android 设备上的阅读应用，开启 Web 服务后可通过局域网访问。
优点：
- 配置简单，开箱即用
- 书源丰富，社区活跃
限制：
- 需要 Android 设备保持开启
- 小幻阅读必须与 Android 设备处于同一局域网
- 某些设备（如华为）锁屏后会自动杀后台
后台保活
部分 Android 设备的电池优化策略会在锁屏后终止后台应用。请将开源阅读加入后台白名单或电池优化白名单，确保服务持续运行。
Reader 服务端
Reader 是一个可自部署的阅读服务端，支持 Docker 部署，可搭建在云服务器或 NAS 上。
优点：
- 不受局域网限制，随时随地访问
- 服务器稳定运行，无需担心后台被杀
- 支持多用户（通过 Access Token 区分）
限制：
- 需要一定的服务器运维知识
- 需要自行搭建和维护
添加 Legado 源
在侧边栏的 Legado 分组中，点击 + 按钮添加新的 Legado 源。
配置项
| 配置项 | 说明 |
|---|---|
| 名称 | 自定义名称，用于在侧边栏中显示 |
| 服务器地址 | Legado 服务的 URL（如 http://192.168.1.100:1122） |
| 服务器类型 | 选择「开源阅读」或「Reader」 |
| 访问令牌 | Reader 服务端的认证令牌（开源阅读无需填写） |
| 忽略 SSL 错误 | 如果使用自签名 HTTPS 证书，请勾选此项 |
获取服务地址
开源阅读：
- 打开开源阅读 App
- 进入「我的」→「Web 服务」
- 开启服务，记录显示的 IP 地址和端口
Reader 服务端：
- 使用你部署的服务器地址，通常为
http://服务器IP:端口或自定义域名
浏览书架
添加 Legado 源后，点击侧边栏中的源名称即可进入该源的书架页面。
书架展示 Legado 服务端上的所有书籍，包含以下信息：
| 信息 | 说明 |
|---|---|
| 封面 | 书籍封面图片 |
| 书名 | 书籍标题 |
| 作者 | 作者名称 |
| 来源 | 书源名称 |
| 最新章节 | 书源中的最新章节 |
搜索书籍
在顶部搜索框输入关键词，可快速筛选书架中的书籍（按书名或作者匹配）。
刷新书架
点击刷新按钮可重新从 Legado 服务端加载书架数据。
导入书籍
选中一本或多本书籍后，可以通过底部操作栏进行导入操作。
选择方式
| 方式 | 操作 |
|---|---|
| 单选 | 点击书籍卡片 |
| 多选 | 按住 Ctrl 并点击 |
| 范围选择 | 按住 Shift 并点击 |
| 框选 | 在空白区域拖动鼠标框选多本书籍 |
| 全选 | 点击底部操作栏的「全选」复选框 |
导入方式
| 方式 | 说明 | 特点 |
|---|---|---|
| 在线导入 | 创建书籍引用，阅读时实时请求内容 | 即时打开，按需加载，需要服务在线 |
| 下载导入 | 下载全部章节并转换为 EPUB，导入到本地书库 | 支持离线阅读，可使用完整阅读功能 |
| 下载到本地 | 下载 EPUB 文件到指定目录，不导入书库 | 用于备份或分享 |
在线阅读 vs 下载阅读
两种阅读方式各有优劣，可根据实际需求选择。
在线阅读
将书籍作为在线引用导入，阅读时从 Legado 服务端实时获取章节内容。
优点：
- 即时开始阅读，无需等待下载
- 自动获取最新章节
- 不占用本地存储空间
限制：
- 需要 Legado 服务保持在线
- 网络不稳定时可能影响阅读体验
- 部分高级功能不可用（如批注、AI 功能）
下载阅读
将书籍完整下载并转换为 EPUB 格式，导入到本地书库。
优点：
- 支持离线阅读
- 享受标准阅读器的完整功能（批注、AI、TTS 等）
- 章节内容确定，阅读体验稳定
限制：
- 需要等待下载完成
- 占用本地存储空间
- 更新章节需要重新下载
建议
对于正在追更的书籍，推荐使用在线阅读；对于已完结或需要精读的书籍，推荐使用下载阅读。
阅读进度同步
小幻阅读与 Legado 服务端之间通过 API 同步阅读进度。
注意
建议在小幻阅读和 Legado 之间选择一个作为主力阅读工具，避免混合使用。频繁切换可能导致阅读进度冲突或历史记录混乱。
常见问题
连接失败？
- 检查网络：确认小幻阅读与 Legado 服务在同一局域网（开源阅读）或网络可达（Reader 服务端）
- 检查服务状态：确认 Legado 服务正在运行
- 检查地址：确认服务器地址和端口正确
- 检查防火墙：确认防火墙未阻止相关端口
开源阅读服务经常断开？
Android 设备的电池优化可能会终止后台应用：
- 打开设备设置 → 应用管理 → 开源阅读
- 找到「电池」或「后台管理」设置
- 设置为「无限制」或「允许后台运行」
- 部分设备需要额外将应用加入「白名单」
下载进度卡住？
- 检查 Legado 服务是否正常
- 部分书源可能限制请求频率，稍后重试
- 尝试减少并发下载数量
在线阅读时章节加载慢？
- 检查网络连接质量
- 书源服务器可能响应较慢，这取决于书源质量
- 考虑将书籍下载到本地阅读