将 Google Drive 中的 MP3 集成至 Home Assistant Music Assistant 指南

背景

对于许多千禧一代而言，数字音乐的演变伴随着 Napster、Kazaa、eDonkey2000 等早期 P2P 平台，以及 CD 刻录和局域网（LAN）聚会。作者作为这一代人的代表，拥有大量完全合法的 MP3 文件收藏。这些文件曾长期备份在两块已停止运转的大型 USB 机械硬盘上，同时也存储在 Google Drive 中。

与此同时，作者深度投入于 Home Assistant 生态系统。Home Assistant 允许用户安装功能齐全的媒体播放器应用 Music Assistant。尽管目前作者订阅了 YouTube Music 家庭计划以支持音乐产业，但近期萌发了重温旧日 MP3 收藏的念头。本文旨在详细阐述如何将 Google Drive 中的音乐库连接至 Home Assistant 上的 Music Assistant，实现本地化与云存储结合的播放体验。

核心内容

该方案的核心逻辑是利用 rclone 命令行工具将 Google Drive 挂载为 WebDAV 服务器，并通过 Home Assistant 的终端环境运行该服务，最后由 Music Assistant 连接该 WebDAV 地址进行播放。具体实施步骤如下：

1. 创建 Google Drive 的 rclone 配置

首先，需要在普通计算机（而非 Home Assistant 设备）上下载并配置 rclone。rclone 是一款用于管理云存储文件的命令行程序，支持包括 Google Drive 在内的多种提供商。

• 配置过程：运行 rclone config 启动配置向导。由于涉及 Google Cloud Console 的认证流程，这一步可能较为繁琐，但只需一次性完成。
• 获取配置文件：配置完成后，通过 rclone config show 查看配置内容。你需要提取包含 client_id、client_secret 和 token 的配置片段。
• 配置示例：

  [drive]
  type = drive
  client_id = *.apps.googleusercontent.com
  client_secret = *-*
  scope = drive
  token = {"access_token":"*","token_type":"Bearer","refresh_token":"*","expiry":"*","expires_in":3599}
  team_drive =
  

• 部署到 Home Assistant：在 Home Assistant 中安装 File Editor 插件，在 config/rclone 目录下创建名为 rclone.conf 的文件，并将上述配置内容粘贴保存。

2. 在 Home Assistant 中设置 rclone

为了让 Home Assistant 能够运行 rclone 并将其作为 WebDAV 服务器提供服务，需要安装 Advanced SSH & Web Terminal 插件。

• 安装插件：在 Home Assistant 中安装 Advanced SSH & Web Terminal。
• 修改配置：进入插件的 Configuration 选项卡，点击三点菜单选择 "Edit in YAML"。
• 添加配置：在 YAML 配置中添加以下代码。这将安装 rclone 包，并在每次启动 Home Assistant 时自动在端口 8080 上启动一个 WebDAV 服务器，指向 Google Drive 中的 drive: 目录。

  ssh:
    username: hassio
    password: passw0rd # ⚠️ 务必修改为你自己的强密码！
    authorized_keys: []
    sftp: false
    compatibility_mode: false
    allow_agent_forwarding: false
    allow_remote_port_forwarding: true
    allow_tcp_forwarding: false
    zsh: true
    share_sessions: false
  packages:
    - rclone
  init_commands:
    - >-
      rclone serve webdav drive: --addr :8080 --baseurl /google_music --config
      /config/rclone/rclone.conf --vfs-cache-mode full &
  

  注意：--vfs-cache-mode full 参数有助于提高流媒体播放的流畅度，通过本地缓存减少云端读取延迟。

3. 连接 Music Assistant

最后一步是将 Music Assistant 指向刚刚搭建的 WebDAV 服务。

• 添加源：在 Home Assistant 中打开 Music Assistant 应用，进入 Settings（设置），点击 "Music sources"（音乐源）按钮以添加新的集成。
• 选择协议：从列表中选择 "WebDAV Provider"。
• 填写信息：
  • WebDAV URL: http://127.0.0.1:8080/google_music
  • 用户名：hassio（即上述 YAML 配置中的 username）
  • 密码：passw0rd（即上述 YAML 配置中修改后的密码）

完成上述步骤后，Music Assistant 应能识别并浏览存储在 Google Drive 中的 MP3 文件，即可开始播放。

关键要点

• 工具选择：利用 rclone 作为云存储与本地服务之间的桥梁，通过 WebDAV 协议实现兼容性和稳定性。
• 认证流程：Google Drive 的 API 访问需要通过 Google Cloud Console 获取 Client ID 和 Secret，并生成 Token，这是一次性但较为复杂的设置过程。
• 自动化部署：通过 Advanced SSH & Web Terminal 插件的 packages 和 init_commands 功能，实现了 rclone 的自动安装和 WebDAV 服务的开机自启，无需手动干预。
• 性能优化：在 rclone serve webdav 命令中加入 --vfs-cache-mode full，通过启用完整的 VFS 缓存来改善网络延迟对音乐播放体验的影响。
• 安全性提醒：配置文件中包含明文密码，务必修改默认密码以保障 Home Assistant 实例的安全。

意义与影响

这一方案为拥有大量本地数字音乐资产（如 MP3）的用户提供了一种现代化的管理方式。它打破了传统本地存储（如硬盘）的物理限制和云端订阅服务（如 YouTube Music）的内容限制，实现了两者的融合。

对于 Home Assistant 用户而言，这不仅是一个技术教程，更展示了如何通过组合现有工具（Home Assistant + rclone + WebDAV）来扩展智能家居生态的功能边界。它允许用户保留对音乐文件的完全控制权，同时享受云存储的便利性和 Home Assistant 集成的自动化体验。此外，作者强调个人博客的价值，也提醒了社区中独立创作者在分享此类深度技术内容时的努力与不易，鼓励社区互动与支持。