gongyho/jellyfin

定制Jellyfin镜像（含中文字体支持）

镜像概述

本镜像基于linuxserver/jellyfin构建，是一个预配置中文字体支持的Jellyfin媒体服务器镜像。通过预先安装fonts-noto-cjk-extra字体包，解决了Jellyfin在显示中文内容时可能出现的乱码问题，确保中文标题、字幕等内容正常显示。

核心功能与特性

• 基于官方镜像：保留linuxserver/jellyfin镜像的全部功能和特性
• 中文字体支持：已预安装fonts-noto-cjk-extra字体包，提供完整的CJK（中日韩）字符集支持
• 即开即用：无需手动安装字体，部署后直接解决中文乱码问题
• 兼容性：与linuxserver/jellyfin镜像的配置方式、环境变量和数据卷完全兼容

使用场景

• 媒体库中包含中文标题、描述或元数据的Jellyfin服务器部署
• 需要显示中文字幕的视频播放场景
• 对中文界面显示有要求的个人或家庭媒体中心
• 希望避免手动配置字体的Jellyfin初学者用户

使用方法与配置说明

基本使用（Docker Run）

使用以下命令启动容器，参数与linuxserver/jellyfin基本一致：

shell
docker run -d \
  --name=jellyfin-cn \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8096:8096 \
  -p 8920:8920 \
  -v /path/to/config:/config \
  -v /path/to/media:/media \
  --restart unless-stopped \
  [镜像名称]

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: "3.8"
services:
  jellyfin:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: jellyfin-cn
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    ports:
      - "8096:8096"
      - "8920:8920"
    volumes:
      - /path/to/config:/config
      - /path/to/media:/media
    restart: unless-stopped

启动命令：docker-compose up -d

配置说明

• 环境变量：与linuxserver/jellyfin完全一致，主要包括PUID（用户ID）、PGID（组ID）、TZ（时区）等
• 数据卷：
  • /config：Jellyfin配置文件存储目录
  • /media：媒体文件存储目录
• 端口映射：
  • 8096：HTTP访问端口
  • 8920：HTTPS访问端口（如启用）

验证中文字体

容器启动后，可通过以下方式验证字体是否安装成功：

1. 进入容器：docker exec -it jellyfin-cn bash
2. 检查字体文件：fc-list | grep "Noto Sans CJK"

如显示Noto Sans CJK相关字体信息，说明字体安装成功。