lsiodev/booksonic
lsiodev
Booksonic是一个用于流式传输有声书到PC或安卓手机的服务器和应用，支持Subsonic兼容平台，由LinuxServer.io提供定期更新、安全维护和多架构支持。
下载次数: 0状态：社区镜像维护者：lsiodev仓库类型：镜像最近更新：5 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
linuxserver/booksonic
Booksonic 是一个服务器和应用程序，用于将有声书流式传输到任何PC或安卓手机。其大部分功能也适用于其他支持Subsonic的平台。
支持的架构
该镜像支持多种架构，如 x86-64、arm64 和 armhf。我们利用Docker清单实现多平台识别。只需拉取 ghcr.io/linuxserver/booksonic 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构的镜像。
支持的架构及对应标签：
| 架构 | 标签 |
|---|---|
| x86-64 | amd64-latest |
| arm64 | arm64v8-latest |
| armhf | arm32v7-latest |
版本标签
该镜像提供多种版本，通过标签区分。latest 标签通常提供最新稳定版，其他标签视为开发版本，使用时需谨慎。
| 标签 | 描述 |
|---|---|
| latest | Booksonic 稳定版 |
| prerelease | Booksonic 预发布版 |
应用设置
默认用户/密码为 admin/admin。
使用方法
以下是帮助您开始创建容器的示例片段。
docker-compose（推荐）
兼容 docker-compose v2 架构。
yaml--- version: "2.1" services: booksonic: image: ***-ghcr.xuanyuan.run/linuxserver/booksonic container_name: booksonic environment: - PUID=1000 - PGID=1000 - TZ=Europe/London - CONTEXT_PATH=url-base volumes: - </path/to/appdata/config>:/config - </path/to/audiobooks>:/audiobooks - </path/to/podcasts>:/podcasts - </path/to/othermedia>:/othermedia ports: - 4040:4040 restart: unless-stopped
docker cli
bashdocker run -d \ --name=booksonic \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ -e CONTEXT_PATH=url-base \ -p 4040:4040 \ -v </path/to/appdata/config>:/config \ -v </path/to/audiobooks>:/audiobooks \ -v </path/to/podcasts>:/podcasts \ -v </path/to/othermedia>:/othermedia \ --restart unless-stopped \ ***-ghcr.xuanyuan.run/linuxserver/booksonic
参数
容器镜像通过运行时传递的参数进行配置（如上所示）。这些参数以冒号分隔，表示 <外部>:<内部>。例如，-p 8080:80 会将容器内的端口 80 暴露到主机IP的 8080 端口。
| 参数 | 功能 |
|---|---|
-p 4040 | 应用Web界面 |
-e PUID=1000 | 用户ID - 详见下方说明 |
-e PGID=1000 | 组ID - 详见下方说明 |
-e TZ=Europe/London | 指定时区，例如 Europe/London |
-e CONTEXT_PATH=url-base | 用于反向代理等的基础URL |
-v /config | 配置文件目录 |
-v /audiobooks | 有声书目录 |
-v /podcasts | 播客目录 |
-v /othermedia | 其他媒体目录 |
来自文件的环境变量（Docker secrets）
您可以使用特殊前缀 FILE__ 从文件设置任何环境变量。例如：
bash-e FILE__PASSWORD=/run/secrets/mysecretpassword
这将根据 /run/secrets/mysecretpassword 文件的内容设置环境变量 PASSWORD。
应用运行的Umask
对于所有镜像，我们提供通过可选的 -e UMASK=022 设置来覆盖容器内服务的默认umask设置。请注意，umask不是chmod，它基于其值减去权限而非添加。请在请求支持前查阅相关资料。
用户/组标识符
使用卷（-v 标志）时，主机OS和容器之间可能出现权限问题。我们通过允许您指定用户 PUID 和组 PGID 来避免此问题。确保主机上的任何卷目录由您指定的相同用户拥有，权限问题将迎刃而解。
在此示例中 PUID=1000 和 PGID=1000，要查找您的ID，请使用 id user：
bash$ id username uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
Docker模块
我们发布了各种https://github.com/linuxserver/docker-mods，以启用容器内的附加功能。可通过上方动态徽章访问此镜像可用的模块列表（如有）以及可应用于任何LinuxServer.io镜像的通用模块。
支持信息
- 容器运行时的Shell访问：
docker exec -it booksonic /bin/bash - 实时监控容器日志：
docker logs -f booksonic - 容器版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' booksonic - 镜像版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' ghcr.io/linuxserver/booksonic
更新信息
我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器才能更新内部应用。除部分例外（如nextcloud、plex），我们不建议或支持在容器内更新应用。请查阅上方应用设置部分，了解是否推荐针对此镜像进行应用更新。
以下是更新容器的说明：
通过Docker Compose
- 更新所有镜像：
docker-compose pull- 或更新单个镜像：
docker-compose pull booksonic
- 或更新单个镜像：
- 让compose按需更新所有容器：
docker-compose up -d- 或更新单个容器：
docker-compose up -d booksonic
- 或更新单个容器：
- 您还可以删除旧的悬空镜像：
docker image prune
通过Docker Run
- 更新镜像：
docker pull ***-ghcr.xuanyuan.run/linuxserver/booksonic - 停止运行中的容器：
docker stop booksonic - 删除容器：
docker rm booksonic - 使用上述相同的docker run参数重新创建新容器（如果正确映射到主机文件夹，您的
/config文件夹和设置将被保留） - 您还可以删除旧的悬空镜像：
docker image prune
通过Watchtower自动更新器（仅在忘记原始参数时使用）
-
拉取最新标签镜像并使用相同环境变量替换：
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ docker.xuanyuan.run/containrrr/watchtower \ --run-once booksonic -
您还可以删除旧的悬空镜像：
docker image prune
注意： 我们不认可使用Watchtower作为现有Docker容器自动更新的解决方案。事实上，我们通常不鼓励自动更新。但是，对于您忘记原始参数的容器，这是一个有用的一次性手动更新工具。长期来看，我们强烈建议使用https://docs.linuxserver.io/general/docker-compose。
镜像更新通知 - Diun（Docker镜像更新通知器）
- 我们推荐使用https://crazymax.dev/diun/获取更新通知。不推荐或支持其他自动更新容器的工具。
本地构建
如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑：
bashgit clone https://github.com/linuxserver/docker-booksonic.git cd docker-booksonic docker build \ --no-cache \ --pull \ -t ghcr.io/linuxserver/booksonic:latest .
可使用 multiarch/qemu-user-static 在x86_64硬件上构建ARM变体：
bashdocker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset
注册后，您可以使用 -f Dockerfile.aarch64 指定要使用的dockerfile。
版本历史
- 11.08.20: - 更改上游GitHub仓库位置
- 22.12.19: - 恢复拉取外部war包，升级jetty
- 30.04.19: - 切换为从源代码构建war包，使用稳定的Booksonic版本
- 24.03.19: - 切换到新基础镜像，迁移到arm32v7标签
- 16.01.19: - 添加流水线逻辑和多架构支持
- 05.01.19: - 修复代码规范问题
- 27.08.18: - 基于Ubuntu Bionic重建
- 06.12.17: - 基于Alpine 3.7重建
- 11.07.17: - 基于Alpine 3.6重建
- 07.02.17: - 基于Alpine 3.5重建
- 13.12.16: - 初始发布
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 booksonic 镜像标签
docker pull docker.xuanyuan.run/lsiodev/booksonic:<标签>
DockerHub 原生拉取命令
docker pull lsiodev/booksonic:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"