Docker部署：洛雪音乐网页版

🎵 什么是洛雪音乐网页版

洛雪音乐是一款功能强大的音乐播放器，网页版让你可以在任何浏览器中享受音乐，无需安装客户端。它支持多平台音乐搜索、歌单管理、歌词显示、主题定制等功能，还能作为数据同步服务端。

🐳 Docker部署准备
首先确保你的服务器或本地电脑已经安装了Docker和Docker Compose。如果还没安装，可以参考官方文档：

• Docker：https://docs.docker.com/get-docker/
• Docker Compose：https://docs.docker.com/compose/install/

📝 部署方案一：Docker Compose

version: '3'
services:
  lx-music:
    image: ghcr.io/xcq0607/lxserver:latest
    container_name: lx-music
    ports:
      - "9527:9527"
    volumes:
      - ./data:/server/data
      - ./logs:/server/logs
    environment:
      - PORT=9527
      - BIND_IP=0.0.0.0
      - FRONTEND_PASSWORD=123456  # 管理后台密码
      - ENABLE_WEBPLAYER_AUTH=false  # 是否启用Web播放器访问密码
      - WEBPLAYER_PASSWORD=123456  # Web播放器访问密码
      - SERVER_NAME=My Music Server  # 服务器名称
    restart: unless-stopped

📝 部署方案二：Docker命令

如果你习惯使用Docker命令直接部署，可以执行以下命令：

docker run -d \
  --name lx-music \
  -p 9527:9527 \
  -v $(pwd)/data:/server/data \
  -v $(pwd)/logs:/server/logs \
  -e PORT=9527 \
  -e BIND_IP=0.0.0.0 \
  -e FRONTEND_PASSWORD=123456 \
  -e ENABLE_WEBPLAYER_AUTH=false \
  -e WEBPLAYER_PASSWORD=123456 \
  -e SERVER_NAME="My Music Server" \
  --restart unless-stopped \
  ghcr.io/xcq0607/lxserver:latest

Windows PowerShell用户：使用以下命令

docker run -d `
  --name lx-music `
  -p 9527:9527 `
  -v ${PWD}/data:/server/data `
  -v ${PWD}/logs:/server/logs `
  -e PORT=9527 `
  -e BIND_IP=0.0.0.0 `
  -e FRONTEND_PASSWORD=123456 `
  -e ENABLE_WEBPLAYER_AUTH=false `
  -e WEBPLAYER_PASSWORD=123456 `
  -e SERVER_NAME="My Music Server" `
  --restart unless-stopped `
  ghcr.io/xcq0607/lxserver:latest

🔧 配置说明

• 端口映射：默认映射9527端口，可根据需要修改
• 数据持久化：通过volumes挂载数据和日志目录，确保数据不会丢失
• 环境变量：
  • FRONTEND_PASSWORD：管理后台登录密码
  • ENABLE_WEBPLAYER_AUTH：是否启用Web播放器访问密码
  • WEBPLAYER_PASSWORD：Web播放器访问密码
  • SERVER_NAME：服务器名称

🌐 访问方式

• Web播放器：http://你的IP:9527/music
• 管理后台：http://你的IP:9527 (默认密码: 123456)

⚙️ 高级配置

如果你需要更高级的配置，可以在 docker-compose.yml 文件中添加以下环境变量：

environment:
  # 基本配置
  - PORT=9527
  - BIND_IP=0.0.0.0
  - FRONTEND_PASSWORD=123456
  - SERVER_NAME=My Music Server
  
  # Web播放器配置
  - ENABLE_WEBPLAYER_AUTH=false
  - WEBPLAYER_PASSWORD=123456
  
  # 数据管理
  - MAX_SNAPSHOT_NUM=10
  - DATA_PATH=/server/data
  - LOG_PATH=/server/logs
  
  # 用户管理
  - USER_ENABLE_ROOT=false
  - USER_ENABLE_PATH=true
  - ENABLE_PUBLIC_USER_RESTRICTION=true
  
  # WebDAV备份
  - WEBDAV_URL=
  - WEBDAV_USERNAME=
  - WEBDAV_PASSWORD=
  - SYNC_INTERVAL=60
  
  # 其他
  - DISABLE_TELEMETRY=false
  - LIST_ADD_MUSIC_LOCATION_TYPE=top
  
  # 快速添加用户 (格式: LX_USER_用户名=密码)
  - LX_USER_test=123456

📱 移动端适配

洛雪音乐网页版针对移动端进行了深度优化，手机浏览器访问也能获得原生App般的体验。

🔒 安全设置

为了保护你的隐私，建议：

1. 修改默认密码
2. 启用Web播放器访问密码
3. 如果是公网部署，考虑使用反向代理并配置HTTPS

🎨 功能亮点

• 现代化界面：支持深色模式，提供极致视觉体验
• 多源搜索：聚合搜索各大音乐平台资源
• 歌单管理：支持多平台歌单浏览、搜索与一键播放
• 强大的播放控制：支持播放模式切换、音质选择、歌词显示等
• 缓存管理：内置全自动化缓存系统，提升弱网环境下的播放流畅度
• 歌词卡片分享：支持自定义卡片比例、色彩风格及歌词行数
• 主题定制：支持多套现代化主题，并可根据系统自动切换暗亮模式
• 自定义源管理：支持导入自定义源脚本，扩展更多音乐来源

❓ 常见问题

1. 服务启动失败：检查端口是否被占用，查看日志 docker logs lx-music
2. 无法访问：检查防火墙设置，确保9527端口已开放
3. 音乐无法播放：检查网络连接，可能需要配置代理
4. 数据丢失：确保正确挂载了数据目录，定期备份

📚 参考资料

• 洛雪音乐GitHub仓库：https://github.com/XCQ0607/lxserver
• Docker官方文档：https://docs.docker.com/
• Docker Compose官方文档：https://docs.docker.com/compose/