Jellyfin 开源媒体系统安装与使用教程

1. 项目目录结构及介绍

Jellyfin 的目录结构设计是为了支持其作为服务器端应用程序的功能。下面是一些主要目录和文件的简要说明：

• src - 主要代码仓库，包含了Jellyfin的核心服务和其他组件。

  • Jellyfin.Server - 应用程序的主要入口点和服务器逻辑。
  • Jellyfin.Api - 提供HTTP API接口，用于客户端与服务器通信。
  • Jellyfin.Data - 存储数据模型和数据库相关逻辑。

• devcontainer - 这个目录包含开发环境容器的相关配置，帮助开发者快速设置开发环境。

• docs - 文档相关的源码，可以用于构建项目文档。

• .github - 包含GitHub操作的配置和脚本，例如CI/CD流程。

• LICENSE - 项目的许可证文件，此处是GPLv2.

2. 项目的启动文件介绍

Jellyfin 使用.NET框架运行，通常通过执行可执行文件 Jellyfin.exe 来启动服务。这个文件位于编译后的bin目录下。如果你是从源码构建，可以在完成编译后找到它。

在Linux或macOS环境下，你可以通过命令行来启动Jellyfin服务器：

./Jellyfin

在Windows上，打开命令提示符或者PowerShell并输入：

.\Jellyfin.exe

默认情况下，Jellyfin将监听http://localhost:8096，可以通过修改配置文件更改默认端口或IP地址。

3. 项目的配置文件介绍

Jellyfin的配置文件存储在%APPDATA%\Jellyfin（Windows）或~/.config/Jellyfin（Linux/macOS）路径下。主要的配置文件名为config.xml。

config.xml 包括以下关键部分：

• <Server> - 服务器配置，包括端口、SSL设置、日志级别等。
• <ApiSettings> - API设置，如认证模式、跨域策略等。
• <DataProviders> - 数据提供者配置，如何连接到媒体库的数据源。
• <Database> - 数据库存储设置，如数据库类型、连接字符串等。
• <UsersAndGroups> - 用户和组的配置，包括默认用户和权限设置。

可以通过编辑此XML文件手动进行配置调整，但为了方便起见，Jellyfin也提供了Web界面来图形化管理这些设置。

请注意，修改配置文件前最好先备份原始文件，以防止意外的配置错误导致服务器无法正常运行。