Feishin 自托管音乐播放器安装与使用教程

1. 项目目录结构及介绍

Feishin 的目录结构主要包括以下几个关键部分：

• src: 主要源代码存放的地方，包括前端界面（Web Player）和后台服务。

  • client: 前端应用的代码，用于构建Web界面。
  • server: 后台服务的代码，提供API接口和与媒体服务器的交互逻辑。

• public: 静态资源文件夹，包含网页所需的CSS、JavaScript和图片等资源。

• .dockerignore: Docker构建时忽略的文件或目录列表。

• Dockerfile: Docker镜像的构建指令，用于创建Feishin容器。

• docker-compose.yml: Docker Compose配置文件，方便一键部署多个相关服务。

• LICENSE: 项目许可文件，表明该项目遵循GPL v3.0许可证。

• README.md: 项目的说明文件，包含了基本的安装和使用指南。

2. 项目启动文件介绍

主要的启动文件有两个，一个用于Docker环境，另一个用于本地开发环境。

• Dockerfile: 定义了如何构建Feishin的Docker镜像，其中包含了必要的依赖和运行命令。使用docker build命令可以创建镜像，然后通过docker run来启动容器。

• docker-compose.yml: Docker Compose配置文件，允许一次性启动Feishin容器和其他服务（如数据库）。使用docker-compose up命令可以快速启动所有服务。

3. 项目配置文件介绍

Feishin 的配置通常通过环境变量进行，以下是几个核心的配置项：

• SERVER_NAME: 指定你的媒体服务器地址，例如Jellyfin或NaviDrome的URL。

• PLAYER_BACKEND: 决定使用哪个播放器后台，默认是MPV，也可以选择Web Player。

在使用Docker部署时，可以在启动容器时通过--env参数设置这些环境变量，或者在docker-compose.yml中定义environment部分。在非Docker环境中，你可以修改启动脚本以添加相应的命令行参数。

例如，在Docker Compose中配置Feishin服务器名称：

services:
  feishin:
    container_name: feishin
    image: 'ghcr.io/jeffvli/feishin:latest'
    environment:
      - SERVER_NAME=jellyfin.example.com

完成以上步骤后，你就可以通过访问指定的端口（默认9180）来使用Feishin自托管音乐播放器了。记得检查防火墙设置，确保对应的端口开放。如有任何疑问，查阅项目GitHub页面上的README或开源社区获取更多帮助。