Lx-music-server

Lx-music-server 是一个音乐资源代理服务器，可以为 LX Music APP 提供音乐搜索、音源获取等功能。它使用 Docker 方式部署简单，运行稳定，能够帮助你更好地使用 LX Music 客户端。

官方网站

Lx-music-server 的官方仓库地址：https://github.com/lxmusics/lx-music-api-server

LX Music 客户端官方仓库：https://github.com/lyswhut/lx-music-desktop

Docker方式安装

推荐使用 Docker Compose 方式进行安装和管理，下面是详细步骤。

compose文件

创建 compose.yml 文件，内容如下：

version: '3'
services:
  lx-music-server:
    image: lxmusics/lx-music-api-server:latest
    container_name: lx-music-server
    restart: always
    ports:
      - "9763:9763"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai
    env_file:
      - .env

env文件

在同一目录下创建 .env 文件，用于配置服务器参数：

# 服务器端口，默认为9763
PORT=9763

# 是否启用白名单，设置为true时仅允许白名单内的应用访问
WHITELIST_ENABLE=false

# 日志级别，可设置为info、warn、error、debug等
LOG_LEVEL=info

# 代理设置，如需使用代理可以取消注释并配置
# PROXY_ENABLE=true
# HTTP_PROXY=http://127.0.0.1:7890
# HTTPS_PROXY=http://127.0.0.1:7890

启动

执行以下命令启动服务：

docker compose up -d

启动后，服务将在后台运行，可通过 http://你的IP:9763 访问。

配置文件

服务启动后，会在 ./data 目录下生成配置文件 config.js，你可以手动编辑此文件进行更多高级配置。主要配置项包括：

白名单设置
代理设置
请求超时设置
音源配置
缓存设置

注意：修改配置文件后需要重启服务才能生效。

重新启动

如果修改了配置，可以使用以下命令重启服务：

docker compose restart

备注

首次使用时，建议在 LX Music 客户端中设置自定义 API 地址为 http://你的IP:9763
如果遇到连接问题，请检查：
- 服务器防火墙是否开放了 9763 端口
- 配置文件中的白名单设置是否正确
- 网络环境是否需要配置代理
服务日志可通过以下命令查看：
```
docker compose logs -f
```
建议定期更新镜像以获取最新功能和修复：
```
docker compose pull
docker compose up -d
```

官方网站​

Docker方式安装​

compose文件​

env文件​

启动​

配置文件​

重新启动​

备注​