热门搜索:
linuxserver/airsonic
LinuxServer.io提供的Airsonic容器，这是一个免费的基于Web的媒体流服务器，用于访问和共享音乐。【注意：此镜像已弃用，推荐使用airsonic-advanced】
让 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/airsonic
https://github.com/airsonic/airsonic 是一个免费的基于Web的媒体流服务器，可让您随时随地访问音乐。您可以使用它与朋友共享音乐，或在工作时收听自己的音乐。它支持同时向多个播放器流式传输，例如一个在厨房，另一个在客厅。
弃用通知
此镜像已弃用。我们将不再为此镜像提供支持，也不会更新它。建议改用我们的airsonic-advanced镜像：https://github.com/linuxserver/docker-airsonic-advanced
LinuxServer.io团队特点
LinuxServer.io团队提供的容器具有以下特点：
- 定期及时的应用更新
- 简单的用户映射（PGID、PUID）
- 带有s6覆盖层的自定义基础镜像
- 每周基础操作系统更新，整个LinuxServer.io生态系统共享通用层，以最小化空间使用、停机时间和带宽
- 定期安全更新
支持的架构
我们的镜像支持多种架构，如x86-64、arm64和armhf。我们利用docker manifest实现多平台识别。只需拉取lscr.io/linuxserver/airsonic即可获取适合您架构的正确镜像，您也可以通过标签拉取特定架构的镜像。
此镜像支持的架构：
| 架构 | 标签 |
|---|---|
| x86-64 | amd64-latest |
| arm64 | arm64v8-latest |
| armhf | arm32v7-latest |
应用设置
通过 <your-ip>:4040 访问Web界面。
默认用户/密码为 admin/admin。
可以通过JAVA_OPTS环境变量传递额外的Java选项，例如 -e JAVA_OPTS="-Xmx256m -Xms256m"。对于某些反向代理，您可能需要传递 JAVA_OPTS=-Dserver.use-forward-headers=true，以便Airsonic生成正确的URL方案。
请注意，如果您想使用https://airsonic.github.io/docs/jukebox/%EF%BC%8C%E5%88%99%60PGID%60%E9%9C%80%E8%A6%81%E4%B8%8E%E6%82%A8%E7%9A%84%E5%A3%B0%E9%9F%B3%E8%AE%BE%E5%A4%87%EF%BC%88%E4%BE%8B%E5%A6%82%60/dev/snd%60%EF%BC%89%E7%9A%84%E7%BB%84%E5%8C%B9%E9%85%8D%E3%80%82
使用方法
以下是一些示例代码片段，帮助您开始创建容器。
docker-compose（推荐，点击此处了解更多信息）
yaml--- version: "2.1" services: airsonic: image: lscr.io/linuxserver/airsonic container_name: airsonic environment: - PUID=1000 - PGID=1000 - TZ=Europe/London - CONTEXT_PATH=<URL_BASE> #可选 - JAVA_OPTS=<options> #可选 volumes: - </path/to/config>:/config - </path/to/music>:/music - </path/to/playlists>:/playlists - </path/to/podcasts>:/podcasts - </path/to/other media>:/media #可选 ports: - 4040:4040 devices: - /dev/snd:/dev/snd #可选 restart: unless-stopped
docker cli（点击此处了解更多信息）
bashdocker run -d \ --name=airsonic \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ -e CONTEXT_PATH=<URL_BASE> `#可选` \ -e JAVA_OPTS=<options> `#可选` \ -p 4040:4040 \ -v </path/to/config>:/config \ -v </path/to/music>:/music \ -v </path/to/playlists>:/playlists \ -v </path/to/podcasts>:/podcasts \ -v </path/to/other media>:/media `#可选` \ --device /dev/snd:/dev/snd `#可选` \ --restart unless-stopped \ lscr.io/linuxserver/airsonic
参数
容器镜像通过运行时传递的参数进行配置（如上所示）。这些参数用冒号分隔，表示<外部>:<内部>。例如，-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基础路径 |
-e JAVA_OPTS=<options> | 用于传递额外的Java选项 |
-v /config | 配置文件位置 |
-v /music | 音乐文件位置 |
-v /playlists | 播放列表保存位置 |
-v /podcasts | 播客文件位置 |
-v /media | 其他媒体文件位置（可选） |
--device /dev/snd | 仅当需要Airsonic的Java jukebox播放器时，传递主机声音设备 |
环境变量从文件（Docker secrets）
您可以通过使用特殊的前缀FILE__从文件中设置任何环境变量。
例如：
bash-e FILE__PASSWORD=/run/secrets/mysecretpassword
这将根据/run/secrets/mysecretpassword文件的内容设置PASSWORD环境变量。
应用运行的Umask
对于我们所有的镜像，您可以使用可选的-e UMASK=022设置来覆盖容器内服务启动时的默认umask设置。请注意，umask不是chmod，它基于其值减去权限，而不是添加。请在请求支持前阅读相关内容。
用户/组ID
使用卷（-v标志）时，主机操作系统和容器之间可能会出现权限问题，我们通过允许您指定用户PUID和组PGID来避免此问题。
确保主机上的任何卷目录都归您指定的相同用户所有，权限问题将迎刃而解。
在本例中PUID=1000和PGID=1000，要查找您的ID，请使用id user命令：
bash$ id username uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
Docker Mods
我们发布了各种https://github.com/linuxserver/docker-mods%EF%BC%8C%E4%BB%A5%E5%90%AF%E7%94%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%9A%84%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E4%B8%8A%E6%96%B9%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E8%AE%BF%E9%97%AE%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E7%9A%84%E6%A8%A1%E5%9D%97%E5%88%97%E8%A1%A8%EF%BC%88%E5%A6%82%E6%9C%89%EF%BC%89%E4%BB%A5%E5%8F%8A%E5%8F%AF%E5%BA%94%E7%94%A8%E4%BA%8E%E6%88%91%E4%BB%AC%E4%BB%BB%E4%BD%95%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8%E6%A8%A1%E5%9D%97%E3%80%82
支持信息
- 容器运行时的Shell访问：
docker exec -it airsonic /bin/bash - 实时监控容器日志：
docker logs -f airsonic - 容器版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' airsonic - 镜像版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/airsonic
更新信息
我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器才能更新内部应用。除某些例外（如nextcloud、plex），我们不建议或支持在容器内更新应用。请参考上方的应用设置部分，了解是否推荐对此镜像进行应用更新。
以下是更新容器的说明：
通过Docker Compose
- 更新所有镜像：
docker-compose pull- 或更新单个镜像：
docker-compose pull airsonic
- 或更新单个镜像：
- 让Compose按需更新所有容器：
docker-compose up -d- 或更新单个容器：
docker-compose up -d airsonic
- 或更新单个容器：
- 您还可以删除旧的悬空镜像：
docker image prune
通过Docker Run
- 更新镜像：
docker pull lscr.io/linuxserver/airsonic - 停止运行中的容器：
docker stop airsonic - 删除容器：
docker rm airsonic - 使用上述相同的docker run参数重新创建新容器（如果正确映射到主机文件夹，您的
/config文件夹和设置将被保留） - 您还可以删除旧的悬空镜像：
docker image prune
通过Watchtower自动更新器（仅在您不记得原始参数时使用）
-
拉取最新标签的镜像并使用相同的环境变量替换它：
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once airsonic -
您还可以删除旧的悬空镜像：
docker image prune
注意： 我们不认可将Watchtower用作现有Docker容器自动更新的解决方案。事实上，我们通常不鼓励自动更新。但是，对于您忘记原始参数的容器，这是一个有用的一次性手动更新工具。从长远来看，我们强烈建议使用Docker Compose。
镜像更新通知 - Diun（Docker镜像更新通知器）
- 我们推荐使用Diun进行更新通知。不建议或支持其他自动更新容器的工具。
本地构建
如果您想为开发目的或自定义逻辑对这些镜像进行本地修改：
bashgit clone https://github.com/linuxserver/docker-airsonic.git cd docker-airsonic docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/airsonic:latest .
可以使用multiarch/qemu-user-static在x86_64硬件上构建ARM变体：
bashdocker run --rm --privileged multiarch/qemu-user-static:register --reset
注册后，您可以使用-f Dockerfile.aarch64指定要使用的dockerfile。
版本历史
- 13.01.22： - 弃用，推荐使用airsonic-advanced。
- 24.03.19： - 切换到新的基础镜像，迁移到arm32v7标签。
- 26.01.19： - 添加流水线逻辑和多架构支持。
- 05.01.19： - 修复代码规范问题。
- 27.08.18： - 使用新的内部Java基础镜像以加快构建速度。
- 23.08.18： - 重新基于Ubuntu Bionic，以提高所有架构的性能。
- 22.04.18： - 在运行命令中添加被遗忘的JAVA_OPTS。
- 29.12.17： - 初始发布。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 airsonic 镜像标签
docker pull docker.xuanyuan.run/linuxserver/airsonic:<标签>
DockerHub 原生拉取命令
docker pull linuxserver/airsonic:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"