Berth
轻量的自托管有声书服务器,带 Android 和 iOS 应用。
Berth 是用 Rust 编写的开源有声书服务器。通过 Web 管理后台上传书籍,将文件存放在本地磁盘、S3 兼容存储或 Google Drive,并在 Android 和 iOS 上的 Berth 应用中收听 —— 手机扫描二维码即可连接。
使用 Pier 部署
- 1打开 Pier 控制台,点击 Add service。
- 2从模板列表中选择 Berth。
- 3选择版本、设置服务名称,Pier 会自动配置容器、存储和端口。
- 4如需 HTTPS,请绑定域名。Traefik 会自动签发 Let's Encrypt 证书。
什么是 Berth?
Berth 是用 Rust 编写的自托管有声书服务器。你通过 Web 后台上传书籍, 把文件存放在本地磁盘、任意 S3 兼容存储或 Google Drive,并在 Android 和 iOS 上的 Berth 应用中收听。手机扫描二维码即可连接。
与扫描文件夹的媒体服务器不同,Berth 把数据库作为唯一事实来源:书籍是 你在后台中管理的实体,音频可以通过短期签名 URL 直接从对象存储或 CDN 分发。
Pier 如何部署它
Pier 使用官方 ghcr.io/joveptesg/berth 镜像(amd64 和 arm64)。内部端口
8080,位于 Traefik 之后。一个持久卷 —— /data —— 用于 SQLite 数据库、
迁移前的自动备份、本地存储和 secret.key。
没有默认凭据。首次启动后在 Pier 中打开服务日志,点击一次性设置链接创建
管理员。绑定自定义域名,并在 Settings → Internet address 中填写它,让听众
扫描的二维码指向公开的 HTTPS 地址。请在备份之外另存一份 secret.key。
什么时候不该用 Berth
如果你需要在同一个应用中管理播客和电子书,或想通过扫描现有文件夹构建书库, 请使用 Audiobookshelf。视频请用 Plex 或 Jellyfin。Berth 仍处于早期开发 阶段 —— 请保留备份。
核心功能
管理书籍和用户的 Web 后台
在浏览器中上传有声书、管理书库并邀请听众。数据库是唯一事实来源 —— 书籍是实体,而不是扫描出来的文件夹。
Android 和 iOS 应用
在 Berth 移动应用中收听。手机扫描后台中的二维码即可连接你的服务器,无需输入地址。
本地、S3 或 Google Drive 存储
文件可以放在服务器磁盘上,也可以放在任意 S3 兼容存储桶 —— AWS、Cloudflare R2、Backblaze B2、MinIO、Yandex Object Storage —— 或 Google Drive 中。
签名 URL 分发
音频可通过短期签名 URL 直接从对象存储或 CDN 提供。服务器只负责授权访问。
内置备份
每次数据库结构迁移前 Berth 会自动备份数据库(保留最近 3 份)。可在 Settings → Backup 中下载、上传和恢复备份。
JSON API
带 OpenAPI 契约的版本化 JSON API(v1),用于脚本和集成。
应用场景
家庭有声书库
全家共用一台服务器 —— 上传一次,每个人用自己的手机收听。
放在廉价对象存储中的有声书
把大量藏书放在 R2 或 B2 中,服务器跑在小型 VPS 上 —— 播放直接从存储桶进行。
你拥有的无 DRM 书籍
为购买的无 DRM 有声书或自制有声书提供私人书架,无订阅、无第三方账号。
小型 ARM 设备
镜像同时构建 amd64 和 arm64,除 VPS 外也能运行在树莓派或 ARM NAS 上。
代码示例
# 由 Pier 自动生成 —— 仅作示意
services:
berth:
image: ghcr.io/joveptesg/berth:latest
volumes:
- berth-data:/data
# 端口 8080,通过 Traefik 发布到你的域名Berth 没有默认凭据。
在 Pier 面板中打开服务 → Logs,
打开首次启动时打印的一次性设置链接。Admin → Settings → Internet address:
https://books.example.com
之后展示给听众的二维码都会包含这个地址。对比
| vs Audiobookshelf | Audiobookshelf 扫描磁盘上的文件夹,并同时支持播客和电子书。Berth 只做有声书,把书籍作为数据库实体保存,并围绕远程存储(S3、Google Drive)和签名 URL 分发设计。 |
| vs Audible | Audible 是带 DRM 的 SaaS。Berth 在你掌控的服务器上托管你拥有的文件。 |
| vs Plex / Jellyfin | 通用媒体服务器把有声书当作音乐专辑处理。Berth 专为在手机上听书而设计。 |
常见问题
默认凭据是什么?
需要备份哪个卷?
/data 可以放在 NFS 或 SMB 上吗?
需要 HTTPS 吗?
如何升级?
如何回滚?
相关服务
在你的 VPS 上部署
Berth 是用 Rust 编写的开源有声书服务器。通过 Web 管理后台上传书籍,将文件存放在本地磁盘、S3 兼容存储或 Google Drive,并在 Android 和 iOS 上的 Berth 应用中收听 —— 手机扫描二维码即可连接。
部署此服务 →