Feishin 开源项目教程

项目介绍

Feishin 是一个现代的自托管音乐播放器，它是 Sonixd 的重写版本。Feishin 提供了 MPV 播放器后端和 Web 播放器后端，拥有现代化的用户界面，支持播放到服务器、智能播放列表编辑（Navidrome）、同步和非同步歌词支持等功能。用户可以请求新功能或查看任务板。

项目快速启动

使用 Docker 运行 Feishin

要快速启动 Feishin，可以使用 Docker。以下是运行最新版本的命令：

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

使用 Docker Compose 安装

如果更喜欢使用 Docker Compose，可以使用以下配置：

version: '3'
services:
  feishin:
    container_name: feishin
    image: 'ghcr.io/jeffvli/feishin:latest'
    environment:
      - SERVER_NAME=jellyfin # 预定义服务器名称
    ports:
      - "9180:9180"

保存上述内容到一个 docker-compose.yml 文件，然后在同一目录下运行：

docker-compose up -d

应用案例和最佳实践

桌面客户端使用

推荐使用桌面客户端来运行 Feishin，它支持 MPV 和 Web 播放器后端，并包含内置的歌词获取功能。下载最新版本的桌面客户端并安装。

MacOS 注意事项

如果你使用的是运行 macOS 12（Monterey）或更高版本的设备，需要检查如何从隔离中移除应用。此外，为了使媒体键正常工作，需要允许 Feishin 作为受信任的辅助功能客户端。

典型生态项目

Navidrome

Navidrome 是一个现代的音乐服务器和流媒体应用，它与 Feishin 兼容，可以作为音乐库的后端服务。

MPV 播放器

MPV 是一个开源的媒体播放器，Feishin 使用它作为播放器后端，提供高质量的音频播放体验。

通过这些模块，用户可以快速了解和启动 Feishin 项目，并了解其在实际应用中的使用方法和最佳实践。