常见问题

打不开服务器或手机连不上

确认二毛图书正在运行，地址和端口正确。手机应使用 NAS 或电脑的地址，例如 http://192.168.1.10:3000，不能填 localhost。在家先连接同一局域网；离家后需使用可从外部访问的地址或家庭网络连接方式。

如果只有域名打不开，先试局域网地址，再检查 NAS 上的域名转发和证书设置。

检查端口是否被占用、磁盘是否已满，以及应用是否有权读写数据文件夹。Docker 用户可在部署文件夹查看：

docker compose ps
docker compose logs --tail=100 web

权限和端口调整见常用设置。不要清空数据目录来尝试修复启动问题。

Docker 部署需先挂载文件夹，再在应用中选择对应路径。快速开始示例中填 /libraries/books，不是服务器上的 library 路径。fnOS 的书籍放在 shuku.library 共享文件夹，应用同样选择 /libraries/books。

不要重复复制相同文件。多卷被拆成多本、或多本混在一起时，对照目录示例检查组织方式。

确认原文件仍在原目录、下载完整、未损坏且不带 DRM。先尝试另一本同格式文件；只有一个文件失败时，优先检查该文件。电子书首次打开需要下载时间；漫画包需完整且未加密。音频能导入但无法播放时，尝试其他设备或音频格式。

检查两台设备是否登录同一服务器和同一账户，且正在打开同一个文件或卷册。恢复网络后等待保存完成，再到另一台设备继续。使用第三方 OPDS 阅读器时，进度不会同步回二毛图书。

查看发送记录中的错误；核对发件邮箱设置、Kindle 收件地址及 Amazon 认可的发件人列表。只发送 EPUB 或 PDF，附件不能超过配置上限、邮件服务商限制及 50 MB。发送成功后，Kindle 处理和接收仍可能需要时间。

确认“设置 → OPDS”已启用服务，并复制页面提供的 OPDS 地址。该地址必须能被阅读器访问；登录使用二毛图书账号和密码。先在同一设备上确认服务器可访问，再检查阅读器填写的信息。

在登录页选择“忘记密码”，按提示提交请求。
请服务器管理员在应用数据目录的 password-reset/reset-password.html 找到重置文件。按快速开始部署时，服务器上的位置是 data/storage/password-reset/reset-password.html；fnOS 用户需查应用的 storage 数据目录，不是共享书库。
打开文件中的链接并设置新密码。链接在 30 分钟内有效，只能用一次。

没有服务器文件访问权限时，请联系管理员；不要公开分享重置文件或链接。

进入“设置 → 关于”刷新更新状态，按错误提示检查网络、剩余空间和权限。下载完成后还需点击“立即更新”并确认；仅下载不会安装。在线更新步骤见安装与更新。

安装失败且服务没有恢复时，保留数据并查看容器日志，向管理员或项目反馈。不要删除应用数据、手动清理更新标记或反复重新安装。fnOS 包版本与应用实际运行版本可能不同，检查二毛图书“关于”中的版本。

在 GitHub Issues 提供版本、设备、安装方式、操作步骤、报错文字或截图。只附相关日志片段，隐藏密码、重置链接和其他私人信息。QQ 群：154560969。