# 2026-06-20 Audiobookshelf 部署 + 章节排序经验

## Audiobookshelf 部署

- Docker 容器：ghcr.io/advplyr/audiobookshelf:latest (v2.35.1)，端口 13378
- docker-compose 管理，路径：`/home/ubuntu/audiobookshelf/`
- Caddy 反代：podcast.xybkwd.top
- 数据目录：config/ metadata/ audiobooks/ podcasts/

## 章节排序三层同步铁律

Audiobookshelf 的章节显示依赖三层数据：

| 层 | 数据位置 | 关键字段 |
|:---|:---|:---|
| 文件系统 | 文件名 `01-标题.mp3` | 数字前缀保证字母序 |
| books.chapters (SQLite) | JSON 数组 | `start` 时间戳递减 |
| books.audioFiles (SQLite) | JSON 数组 | `index` 顺序递增 |

**只改文件名不生效**，必须三条线同步。

## 完整工作流

```
yt-dlp 下载 → --print upload_date 获取发布时间
  → 按 upload_date 排序 → 生成 01~N 前缀
  → 重命名 01-源端完整标题.mp3
  → 放入 /home/ubuntu/audiobookshelf/audiobooks/专辑名/
  → watcher 自动检测（不重启容器）
  → 验证 chapters.start + audioFiles.index 顺序正确
```

## B站下载要点

- 需 cookies 认证（从本地 Firefox cookies.sqlite 提取 → SCP 上传 /tmp/bilibili_cookies.txt）
- B站无纯音频流，用 `-f worstvideo+worstaudio/worst -x` 最小化下载量
- 每集 ~40-50MB（音频），下载速度 6-14 MB/s（日本 CDN 节点）
- 服务器带宽 1.5TB/月，完全够用

## 踩坑记录

1. `rm` 数据库必须先问用户 - 造成账号数据丢失
2. Audiobookshelf 章节排序不是靠文件名，是靠 start 时间戳
3. 操作文件前不要盲目 rm，先用 ls 确认
4. 容器不需要频繁重启，watcher 会自动检测文件变化