LyricBridge

Self-hosted

自托管部署

部署完成后，进入后台创建 API Key，再把歌词接口地址填入播放器。

Docker 部署

  1. 准备一个本机目录作为音乐目录，例如 /home/user/music。
  2. 运行容器并映射端口、音乐目录和持久化数据卷。
  3. 打开 /admin，使用管理员账号登录后台。
  4. 在 API Key 管理页面创建播放器专用密钥。
docker run -d \
  --name lyricbridge \
  -p 5677:5677 \
  -v /home/user/music:/music:ro \
  -v lyricbridge-appdata:/app/appdata \
  -e ADMIN_PASSWORD=admin12345 \
  -e API_MEDIA_ROOT=/music \
  zo1ne/lyricbridge:latest

源码运行

适合本地开发或临时测试。生产环境建议使用 Docker，并为 ADMIN_PASSWORD 设置强密码。

pip install -r requirements.txt
ADMIN_PASSWORD=admin12345 python3 app.py --port 5677 --auth your-legacy-api-key

播放器配置

播放器请求歌词时，在请求头中携带后台创建的 API Key：

Authorization: 你的API KEY

常用歌词地址：