安装与更新

首页 · English

选择安装方式

使用场景	安装方式
NAS、家庭服务器	按快速开始使用 Docker 安装
fnOS	从正式发布页下载 .fpk，在应用中心手动安装
Android 手机	从发布列表选择带 .apk 附件的正式版本
电脑、iPhone、iPad	在浏览器中打开已部署的服务器地址

Android 客户端需要连接服务器，不能代替 NAS 上的服务。截至 2026-09-16，服务端最新正式版为 v1.1.0，最新正式 Android APK 在 v1.0.2 发布页。并非每次服务端发布都附带 APK；iOS 暂无公开 IPA 安装包。

fnOS 首次安装

1. 在应用中心手动安装下载的 .fpk，选择未被占用的访问端口，默认 3000。
2. 从桌面入口打开二毛图书，按向导创建账户。
3. 将书放入 fnOS 的 shuku.library 共享文件夹。
4. 在二毛图书中添加 /libraries/books 为书库，选择组织方式并开始导入。

“全新安装”会清空账户、设置、阅读进度等应用数据，不会自动备份；原始书库文件保留。 已有数据时先备份。从 0.x 更换到 1.x 必须全新安装，不要将旧应用数据直接交给新版使用。

更新服务端

更新前先备份，并暂停阅读和收听。

支持在线更新的部署可由管理员操作：

1. 打开“设置 → 关于 → 更新与版本历史”，点击“刷新更新状态”。
2. 有新版本时点击“下载更新”，等待显示更新包已准备好。
3. 点击“立即更新”，核对版本后确认。
4. 等待服务恢复，再查看“关于”中的实际运行版本，检查书库和阅读进度。

下载完成不会自动安装。安装期间会暂时无法访问，请勿关闭容器或设备。没有下载或安装按钮、提示不支持时，按页面提示及目标版本的发布说明处理。

旧 Docker 部署需要更新镜像时，在原部署文件夹运行：

docker compose pull
docker compose up -d

保留原来的数据和书库挂载。已支持在线更新的部署，单独拉取镜像不保证应用版本随之升级，应使用上面的在线更新入口；完成后以“关于”显示为准。

fnOS 可在应用中心安装新版 .fpk 并选择“更新”，保留数据。应用内更新后，fnOS 显示的包版本可能与应用实际运行版本不同，仍以二毛图书“关于”为准。

更新 Android

下载新正式 APK 后覆盖安装；先查看该版本的升级说明。正式版和 Beta 是两个独立应用，需要分别登录。更新服务端不会自动更新手机安装包。

停止或卸载

Docker 部署可在原部署文件夹运行 docker compose down 停止并移除容器；上面示例中的 data/storage 和 library 文件夹仍会保留。fnOS 卸载前先备份，并仔细核对删除数据选项。不要删除唯一一份应用数据或原始藏书。