如何快速部署LMS：从安装到播放的30分钟入门教程

LMS（Lightweight Music Server）是一款轻量级音乐服务器，让你通过网页界面轻松访问自托管的音乐库。本教程将带你在30分钟内完成从安装到播放的全过程，即使是新手也能快速上手。## 🌟 准备工作：三种安装方式任选LMS提供多种安装方案，你可以根据自己的系统环境选择最适合的方式：### 🐳 Docker安装（推荐新手）Docker方式最为简单，只需执行官方镜像即

穆璋垒Estelle

1064人浏览 · 2026-02-19 04:06:58

穆璋垒Estelle · 2026-02-19 04:06:58 发布

如何快速部署LMS：从安装到播放的30分钟入门教程

【免费下载链接】lms Lightweight Music Server. Access your self-hosted music using a web interface. 项目地址: https://gitcode.com/gh_mirrors/lms/lms

LMS（Lightweight Music Server）是一款轻量级音乐服务器，让你通过网页界面轻松访问自托管的音乐库。本教程将带你在30分钟内完成从安装到播放的全过程，即使是新手也能快速上手。

🌟 准备工作：三种安装方式任选

LMS提供多种安装方案，你可以根据自己的系统环境选择最适合的方式：

🐳 Docker安装（推荐新手）

Docker方式最为简单，只需执行官方镜像即可：

docker run -d -p 5082:5082 -v /path/to/music:/music epoupon/lms

注意替换/path/to/music为你的音乐文件夹路径

🐧 Debian/Ubuntu包安装

适合Debian系系统，执行以下命令添加仓库并安装：

wget --backups=1 https://debian.poupon.dev/apt/debian/epoupon.gpg -P /usr/share/keyrings
echo "deb [signed-by=/usr/share/keyrings/epoupon.gpg] https://debian.poupon.dev/apt/debian trixie main" > /etc/apt/sources.list.d/epoupon.list
apt update && apt install lms

🔨 从源码编译安装

适合高级用户，需要先安装依赖：

apt-get install build-essential cmake libboost-program-options-dev libboost-system-dev libavutil-dev libavformat-dev libstb-dev libconfig++-dev ffmpeg libtag-dev libpam0g-dev libpugixml-dev libgtest-dev libarchive-dev libxxhash-dev libssl-dev

然后克隆源码并编译：

git clone https://gitcode.com/gh_mirrors/lms/lms
cd lms
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
make -j$(nproc)
sudo make install

⚙️ 基础配置指南

服务管理

安装完成后，通过systemd管理服务：

# 启动服务
systemctl start lms

# 设置开机自启
systemctl enable lms

# 查看日志
journalctl -u lms.service

配置文件修改

主要配置文件位于/etc/lms.conf，常用配置项：

listen-address: 监听地址（默认127.0.0.1）
listen-port: 监听端口（默认5082）
working-dir: 工作目录（默认/var/lms）
authentication-backend: 认证方式（默认internal）

反向代理设置

推荐使用Nginx作为反向代理，示例配置：

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://localhost:5082/;
    }
}

记得在lms.conf中设置behind-reverse-proxy=true。

🚀 首次启动与使用

访问LMS

打开浏览器访问http://localhost:5082（或你的服务器IP:5082）。首次访问会显示设置向导，引导你创建管理员账户。

添加音乐库

使用管理员账户登录后，点击"设置" → "媒体库"
点击"添加媒体库"，选择你的音乐文件夹
配置扫描选项（扫描频率、标签处理等）
点击"开始扫描"导入音乐

开始播放音乐

扫描完成后：

在左侧导航栏选择"探索"
浏览艺术家、专辑或曲目
点击任意曲目开始播放
使用顶部的媒体播放器控制播放进度、音量等

🔐 认证方式选择

LMS支持多种认证方式，可在lms.conf中修改authentication-backend：

internal（默认）：使用内置数据库存储用户信息
PAM：通过系统PAM服务认证，配置文件位于conf/pam/lms
http-headers：通过反向代理设置的HTTP头进行SSO认证

提示：如果忘记管理员密码，可通过sqlite3重置：
sqlite3 /var/lms/lms.db "UPDATE user SET password_salt='sliIgHUpEoAlBMquivH4VzKXbSzexlvS', password_hash='$2y$07$a0vnQUbGTV/DZyDqOizvbOdCaytNjDhkOPcGoBZup4V0MRKDzOpEG' WHERE id=1;"
重置后密码为adminadmin