airsonicadvanced/airsonic-advanced

Airsonic-Advanced Docker镜像

镜像概述和主要用途

Airsonic-Advanced Docker镜像是官方提供的容器化部署方案。Airsonic-Advanced是一款免费的基于Web的媒体流服务器，旨在提供对音乐的无处不在的访问。它是Airsonic分支的现代化实现，通过多项关键性能优化和功能增强，添加并取代了Airsonic的部分功能。

项目地址：https://github.com/airsonic-advanced/airsonic-advanced

核心功能和特性

• 免费开源的Web媒体流服务，支持音乐访问
• 相比Airsonic具有更现代的实现，性能更优
• 增强的功能集，支持音乐、播客、播放列表管理
• 支持自定义用户和权限配置
• 可与外部数据库（如Postgres）集成

使用场景和适用范围

• 个人音乐库管理和远程访问
• 家庭内部媒体流服务
• 需要便捷音乐流媒体解决方案的用户
• 寻求Airsonic替代方案并需要更多功能的用户

标签说明

• latest: 最新发布版（稳定版或边缘版）[推荐使用]
• edge-latest: 最新快照版
• stable: 最新稳定版
• _x_: 主要版本x下的最新稳定版（例如10可能对应v10.6.0）
• _x.y_: 主要版本x和次要版本y下的最新稳定版（例如10.6可能对应v10.6.0）
• _x.y.z_: 指定的补丁版本（例如10.6.0对应v10.6.0）
• stable-x.y.z: 与上述_x.y.z_相同
• gitcommit-sha: 特定SHA提交的版本
• gitrun-id: 按gitrun标记的版本

使用方法和配置说明

注意事项

自提交44c240ad3fe3（对应镜像如edge-10.6.0-SNAPSHOT.20200303042240、travisbuild-374、gitcommit-587b4be2e66d7fad839de218969fe0cc8c35508c）之后，Docker挂载点与原版Airsonic不同。在此之前（含这些构建），挂载点与原版Airsonic相同。

用户运行设置

默认情况下，镜像以root用户（uid 0）和root组（gid 0）运行。自提交6c9a7c2891（对应镜像如edge-11.0.0-SNAPSHOT.20200430182823、gitcommit-6c9a7c28918355bc508c8e07fa8ee8475ff87ef3、gitrun-92425995）起，可通过以下两种方式指定自定义用户：

1. 执行docker run命令时使用--user（-u）参数，格式为uid:gid
2. 执行docker run命令时通过环境变量PUID和PGID指定（-e PUID=uid -e PGID=gid）

Docker Run示例

bash
docker run \
    -d \
    -u 1000:1000 \
    -e TZ=America/Los_Angeles \
    -e JAVA_OPTS=-Dserver.forward-headers-strategy=native \
    -p 4040:4040 \
    -p 4041:4041 \
    -v /host/path/to/my/music:/var/music \
    -v /host/path/to/my/podcasts:/var/podcasts \
    -v /host/path/to/my/playlists:/var/playlists \
    -v /host/path/to/my/data:/var/airsonic \
    --restart unless-stopped \
    airsonicadvanced/airsonic-advanced:latest

Docker Compose示例

基础配置：

yaml
version: "3"

services:
  airsonic-advanced:
    container_name: airsonic-advanced
    image: airsonicadvanced/airsonic-advanced:latest
    restart: unless-stopped
    ports: 
      - 4040:4040
      - 4041:4041 # UPnP
    user: pid:gid # 可选 - 指定运行用户
    environment:
      TZ: America/Los_Angeles # 可选 - 日志使用本地时区
      JAVA_OPTS: '-Dserver.forward-headers-strategy=native' # 可选 - 若使用反向代理
    volumes:
      - /host/path/to/my/playlists:/var/playlists
      - /host/path/to/my/podcasts:/var/podcasts
      - /host/path/to/my/data:/var/airsonic
      - /host/path/to/my/music:/var/music

外部数据库配置（如Postgres）

yaml
version: "3.9"
   
services:
  db:
    image: postgres:latest
    volumes:
      - /host/path/to/db/data:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
  airsonic:
    image: airsonicadvanced/airsonic-advanced:latest
    environment:
      spring_datasource_url: 'jdbc:postgresql://db:5432/postgres?stringtype=unspecified&raiseExceptionOnSilentRollback=false'
      spring_datasource_username: postgres
      spring_datasource_password: postgres
      spring_liquibase_parameters_userTableQuote: '"'
    volumes:
      - /host/path/to/my/music:/var/music
      - /host/path/to/my/podcasts:/var/podcasts
      - /host/path/to/my/playlists:/var/playlists
      - /host/path/to/airsonic/data:/var/airsonic
    ports:
      - 4040:4040
      - 4041:4041
    depends_on:
      - db