DOCUMENTATION

使用文档

从第一次部署,到每一天的阅读。

最近同步:2026/9/17 16:31:37 · 内容来自 GitHub

常用设置

首页 · English

在应用里设置

以下为网页入口,部分选项需要管理员或系统管理权限。

想做什么 入口
添加书库、修改扫描规则、查看导入记录 设置 → 书库来源和导入
自动补充书名、作者和封面 设置 → 智能整理
设置发件邮箱和 Kindle 收件地址 设置 → 邮件与 Kindle
连接第三方阅读器 设置 → OPDS
创建或恢复备份 设置 → 数据和系统
管理账户与书库访问权限 设置 → 用户管理
检查更新和当前版本 设置 → 关于
查看运行问题 设置 → 系统健康检查 / 系统日志

阅读字号、主题及翻页选项在阅读器里调整。发送 Kindle 和连接阅读器的步骤见用户指南

更改 Docker 端口

使用快速开始compose.yaml 时,将 "3000:3000" 左边改成空闲端口,例如 "3080:3000"。保存后运行 docker compose up -d,访问 http://服务器地址:3080

fnOS 用户在应用设置中修改端口。

使用已有书籍文件夹

compose.yaml 的书库挂载改为实际文件夹,例如:

volumes:
  - ./data/storage:/app/storage
  - /srv/books:/libraries/books
  - /srv/comics:/libraries/comics

保存后运行 docker compose up -d。在应用中分别添加 /libraries/books/libraries/comics,不要填写左侧的服务器路径。保留原有数据挂载;仅添加新书库无需更换 data/storage

目录权限

应用需能读写 data/storage、读取书库;上传和删除原文件还需书库写权限。快速开始默认使用 1000:1000。如 NAS 的目录属于其他用户,在 compose.yaml 同目录新建 .env,填写实际用户和用户组编号:

PUID=1000
PGID=1000

同时在 NAS 文件权限中授予对应访问权限,再运行 docker compose up -d

使用域名或安装网页应用

在 NAS 的反向代理设置中,将 HTTPS 域名转发到二毛图书的访问端口。先确认域名能正常登录、打开书籍,再用于手机或 OPDS。HTTPS 是完整网页安装与缓存能力的前提;只在局域网普通浏览时,可以继续使用 HTTP 地址。

DOWNLOAD

选择你的阅读入口

客户端连接已部署的书库;首次使用可先安装 NAS 服务端。

Windows / macOS / Linux

用浏览器打开你的服务器地址即可阅读,无需安装桌面客户端。