Skip to main content
[ PIER ]

Berth

轻量的自托管有声书服务器,带 Android 和 iOS 应用。

Service#audiobook#media#library#s3#mobile

Berth 是用 Rust 编写的开源有声书服务器。通过 Web 管理后台上传书籍,将文件存放在本地磁盘、S3 兼容存储或 Google Drive,并在 Android 和 iOS 上的 Berth 应用中收听 —— 手机扫描二维码即可连接。

使用 Pier 部署

  1. 1打开 Pier 控制台,点击 Add service。
  2. 2从模板列表中选择 Berth。
  3. 3选择版本、设置服务名称,Pier 会自动配置容器、存储和端口。
  4. 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 运行的内容yaml
# 由 Pier 自动生成 —— 仅作示意
services:
  berth:
    image: ghcr.io/joveptesg/berth:latest
    volumes:
      - berth-data:/data
    # 端口 8080,通过 Traefik 发布到你的域名
找到一次性设置链接text
Berth 没有默认凭据。
在 Pier 面板中打开服务 → Logs,
打开首次启动时打印的一次性设置链接。
让手机二维码指向你的域名text
Admin → Settings → Internet address:
  https://books.example.com
之后展示给听众的二维码都会包含这个地址。

对比

vs AudiobookshelfAudiobookshelf 扫描磁盘上的文件夹,并同时支持播客和电子书。Berth 只做有声书,把书籍作为数据库实体保存,并围绕远程存储(S3、Google Drive)和签名 URL 分发设计。
vs AudibleAudible 是带 DRM 的 SaaS。Berth 在你掌控的服务器上托管你拥有的文件。
vs Plex / Jellyfin通用媒体服务器把有声书当作音乐专辑处理。Berth 专为在手机上听书而设计。

常见问题

默认凭据是什么?
没有。首次启动时 Berth 会在日志中打印一次性设置链接 —— 在 Pier 中打开服务日志并点击该链接创建管理员。
需要备份哪个卷?
/data —— 其中包含 SQLite 数据库、自动备份、本地存储和 secret.key。请在备份之外另存一份 secret.key;没有它将无法读取数据库中的存储密钥。
/data 可以放在 NFS 或 SMB 上吗?
不可以。Berth 使用 SQLite,在网络共享上可能损坏。请将 /data 放在本地磁盘上,如需远程存储,把音频放到 S3 或 Google Drive。
需要 HTTPS 吗?
Berth 在 8080 端口提供纯 HTTP。在 Pier 中绑定域名后,由 Traefik 在前面终止 HTTPS。
如何升级?
在 Pier 中重新部署服务 —— 会拉取最新镜像。迁移前 Berth 会把数据库备份到 /data/backups。
如何回滚?
在后台的 Settings → Backup 中(或用 berth admin restore)恢复升级前的备份。

相关服务

在你的 VPS 上部署

Berth 是用 Rust 编写的开源有声书服务器。通过 Web 管理后台上传书籍,将文件存放在本地磁盘、S3 兼容存储或 Google Drive,并在 Android 和 iOS 上的 Berth 应用中收听 —— 手机扫描二维码即可连接。

部署此服务 →