Deployment · 部署教程

自己动手，把音乐库带回家

LyraNest 服务端是 Go 编写的轻量镜像，Docker Compose 一键部署；飞牛 NAS 用户还可使用原生 FPK 安装包。以下为完整部署与使用教程。

在线部署

服务器能访问外网时，用官方发布的一键命令拉取镜像并启动。

terminal

# 创建目录并进入
mkdir -p lyranest && cd lyranest
curl -fLO https://github.com/WHWgogogo/LyraNest/releases/latest/download/docker-compose.yml
curl -fL https://github.com/WHWgogogo/LyraNest/releases/latest/download/LyraNest.env.example -o .env
mkdir -p music downloads data cache
docker compose up -d
# 首次拉取镜像约需几分钟

离线部署

设备不能联网时，用离线镜像包导入并启动，无需访问镜像仓库。

terminal

# 下载以下文件到同一目录
LyraNest-0.2.4-docker-linux-amd64.tar.gz
docker-compose.yml
LyraNest.env.example
 
mkdir -p lyranest && cd lyranest
docker load -i LyraNest-0.2.4-docker-linux-amd64.tar.gz
docker tag lyranest-server:prebuilt ghcr.io/whwgogogo/lyranest-server:0.2.4
mkdir -p music downloads data cache
docker compose up -d --pull never

飞牛 fnOS

飞牛 NAS 用户使用原生 FPK 安装包，在应用中心手动安装。

terminal

# 1. 下载对应的飞牛安装包
LyraNest-0.2.4-fnos-x86.fpk（或 arm / Compat 版）
# 2. 飞牛应用商店 → 手动上传 → 导入该文件
# 3. 安装后授权音乐目录并启动
 
# 使用飞牛统一网关访问（默认）
http://<飞牛局域网地址>/app/lyranest
 
# 如需独立端口，在应用设置填写 1024-65535 自定义端口
http://<飞牛局域网地址>:<端口>/

检查服务

启动后如何确认服务正常，以及客户端如何连接。

terminal

docker compose ps
curl http://127.0.0.1:8080/health
 
# 首次启动后，使用以下地址打开网页端
http://服务器地址:8080
# Windows 与 Android 客户端填写相同服务器地址并登录

方法一 · Docker Compose 部署（通用）

使用 Docker Compose 部署，适用于所有支持 Docker 的设备（群晖、飞牛、unRAID、云服务器等）。前往官网下载页或GitHub 仓库复制 docker-compose.yml。

docker-compose.yml

services:
  music-server:
    image: ghcr.io/whwgogogo/lyranest-server:{$LYRANEST_VERSION:-0.2.7}
    container_name: lyranest-server
    restart: unless-stopped
    mem_limit: 256m
    mem_reservation: 128m
    environment:
      SERVER_ADDR: ":8080"
      MUSIC_LIBRARY_DIR: /music
      MUSIC_LIBRARY_ROOTS: "/music:/downloads"
      MUSIC_DATA_DIR: /data
      MUSIC_CACHE_DIR: /cache
      DOWNLOADS_ROOT: /downloads
      PROVIDER_CREDENTIAL_KEY: "{$PROVIDER_CREDENTIAL_KEY:-}"
      GOMEMLIMIT: "192MiB"
      GOGC: "100"
      MEDIA_EXTRACT_CONCURRENCY: "4"
      MEDIA_SCRAPE_CONCURRENCY: "2"
      MUSICBRAINZ_USER_AGENT: "LyraNest/0.2.4 (+https://github.com/WHWgogogo/LyraNest)"
      MUSICBRAINZ_BASE_URL: "https://musicbrainz.org"
      MUSICBRAINZ_TIMEOUT: "20s"
      LOG_LEVEL: "info"
      SHUTDOWN_TIMEOUT: "10s"
      AUTH_SESSION_TTL: "24h"
      LYRANEST_DISCOVERY: "1"
    ports:
      - "8080:8080"
    volumes:
      - ./music:/music:ro
      - # ./music1:/music1:ro
      - ./downloads:/downloads:rw
      - ./data:/data:rw
      - ./cache:/cache:rw