Feishin：自托管音乐播放器

项目简介

Feishin 是一款现代的自托管音乐播放器，是 Sonixd 的重写版本。它可以连接 Navidrome、Jellyfin 和 OpenSubsonic 兼容音乐服务器，提供桌面客户端、Web 版与 Docker 镜像。

主要功能

• MPV 与 Web 两种播放器后端
• 现代界面，支持自定义主题
• 播放记录 scrobble 到服务器
• 智能播放列表编辑器（Navidrome）
• 同步与非同步歌词，桌面端内置歌词获取
• 支持 Navidrome、Jellyfin 以及 Airsonic-Advanced、Ampache、Funkwhale、Gonic、Nextcloud Music 等 OpenSubsonic 兼容服务器

安装与使用

桌面客户端（推荐）

从 最新桌面客户端 下载。Linux 可通过 Flathub 安装，或运行 AppImage 安装脚本：

dir=/your/application/directory
curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir"

脚本会下载最新 .AppImage、设置可执行权限、下载图标并生成 .desktop 文件；追加 wayland-native 可尝试实验性原生 Wayland 模式。

macOS 12 及以上如遇隔离问题，需按项目 issue 指引移除 quarantine；使用媒体键需允许 Feishin 成为受信任的辅助功能客户端并重启。

Web 与 Docker

可直接访问 https://feishin.vercel.app 使用托管 Web 版，Web 客户端仅支持 Web 播放器后端。

Docker 镜像位于 ghcr.io/jeffvli/feishin：

docker run --name feishin -p 9180:9180 ghcr.io/jeffvli/feishin:latest

也可用 Docker Compose 部署，镜像同样支持 SERVER_NAME、SERVER_TYPE、SERVER_URL、SERVER_LOCK、REMOTE_URL、ANALYTICS_DISABLED 等环境变量。

基本配置

1. 启动后选择 MPV 二进制文件路径；如未安装，可从 mpv.io 下载，填写路径后重启。
2. 打开菜单 → Manage servers → Add server，填写包含协议和端口的完整服务器 URL。
3. Navidrome 建议勾选“Save password”，并把 SessionTimeout 调大（如 72h）。Linux 默认使用 libsecret，也支持 kwallet4/5/6，需在设置中选择。
4. 子路径部署可设置 PUBLIC_PATH；首次运行可用 FS_ 前缀环境变量覆盖主题、语言等设置。

注意事项

• 桌面客户端推荐使用，支持 MPV 与 Web 播放器后端；Web 客户端仅支持 Web 播放器后端。
• Plex 不被原生支持，可使用 lux032 的 Feishin fork。
• MPV 异常时先检查设置中的路径并重启；必要时重装。已知可用版本为 v0.35.x 和 v0.36.x，v0.34.x 存在已知问题。
• Linux 若出现 SUID sandbox 错误，可启用非特权命名空间，或执行：

chmod 4755 chrome-sandbox
sudo chown root:root chrome-sandbox

• 原生 Wayland 模式在 Electron 中仍属实验性，不受官方支持。

---

本作品整理自 GitHub 开源项目 jeffvli/feishin，原作者 @jeffvli，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。