opensoundstream/oss-server

OpenSoundStream Server

项目主页：https://github.com/Open-Sound-Stream-Organization/oss-server

镜像概述

OpenSoundStream是一个用于管理和收听私人音乐收藏的系统，除网站外，还提供Android和Windows原生客户端。该系统设计为自托管应用，内置多用户功能，可与朋友共享使用。本镜像为其官方Docker容器，提供便捷的部署方式。

核心功能与特性

• 私人音乐管理：集中管理个人音乐收藏
• 多用户支持：内置用户系统，支持多人共享服务器
• 跨平台访问：提供网站界面及Android/Windows客户端
• 数据持久化：通过Docker卷实现数据库持久化存储
• 灵活部署：支持直接部署或结合反向代理使用

使用场景

• 个人自托管音乐服务器，随时随地访问私人音乐库
• 家庭或小团体共享音乐收藏，支持多用户独立使用
• 需要隐私保护的音乐存储与播放解决方案

部署与使用方法

基本部署命令

推荐使用Docker容器部署，命令如下：

bash
docker run -d -p 8099:8000 \
    --mount source=oss-server-db,target=/oss_server/db \
    --name oss-server \
    opensoundstream/oss-server:alpine

参数说明

• -d：后台运行容器
• -p 8099:8000：将容器内8000端口（HTTP接口）映射到本地8099端口，本地端口可修改为任意空闲端口
• --mount source=oss-server-db,target=/oss_server/db：使用Docker卷持久化SQLite数据库，即使容器删除重建，数据仍可保留
• --name oss-server：为容器命名，便于后续管理
• opensoundstream/oss-server:alpine：指定使用Alpine版本镜像，本地若无则从Docker Hub拉取

额外配置参数

• -e DJANGO_HOST=my-domain.tld：添加自定义域名到允许的主机列表（不推荐直接暴露端口时使用，建议通过反向代理部署）。默认允许localhost和127.0.0.1

Apache反向代理配置

强烈建议使用TLS加密，以下是Apache反向代理配置示例：

apache
<VirtualHost *:443>  # 强烈建议使用TLS加密
    ServerName my-domain.tld  
    ProxyPass / http://localhost:8099/  
    ProxyPassReverse / http://localhost:8099/
    
    # Let's Encrypt配置
    Include /etc/letsencrypt/options-ssl-apache.conf 
    SSLCertificateFile /etc/letsencrypt/live/my-domain.tld-0001/fullchain.pem 
    SSLCertificateKeyFile /etc/letsencrypt/live/my-domain.tld-0001/privkey.pem
</VirtualHost>

API文档

API文档可参考https://github.com/Open-Sound-Stream-Organization/oss-server/blob/master/api-doc.md