swearl/jellyfin

Jellyfin中文优化镜像

镜像概述和主要用途

该镜像基于linuxserver/jellyfin官方镜像构建，通过预装必要的字体支持组件，专门解决Jellyfin媒体服务器在显示中文内容时出现的乱码（囗囗）问题。保留了Jellyfin的全部核心功能，同时确保中文标题、描述等内容能够正确显示。

核心功能和特性

• 基于官方镜像：保留linuxserver/jellyfin的全部功能和特性
• 中文显示优化：预装fontconfig字体配置工具和fonts-noto-cjk中文字体包
• 源加速优化：将apt源替换为网易163镜像，提升依赖包安装速度
• 镜像精简：清理安装缓存，减小镜像体积

使用场景和适用范围

• 中文媒体库管理，需要正确显示中文标题、描述的Jellyfin用户
• 解决原版Jellyfin镜像中文显示乱码问题的场景
• 所有基于linuxserver/jellyfin的常规使用场景，包括家庭媒体中心、个人视频服务器等

使用方法和配置说明

Docker Run命令示例

bash
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配置示例

yaml
version: '3'
services:
  jellyfin:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    container_name: jellyfin-cn
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    ports:
      - "8096:8096"  # HTTP端口
      - "8920:8920"  # HTTPS端口
    volumes:
      - /path/to/config:/config  # 配置文件目录
      - /path/to/media:/media    # 媒体文件目录
    restart: unless-stopped

参数说明

• PUID/PGID：运行Jellyfin的用户ID和组ID，确保对挂载目录有正确权限
• TZ：时区设置，建议设置为Asia/Shanghai
• 端口映射：8096为HTTP访问端口，8920为HTTPS访问端口
• 卷挂载：
  • /config：存储Jellyfin配置文件
  • /media：存储媒体文件

注意事项

• 替换命令中的[镜像名称]:[标签]为实际使用的镜像名称和版本标签
• 根据实际需求调整PUID、PGID、时区和挂载路径
• 该镜像已内置中文字体支持，无需额外安装字体文件
• 使用方法与linuxserver/jellyfin官方镜像完全一致，仅解决了中文显示问题

镜像构建说明

该镜像通过以下Dockerfile构建：

dockerfile
FROM linuxserver/jellyfin

RUN sed -i 's/http:\/\/archive\.ubuntu\.com\/ubuntu\//http:\/\/mirrors\.163\.com\/ubuntu\//' /etc/apt/sources.list \
    && mv /etc/apt/sources.list.d/intel-graphics.list /etc/apt/sources.list.d/intel-graphics.list.bak \
    && apt update \
    && apt install -y fontconfig fonts-noto-cjk \
    && rm -rf /tmp/* /var/lib/apt/lists/* /var/tmp/*