Ubuntu 上 Jellyfin 使用字幕的完整指南
一 快速使用与播放器内选择
- 在 Jellyfin 网页/客户端 播放影片时，打开播放器的 字幕/Subtitles 菜单，选择需要的语言（如 Chinese/中文）。
- 若当前没有可用字幕，可先播放其他语言的字幕，再在菜单中切换到中文（若已下载或服务器能自动提供）。
二 自动下载字幕插件
- 官方 Open Subtitles 插件
- 进入 控制台 → 插件 → 目录，在官方目录中找到并安装 Open Subtitles 插件；安装后按提示配置 OpenSubtitles 账号 与语言偏好，之后在影片详情页或播放界面可自动/手动搜索并下载中文字幕。
- 第三方中文字幕插件（适合国内网络）
- 添加外部插件源（任选其一）：
- MaxSubtitle：仓库 URL（国内）https://gitee.com/caryyu/jellyfin-plugin-repo/raw/master/manifest-cn.json；（国际）https://github.com/caryyu/jellyfin-plugin-repo/raw/master/manifest-us.json
- MeiamSubtitles：https://github.com/91270/MeiamSubtitles.Release/raw/main/Plugin/manifest-stable.json
- 备用中文源（含迅雷/射手等）：https://gitee.com/jjm2473/jellyfin-plugins-repo/raw/master/manifest.json
- 进入 控制台 → 插件 → 外部插件，选择上述仓库并安装对应字幕插件；安装完成后在 控制台 → 重启 Jellyfin。
- 使用方式：在影片的 “…” → 修改字幕，选择语言（如 Chinese），点击 搜索 并下载；下载的字幕会保存到影片同目录并自动匹配文件名，后续播放可直接选择。
三 手动添加本地字幕
- 准备与影片同名、同目录的字幕文件，常见格式为 .srt、.ass；例如：
- 影片：/media/movies/电影名 (2024)/电影名 (2024).mkv
- 字幕：/media/movies/电影名 (2024)/电影名 (2024).zh.srt 或 .ass
- 刷新媒体库后，进入影片详情或播放界面，在 字幕 菜单中选择已匹配的本地字幕即可。
四 常见问题与解决
- 中文显示为方块/乱码（Docker 环境）
- 进入容器安装中文字体并重启：
- docker exec -it jellyfin /bin/bash
- apt update && apt install -y fonts-noto-cjk-extra
- exit
- docker restart jellyfin
- 如界面提供字体设置项，可将字体路径指向已安装的中文字体（如 /usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc）。
- 插件搜索不到字幕或速度慢
- 优先使用国内镜像源；必要时在插件配置中开启更积极的匹配策略。
- 若使用 Metashark 等刮削/字幕插件，登录目标站点后复制 Cookie 到插件配置可提升命中率与稳定性。
- 网络访问 GitHub 不稳定导致插件安装失败
- 可临时通过修改 hosts 或使用网络加速工具解决连接问题，再重试安装插件。
