10分钟搭好自托管音乐播放器：Feishin上手指南

10分钟搭好自托管音乐播放器Feishin上手指南【免费下载链接】feishinA modern self-hosted music player.项目地址: https://gitcode.com/gh_mirrors/fe/feishin你几百G的音乐躺在NAS里唯一能听的入口是服务器自带的那个网页界面粗糙、操作别扭歌词更是无从谈起。你缺的不是服务器而是一个像样的前端。Feishin 是一款开源的自托管音乐播放器它自己不存音乐只作为客户端连接你已有的 Navidrome、Jellyfin 或 Subsonic 协议服务器接上就能获得现代播放界面、智能播放列表和同步歌词。Feishin 项目速览音乐服务器的前端一句话定位Feishin 是给你的自托管音乐服务器配的前端界面——服务器负责存文件和索引Feishin 负责播放、浏览和管理。 目标人群有两类家里已经跑着 Navidrome/Jellyfin/Subsonic 的用户以及想自建音乐库、不想再为订阅付费的用户。它与同类工具的差异点有三MPV 和 Web 双播放器后端、可视化智能播放列表编辑器、同步歌词支持。相比 Navidrome 自带的 Web UI对比维度Navidrome 自带 Web UIFeishin播放后端仅浏览器 HTML5MPV Web 双后端智能播放列表基础功能可视化查询编辑器字段运算符值同步歌词不支持内置抓取逐句高亮服务器类型仅 Navidrome 自身Navidrome / Jellyfin / Subsonic 三选一切换最快上手路径3步连上音乐服务器以官方推荐的桌面版为例整个流程分三步。拿到播放器。从项目 Releases 页下载对应平台的最新版安装即可Linux 用户也可以装 Flathub 上的 flatpak 包org.jeffvli.feishin。如果想部署在服务器上让全家浏览器访问一条 docker 命令就够docker run --name feishin -p 9180:9180 ghcr.io/jeffvli/feishin:latest配置 MPV 路径。桌面版首次运行会提示选择 mpv 二进制路径没有的话先用系统包管理器装好 mpv填路径后重启应用。添加服务器。在菜单里打开 Manage servers点 Add server填入完整 URL含协议和端口如http://192.168.0.1:4533加账号密码即可开始播放。用 Navidrome 的用户记得勾选 Save password并把服务端SessionTimeout调大如 72h避免频繁掉线重新登录。核心能力撑起听歌体验的四个部分三套协议通吃前端一次配好这是它的第一价值任何实现了 Navidrome、Jellyfin 或 OpenSubsonic API 的服务器都能接Airsonic-Advanced、Ampache、Funkwhale、Nextcloud Music 等十余种服务端开箱即用。用法是添加服务器时从jellyfin、navidrome、subsonic三种类型里选一个。举个例子家里 Jellyfin 地址填http://192.168.0.1:8096整个曲库立即可见将来换服务器音乐文件都不用动。想读源码的话三套协议的请求实现都在 src/renderer/api/ 目录下一个协议一个文件夹。双播放后端本地用 MPV、网页用 Web桌面版同时内置两个后端按场景切换。MPV 是本地解码播放进程无损和 gapless 连续播放靠它Web 后端就是 HTML5 音频Web 版和 Docker 版都走它。在设置里即可切换。例电脑上用 MPV 听 FLAC手机上用浏览器打开同一个库继续听登录状态共享。智能播放列表编辑器一个条件筛出整个曲库Navidrome价值在于你不用手动挑歌曲库变化时列表内容自动同步。用法是打开播放列表里的 Query Editor用字段 运算符 值的条件链组合再配排序和 Limit。例如设置Album Artist Contains Beller、按专辑升序就能得到这位艺术家的完整专辑曲目底部 Preview 可以先验证结果再 Save。同步歌词逐句高亮跟随播放进度桌面版内置歌词抓取不需要第三方工具。用法是打开全屏播放器在 Lyrics 页签里选择同步模式卡拉OK式逐句高亮或非同步全文。例下面这张截图里FLAC 曲目的歌词自动抓取并对齐进度无需手动调偏移。部署方案对比桌面、Docker、Web 怎么选三种方式按使用人身份选即可方式上手门槛适合谁适用场景桌面版最低下载安装即用个人日常使用完整功能MPV 后端、内置歌词抓取、系统媒体键控制Docker中等一条命令起容器家庭服务器 / NAS 用户暴露到局域网可用环境变量锁定服务器页面只填账号密码Web最低浏览器打开多设备、快速体验官方托管版或自托管静态页仅 Web 播放后端无 MPV两个补充想挂在子目录部署传一个PUBLIC_PATH环境变量即可仓库里还有一个面向手机的 remote PWA 客户端src/remote/目录可以加到手机主屏幕使用。进阶技巧用了就回不去的三项设置Docker 锁定服务器。传SERVER_NAME、SERVER_TYPE、SERVER_URL并设SERVER_LOCKtrue登录后只剩账号密码可填。适合部署到家庭网络给家人用谁都不会误连到别的服务器。环境变量批量预置设置。Web/Docker 版支持FS_前缀的环境变量在首次运行时覆盖应用设置例如FS_GENERAL_THEMEcatppuccinMocha直接在启动时指定主题。批量部署统一风格时很方便完整变量清单见 docs/ENV_SETTINGS.md。JSON 自定义主题。往桌面版的 Themes 文件夹丢一个.json文件Settings → General → Theme 里有 Open Folder 按钮主题列表立刻多出一个选项无需重新构建。文件格式和示例参考 docs/CUSTOM_THEMES.md内置主题则有 30 多个可选包括 Catppuccin、Dracula、Tokyo Night 等。常见问题新手最容易踩的 3 个坑现象MPV 无法播放或在暂停/播放之间频繁跳动。原因mpv 二进制路径配错或版本有问题v0.34.x 是已知损坏的版本。 解法进设置重新填写路径并重启应用v0.35.x 和 v0.36.x 是确认可用的版本仍不行就重装 mpv。现象Linux 启动时报 The SUID sandbox helper binary was found...。原因系统禁用了非特权用户命名空间sysctl kernel.unprivileged_userns_clone返回 0Ubuntu 24.04 上尤其常见。 解法启用非特权命名空间或把chrome-sandbox设为 Setuid。现象Navidrome 经常掉线、反复要求重新登录。原因会话超时时间太短且客户端没有保存密码。 解法添加服务器时勾选 Save password同时把 Navidrome 服务端的SessionTimeout调大比如 72 小时。写在最后谁适合用下一步看哪里如果你已经有 Navidrome、Jellyfin 或 Subsonic 服务器或者打算自建音乐库摆脱订阅制Feishin 值得作为首选前端唯一要注意是它不原生支持 Plex需要用社区分支。下一步建议先读一遍 docs/ENV_SETTINGS.md 了解可预置的环境变量再关注仓库 README 里给出的 Discord 和 Matrix 社区入口跟进版本更新和功能讨论。【免费下载链接】feishinA modern self-hosted music player.项目地址: https://gitcode.com/gh_mirrors/fe/feishin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考