speranza/supysonic-pg

speranza/supysonic-pg镜像说明

这是Docker化的Supysonic PostgreSQL版本镜像，包含文件监控功能（watcher），基于https://github.com/spl0k/supysonic%E5%92%8Chttps://github.com/mikafouenski/docker-supysonic%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%BA%95%E5%B1%82%E9%87%87%E7%94%A8Alpine%E7%B3%BB%E7%BB%9F%E5%92%8CS6 overlay。

核心功能

• 提供音乐流媒体服务，支持Web界面访问
• 集成PostgreSQL数据库存储元数据
• 内置文件监控器，自动刷新音乐库内容
• 支持多线程处理（可通过WORKERS变量配置）
• 允许通过CLI管理用户、文件夹等资源

使用场景

• 个人用户搭建私有音乐库，随时随地访问音乐收藏
• 小型团队共享音乐资源，实现内部流媒体服务

配置说明

Docker容器创建命令

bash
docker create \
    --name supysonic \
    -p 8000:8000 \
    -e PUID=<用户ID> -e PGID=<组ID> \
    -e WORKERS=<线程数> \ 
    -e WATCHER=0 \ 
    -v </path/to/supysonic.conf>:/etc/supysonic.conf \
    -v <音乐目录路径>:/media:ro \
    speranza/supysonic-pg

参数解释：

• -p 8000:8000：映射容器8000端口到主机，用于Web界面访问
• -v /etc/supysonic.conf：挂载Supysonic配置文件
• -v /media：挂载主机音乐目录（ro为只读）
• -e PGID/PUID：指定组/用户ID，解决权限问题（默认2000）
• -e WORKERS：线程数（默认4）
• -e WATCHER：是否启动监控器（默认1，建议开启）

Docker Compose示例

yaml
supysonic:
  image: 'docker.xuanyuan.run/speranza/supysonic-pg'
  container_name: 'supysonic'
  restart: 'unless-stopped'
  environment:
    - PUID=<用户ID>
    - PGID=<组ID>
  volumes:
    - '</path/to/supysonic.conf>:/etc/supysonic.conf'
    - '<音乐目录路径>:/media'
  ports:
    - 8000:8000
postgres:
  image: docker.xuanyuan.run/postgres:10.5
  restart: always
  volumes:
    - /path/to/pg/data:/var/lib/postgresql/data
    - /path/to/postgres.conf:/etc/postgres.conf
    - /path/to/pg_hba.conf:/etc/pg_hba.conf
  command: postgres -c config_file=/etc/postgres.conf
  ports:
    - 5432:5432
  environment:
    POSTGRES_USER: postgres
    POSTGRES_PASSWORD: postgres

注：原示例中Postgres端口映射错误，修正为默认端口5432。

用户/组ID获取

通过id <用户名>命令获取PUID和PGID：

bash
$ id dockeruser
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

应用初始化

容器运行后，通过CLI创建用户和文件夹：

bash
docker exec -it supysonic supysonic-cli

示例操作：

• 创建管理员：user add -a <用户名>
• 添加音乐文件夹：folder add Music /media，然后扫描：folder scan Music 更多命令参考https://github.com/spl0k/supysonic/blob/master/docs/cli.md

访问Web界面

浏览器访问<你的IP>:8000进入管理界面。