LX Music Sync Server Docker镜像文档

镜像概述

本镜像为LX Music Sync Server的Docker化部署方案，旨在提供便捷、高效的音乐同步服务部署方式。通过容器化技术，可快速搭建支持跨设备音乐文件同步与管理的服务，简化传统部署中的环境配置复杂度，适用于个人或小型团队的音乐库同步需求。

核心功能与特性

• 音乐文件同步：支持本地音乐文件与远程设备间的双向同步，保持音乐库一致性
• 轻量管理界面：内置Web管理界面，可直观管理同步任务、音乐文件元数据及设备连接
• 跨平台兼容：基于Docker容器，支持在Linux、Windows、macOS等主流操作系统运行
• 数据持久化：支持通过卷挂载保存音乐文件与配置数据，避免容器重启导致数据丢失
• 自定义同步策略：可配置同步间隔、文件过滤规则（如格式、大小限制）等参数

使用场景

• 个人音乐库管理：搭建私人音乐同步服务，实现手机、电脑、平板等设备间的音乐无缝访问
• 家庭音乐共享：家庭内部多设备共享音乐资源，无需依赖第三方云服务
• 小型工作室协作：音乐创作者团队共享素材库，保持创作文件版本同步

使用方法

基础部署（Docker Run）

docker run -d \
  --name lx-music-sync \
  -p 8080:8080 \  # 映射Web管理界面端口
  -v /path/to/local/music:/app/music \  # 挂载本地音乐目录
  -v /path/to/config:/app/config \  # 挂载配置文件目录（持久化配置）
  -e PORT=8080 \  # 服务监听端口（默认8080）
  -e SYNC_INTERVAL=300 \  # 同步间隔（秒，默认300）
  lxmusic/sync-server:latest

Docker Compose部署

创建docker-compose.yml文件：

version: '3'
services:
  lx-music-sync:
    image: lxmusic/sync-server:latest
    container_name: lx-music-sync
    ports:
      - "8080:8080"
    volumes:
      - ./local-music:/app/music
      - ./server-config:/app/config
    environment:
      - PORT=8080
      - SYNC_INTERVAL=300
      - LOG_LEVEL=info
    restart: unless-stopped

启动服务：

docker-compose up -d

环境变量配置

持久化存储

为避免容器重启导致数据丢失，需挂载以下目录：

• /app/music：存储同步的音乐文件（建议本地目录挂载）
• /app/config：存储服务配置文件（含设备列表、同步规则等）

访问服务

部署完成后，通过 http://<服务器IP>:<PORT> 访问Web管理界面，首次访问需完成初始化配置（如管理员账号设置、默认同步目录指定等）。

注意事项

• 确保挂载的本地目录有读写权限，避免权限问题导致同步失败
• 网络环境需支持设备间通信（如家庭局域网内设备需在同一网段）
• 大文件同步建议优化网络带宽，或调整同步间隔以避免资源占用过高