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 Audiobookshelf Audiobookshelf 扫描磁盘上的文件夹,并同时支持播客和电子书。Berth 只做有声书,把书籍作为数据库实体保存,并围绕远程存储(S3、Google Drive)和签名 URL 分发设计。
vs Audible Audible 是带 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 应用中收听 —— 手机扫描二维码即可连接。

部署此服务 →