【亲测免费】轻量级音乐服务器(LMS)安装与配置完全攻略：手把手带你玩转自托管音乐流媒体

2026-01-25 06:28:10作者：滑思眉Philip

项目基础介绍及编程语言

轻量级音乐服务器（Lightweight Music Server，简称LMS）是一个开源的自托管音乐流媒体软件，它允许用户通过一个简洁的Web界面访问存放在任何地方的个人音乐收藏。LMS特别适合作为家庭音乐中心或小型网络电台，提供丰富的功能，包括推荐引擎、多值标签分类、艺术家关系管理等，并支持MusicBrainz和ListenBrainz等服务以增强音乐体验。此项目的主体编程语言是C++，辅以CMake进行构建管理。

关键技术和框架

核心技术: LMS采用了高度优化的数据处理逻辑，以及对多种音频格式的处理能力，确保高效地进行音频流传输和转换。
框架: 尽管其核心部分是自建的，但利用了CMake作为构建系统，保证跨平台兼容性。在前端交互上，依赖于标准Web技术，允许用户通过浏览器控制。
集成库和服务: 集成MusicBrainz和ListenBrainz API，实现元数据管理和听众反馈同步，提升音乐组织和发现的智能性。
认证后端：支持多种用户认证方式，增强安全性与灵活性。

准备工作和详细安装步骤

系统准备

环境需求：确保您的服务器运行在Linux发行版上，推荐Debian或Ubuntu，因为这些系统的社区支持更佳。此外，您需要有基本的Linux命令行操作知识。

软件准备：更新系统包并安装必要的依赖项。打开终端，执行以下命令：

sudo apt-get update
sudo apt-get install build-essential cmake git libtag1-dev sqlite3 libsqlite3-dev

安装LMS

下载源码

使用Git克隆项目到本地：

git clone https://github.com/epoupon/lms.git
cd lms

编译与安装

配置项目：首先创建构建目录并进入该目录，然后使用CMake配置项目。
```
mkdir build
cd build
cmake ..
```
编译与安装：完成配置后，开始编译并安装LMS。
```
make
sudo make install
```

配置与启动

创建数据库和配置文件：LMS需要SQLite数据库来存储信息。首次运行之前，需要初始化数据库。
```
sudo sqlite3 /var/lib/lms/lms.db < contrib/schema.sql
```
配置LMS：编辑配置文件/etc/lms/settings.py，根据需要设置端口、数据库连接字符串、认证方式等。
启动服务：LMS不自带 systemd 脚本，你可以手动编写一个或者使用screen/tmux等工具后台运行。
```
python path/to/lms/server.py &
```
或者创建systemd服务单元文件以便自动化管理。