hetsh/jellyfin

Jellyfin

镜像概述

Jellyfin是一款易于设置的媒体服务器，用于搭建个人媒体服务，支持媒体文件的管理、转码和流式传输，适用于个人或家庭环境下的媒体内容共享。

核心功能和特性

• 简单快速的部署流程，通过Docker容器轻松启动
• 基于Web界面的配置方式，首次运行提供设置向导
• 支持持久化存储，确保配置、媒体数据和缓存不丢失
• 灵活的媒体文件挂载，支持外部媒体目录接入
• 时间同步功能，确保日志时间准确性
• 支持通过systemd实现自动启动和关闭

使用场景

• 个人媒体库管理与流式播放
• 家庭内部媒体内容共享
• 替代传统本地媒体播放器，实现跨设备访问

使用方法

运行服务器

使用以下命令启动Jellyfin服务器：

bash
docker run --detach --name jellyfin --publish 8096:8096 docker.xuanyuan.run/hetsh/jellyfin

停止容器

停止运行中的Jellyfin容器：

bash
docker stop jellyfin

配置

Jellyfin通过http://localhost:8096%E8%BF%9B%E8%A1%8C%E9%85%8D%E7%BD%AE%E3%80%82%E9%A6%96%E6%AC%A1%E8%BF%90%E8%A1%8C%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%97%B6%EF%BC%8C%E4%BC%9A%E5%90%AF%E5%8A%A8%E9%85%8D%E7%BD%AE%E5%90%91%E5%AF%BC%E5%BC%95%E5%AF%BC%E5%AE%8C%E6%88%90%E5%88%9D%E5%A7%8B%E8%AE%BE%E7%BD%AE%E3%80%82

创建持久化存储

为确保数据持久化，需创建并配置数据、配置和缓存目录：

bash
DATA_STORAGE="/path/to/data"
CONFIG_STORAGE="/path/to/conf"
CACHE_STORAGE="/path/to/cache"
mkdir -p "$DATA_STORAGE" "$CONFIG_STORAGE" "$CACHE_STORAGE"
chown -R 1365:1365 "$DATA_STORAGE" "$CONFIG_STORAGE" "$CACHE_STORAGE"

说明：1365是服务器运行用户的数字ID（详见Dockerfile），该用户需要对存储目录拥有读写权限。

启动服务器时添加挂载参数：

bash
docker run \
--mount type=bind,source=/path/to/data,target=/var/lib/jellyfin \
--mount type=bind,source=/path/to/conf,target=/etc/jellyfin \
--mount type=bind,source=/path/to/cache,target=/var/cache/jellyfin \
--detach --name jellyfin --publish 8096:8096 docker.xuanyuan.run/hetsh/jellyfin

添加媒体

媒体文件可挂载到容器内任意位置，只需确保Jellyfin用户（uid: 1365）具有读取权限：

bash
docker run --mount type=bind,source=/path/to/media,target=/media --detach --name jellyfin --publish 8096:8096 docker.xuanyuan.run/hetsh/jellyfin

时间同步

同步时区可确保日志显示正确时间，通过以下挂载参数共享时区：

bash
docker run --mount type=bind,source=/etc/localtime,target=/etc/localtime,readonly --detach --name jellyfin --publish 8096:8096 docker.xuanyuan.run/hetsh/jellyfin

通过systemd自动启动和关闭

systemd单元文件可在GitHub https://github.com/Hetsh/docker-jellyfin%E8%8E%B7%E5%8F%96%E3%80%82%E5%90%AF%E7%94%A8%E5%B9%B6%E5%90%AF%E5%8A%A8%E6%9C%8D%E5%8A%A1%EF%BC%9A

bash
systemctl enable jellyfin --now

注意：默认情况下，systemd服务假设数据、缓存、配置、媒体和时区文件（/etc/localtime）使用特定路径。由于这是个人定制的systemd单元文件，可能需要根据实际环境调整参数。

参与项目

这是一个托管在https://github.com/Hetsh/docker-jellyfin%E4%B8%8A%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%EF%BC%8C%E6%AC%A2%E8%BF%8E%E6%8F%90%E9%97%AE%E3%80%81%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E6%88%96%E8%B4%A1%E7%8C%AE%E4%BB%A3%E7%A0%81%E3%80%82