Linux 上使用 MPD (Music Player Daemon)

在 Linux 系统上使用 **MPD（Music Player Daemon）** 的完整步骤如下：

---

### 一、安装 MPD
根据您的 Linux 发行版选择命令：

| 发行版          | 安装命令                           |
|----------------|-----------------------------------|
| **Debian/Ubuntu** | `sudo apt install mpd`           |
| **Arch Linux**    | `sudo pacman -S mpd`             |
| **Fedora**        | `sudo dnf install mpd`           |
| **openSUSE**      | `sudo zypper install mpd`        |

---

### 二、配置 MPD
#### 1. 配置文件路径
- 系统全局配置：`/etc/mpd.conf`
- 用户独立配置：`~/.config/mpd/mpd.conf`（需手动创建）

#### 2. 基础配置示例
编辑配置文件（以 `~/.config/mpd/mpd.conf` 为例）：
```conf
# 音乐库目录
music_directory    "~/Music"
# 数据库和日志路径
db_file            "~/.config/mpd/mpd.db"
log_file           "~/.config/mpd/mpd.log"
# 播放列表目录
playlist_directory "~/.config/mpd/playlists"
# 音频输出设置（ALSA）
audio_output {
    type          "alsa"
    name          "My ALSA Device"
    device        "hw:0,0"  # 声卡设备号（通过 `aplay -l` 查看）
    mixer_type    "software"  # 使用软件音量控制
}
```

#### 3. 关键配置项说明
| 配置项                | 作用                                                                 |
|-----------------------|--------------------------------------------------------------------|
| `music_directory`     | 指定音乐文件存储路径（MPD 会扫描此目录构建数据库）                     |
| `audio_output`        | 定义音频输出方式（支持 ALSA、PulseAudio、HTTP 流等）                   |
| `bind_to_address`     | 控制是否允许远程访问（默认 `localhost`，设为 `any` 可开放网络访问）     |
| `auto_update`         | 是否自动更新音乐库（建议设为 `yes`）                                  |

---

### 三、启动 MPD 服务
#### 1. 作为用户级服务（推荐）
```bash
# 启动 MPD
mpd
# 或通过 systemd 管理（若以用户模式安装）
systemctl --user enable --now mpd
```

#### 2. 作为系统级服务（需 root）
```bash
sudo systemctl enable --now mpd
```

---

### 四、控制 MPD
#### 1. 命令行客户端：`mpc`
安装 `mpc` 工具：
```bash
sudo apt install mpc  # Debian/Ubuntu
```

常用命令：
```bash
mpc update           # 更新音乐库
mpc listall          # 列出所有歌曲
mpc add /path/to/file.mp3  # 添加歌曲到播放队列
mpc play             # 开始播放
mpc pause            # 暂停
mpc next             # 下一曲
mpc volume +5        # 音量增加 5%
```

#### 2. 图形化客户端
- **终端 TUI 客户端**：`ncmpcpp`（安装：`sudo apt install ncmpcpp`）
- **桌面 GUI 客户端**：Cantata、GMPC
- **手机 APP**：M.A.L.P（Android）、MPDluxe（iOS）

---

### 五、高级用法
#### 1. 多房间音频（多设备输出）
修改 `audio_output` 部分，添加多个输出：
```conf
audio_output {
    type    "alsa"
    name    "Living Room"
    device  "hw:0,0"
}

audio_output {
    type    "shout"
    name    "Kitchen"
    host    "192.168.1.100"
    port    "8000"
    format  "44100:16:2"
}
```

#### 2. 启用均衡器（DSP）
在配置文件中添加：
```conf
dsp {
    plugin "softvol"      # 软件音量控制
    plugin "equalizer"    # 均衡器（需安装 `mpd-equalizer`）
}
```

#### 3. HTTP 音频流输出
```conf
audio_output {
    type            "httpd"
    name            "HTTP Stream"
    encoder         "flac"      # 支持 flac、vorbis、lame
    port            "8000"
    quality         "5.0"       # 编码质量（仅对 vorbis/lame 有效）
    format          "44100:16:2"
}
```

---

### 六、故障排查
#### 1. 常见问题
- **无法播放音乐**：检查声卡设备号（`aplay -l`）和权限（用户是否在 `audio` 组）。
- **音乐库未更新**：运行 `mpc update` 强制更新。
- **权限错误**：确保 `~/.config/mpd` 目录及其文件权限为当前用户可读写。

#### 2. 查看日志
```bash
tail -f ~/.config/mpd/mpd.log  # 用户级日志
tail -f /var/log/mpd/mpd.log   # 系统级日志
```

---

通过以上步骤，您可以在 Linux 上轻松搭建一个高性能的音乐服务器，并通过多种客户端灵活控制播放。

[Linux 音频](https://cloud-atlas.readthedocs.io/zh-cn/latest/linux/desktop/audio/index.html)