项目简介

SPlayer(Github项目地址) 是一款开源的 Web 端音乐播放器，支持网易云音乐账号登录、逐字歌词、歌曲下载、歌单管理、音乐云盘等功能，界面简洁典雅，动画流畅，无广告，支持移动端适配，可通过 Docker 快速部署，适合搭建私人音乐播放服务。

部署准备

部署前需确保服务器已安装 Docker 与 Docker Compose，若未安装，可参考官方文档完成环境配置。硬件建议最低配置 512MB 内存，推荐 1GB 及以上以保证运行流畅。

单命令快速部署

该方式适合快速启动服务，执行以下命令即可拉取官方镜像并启动容器。

# 拉取官方镜像
docker pull imsyy/splayer:latest
#也可使用三方镜像
# 启动容器
docker run -d \
  --name splayer \
  --restart unless-stopped \
  -p 25884:25884 \
  -e TZ=Asia/Shanghai \
  imsyy/splayer:latest

命令说明：

--name：指定容器名称，方便管理
--restart：设置容器开机自启
-p：端口映射，格式为宿主机端口：容器内部端口
-e TZ：设置时区为上海

Docker Compose 部署（推荐）

使用 Docker Compose 可统一管理配置，便于后续维护，操作步骤如下。

mkdir -p /opt/splayer && cd /opt/splayer

新建 docker-compose.yml 配置文件

vim docker-compose.yml

写入以下配置内容

version: '3.9'
services:
  splayer:
    image: imsyy/splayer:latest
    container_name: splayer
    restart: unless-stopped
    network_mode: bridge
    environment:
      - TZ=Asia/Shanghai
    ports:
      - "25884:25884"

启动服务

docker-compose up -d

执行后容器会后台运行，无报错即部署成功。

服务访问与初始使用

部署完成后，通过浏览器访问服务地址：http:// 服务器 IP:25884。打开页面后可使用网易云音乐账号扫码登录，登录后即可同步个人歌单、播放历史，使用歌曲播放、歌词展示、下载等功能。

容器管理常用命令

# 查看容器运行状态
docker ps | grep splayer
# 重启容器
docker restart splayer
# 停止容器
docker stop splayer
# 删除容器（需先停止）
docker rm splayer
# 查看容器日志
docker logs -f splayer