Jellyfin中文歌词显示乱码如何解决？

Question

Jellyfin播放音乐时，中文歌词显示乱码是常见问题，主要因歌词文件编码格式不兼容所致。多数情况下，LRC或TXT歌词文件采用GBK或GB2312编码，而Jellyfin默认以UTF-8解析，导致中文字符无法正确识别，出现乱码。解决方法包括：将歌词文件统一转换为UTF-8编码，可使用文本编辑器（如Notepad++）手动转换；或在Jellyfin服务器端配置字符集自动检测规则，启用“强制使用本地编码”选项。此外，确保媒体库扫描设置中启用了歌词加载功能，并检查文件命名是否与音频文件一致。通过编码统一和配置优化，可有效解决中文歌词乱码问题。

Answer 1

1. 问题背景与现象描述

Jellyfin作为一款开源媒体服务器，在音乐播放场景中广泛用于家庭影音中心或企业级数字资产管理。然而，许多用户在使用过程中发现中文歌词显示为乱码，严重影响用户体验。该问题普遍出现在包含LRC或TXT格式外挂歌词的音频文件播放时。

典型表现为：歌词内容出现“锟斤拷”、“锘挎牸”等无法识别的字符，时间轴正常但文本不可读。这一现象的根本原因在于字符编码不匹配——原始歌词文件多采用GBK或GB2312编码（尤其来自国内音乐资源站），而Jellyfin服务端默认以UTF-8编码解析文本内容，导致解码失败。

2. 编码机制分析：从字符集到解码流程

• UTF-8：Unicode标准编码，支持全球语言，是现代Web和Linux系统的主流编码方式。
• GBK/GB2312：中国国家标准汉字编码，常见于Windows系统及早期中文文本文件，不具备跨平台兼容性。
• Jellyfin在扫描媒体库时会自动加载同名歌词文件（如song.lrc），并通过内置文本解析模块读取内容。若未启用编码检测机制，则强制按UTF-8处理非UTF-8文件，必然产生乱码。

下表列出常见歌词文件编码特征：

编码类型	字节序标记（BOM）	中文存储方式	Jellyfin默认支持
UTF-8	可选（EF BB BF）	变长多字节	✅ 原生支持
UTF-8 with BOM	存在	同上	⚠️ 部分版本识别异常
GBK	无	双字节表示汉字	❌ 默认不识别
GB2312	无	子集于GBK	❌ 同样存在问题

3. 解决方案路径一：客户端编码转换

最直接有效的方法是对所有歌词文件进行批量编码转换，统一为UTF-8格式。操作步骤如下：

1. 定位歌词文件目录，通常与音频文件位于同一路径。
2. 使用支持编码转换的文本编辑器（如Notepad++）打开LRC/TXT文件。
3. 选择菜单栏“编码” → “转换为UTF-8编码”或“另存为UTF-8”。
4. 保存并覆盖原文件或生成新副本。
5. 重新触发Jellyfin媒体库扫描（设置 → 库 → 扫描媒体库）。

自动化脚本示例（Python）：

import os
import chardet

def convert_to_utf8(file_path):
    with open(file_path, 'rb') as f:
        raw_data = f.read()
        encoding = chardet.detect(raw_data)['encoding']
    
    try:
        content = raw_data.decode(encoding)
        with open(file_path, 'w', encoding='utf-8') as f:
            f.write(content)
        print(f"Converted {file_path} from {encoding} to UTF-8")
    except Exception as e:
        print(f"Failed to convert {file_path}: {e}")

# 批量处理目录下所有.lrc文件
lyric_dir = "/path/to/lyrics"
for file in os.listdir(lyric_dir):
    if file.endswith(".lrc"):
        convert_to_utf8(os.path.join(lyric_dir, file))

4. 解决方案路径二：服务端配置优化

Jellyfin自0.16版本起引入了实验性编码检测功能。可通过修改服务器配置文件或UI设置启用本地编码兼容模式。

操作步骤：

1. 登录Jellyfin管理后台。
2. 进入“Dashboard” → “Playback” → “Subtitles and Lyrics”。
3. 勾选“Enable character encoding detection for subtitles”选项。
4. 启用“Force local encoding”以优先尝试系统区域编码（如zh-CN对应GBK）。
5. 重启Jellyfin服务使配置生效。

高级用户可手动编辑encoding.json配置文件：

{
  "SubtitleEncoding": "auto",
  "EnableEncodingDetection": true,
  "ForcedEncoding": "GBK"
}

5. 系统级排查与验证流程图

graph TD
    A[开始] --> B{歌词是否显示乱码?}
    B -- 是 --> C[检查歌词文件是否存在]
    C -- 不存在 --> D[确认命名一致性: audio.mp3 ↔ audio.lrc]
    D --> E[创建或同步歌词文件]
    C -- 存在 --> F[检测当前编码格式]
    F --> G[使用chardet/file命令判断编码]
    G --> H{是否为UTF-8?}
    H -- 否 --> I[批量转换至UTF-8]
    H -- 是 --> J[检查Jellyfin歌词加载设置]
    J --> K[启用编码自动检测]
    K --> L[重启服务并重新扫描库]
    L --> M[验证修复效果]
    M --> N[结束]

6. 进阶建议与长期维护策略

• 建立标准化元数据流程：在媒体入库前通过自动化工具（如MediaElch、Tiny Media Manager）统一处理歌词编码。
• 使用嵌入式歌词替代外挂文件：将LRC内容写入ID3v2 USLT帧，避免编码分离问题。
• 监控日志输出：查看jellyfin.log中是否有“Failed to decode subtitle”相关错误。
• 容器部署注意事项：Docker环境中需确保宿主机与容器共享locale设置，防止编码环境割裂。
• 社区插件扩展：关注Jellyfin社区开发的歌词增强插件，部分已集成智能编码识别引擎。

对于大型媒体库，推荐结合CI/CD思想构建“媒体质量门禁”系统，对新增文件自动执行编码校验与转换任务。