OEC-T改造手记（三）：避坑指南！在Armbian上完美安装并配置Jellyfin

最新推荐文章于 2025-12-19 23:30:22 发布

原创最新推荐文章于 2025-12-19 23:30:22 发布 · 767 阅读

7 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#linux #电视盒子

折腾日常专栏收录该内容

6 篇文章

订阅专栏

经历了基础搭建和文件同步，我的OEC-T终于迎来了最终使命——成为家庭媒体中心。我选择了 Jellyfin 这款开源免费的媒体服务器软件。然而，从安装、配置到刮削媒体信息，整个过程可谓“坑”不断，特此整理成避坑指南。

一、安装方式的选择与国内源配置

最初，我试图通过CasaOS的应用商店直接安装Jellyfin的Docker镜像，但镜像拉取屡屡失败，更换多个国内镜像站也无果。最终，我选择了更直接的 apt 安装方式，但这同样需要配置国内软件源。

1. 添加Jellyfin官方仓库的国内镜像
访问 https://mirrors.cernet.edu.cn/list/jellyfin 可查看国内镜像站列表。我选择了南京大学的镜像。

# 1. 安装HTTPS传输支持
sudo apt install apt-transport-https
# 2. 导入Jellyfin GPG密钥
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
# 3. 添加仓库 (注意：jammy对应Ubuntu 22.04，请根据你的系统版本修改)
echo "deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://mirror.nju.edu.cn/jellyfin/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

2. 安装Jellyfin

sudo apt update
sudo apt install jellyfin

安装完成后，服务会自动创建，但先不要启动，我们需要先解决存储空间问题。

二、迁移数据目录：拯救捉襟见肘的系统盘

默认安装会将数据、缓存等存放在系统盘（/var/lib/jellyfin），对于OEC-T的小容量eMMC来说是灾难。我们必须将其迁移到之前挂载的大硬盘上。

1. 停止服务并编辑环境文件

sudo systemctl stop jellyfin
sudo nano /etc/default/jellyfin

2. 修改或添加以下关键配置
找到或添加以下行，指向你的新硬盘挂载目录（例如我的是 /home/pzzhao/download/jellyfin）：

# 自定义目录配置
JELLYFIN_DATA_DIR="/home/pzzhao/download/jellyfin/data"
JELLYFIN_CONFIG_DIR="/home/pzzhao/download/jellyfin/config"
JELLYFIN_LOG_DIR="/home/pzzhao/download/jellyfin/logs"
JELLYFIN_CACHE_DIR="/home/pzzhao/download/jellyfin/cache"

# 核心：确保服务启动参数包含这些目录
JELLYFIN_SERVICE_OPT="--service --datadir $JELLYFIN_DATA_DIR --cachedir $JELLYFIN_CACHE_DIR --configdir $JELLYFIN_CONFIG_DIR --logdir $JELLYFIN_LOG_DIR"

3. 创建目录并迁移数据（如适用）

# 创建所有目录
sudo mkdir -p /home/pzzhao/download/jellyfin/{data,config,logs,cache}
# 设置所有权给jellyfin用户
sudo chown -R jellyfin:jellyfin /home/pzzhao/download/jellyfin
# 可选：如果旧目录已有数据（如首次安装后已运行过），可以迁移过来
sudo cp -r /var/lib/jellyfin/* /home/pzzhao/download/jellyfin/data/ 2>/dev/null || true

4. 重启服务并验证

sudo systemctl daemon-reload
sudo systemctl start jellyfin
sudo systemctl status jellyfin # 检查状态

访问 http://你的OEC-T-IP:8096，如果能打开设置向导，说明迁移成功。

三、避坑指南：媒体库刮削失败问题排查

设置好媒体库后，Jellyfin无法从豆瓣等渠道刮削影片元数据（封面、简介等）。经排查，主要有两个原因。

⚠️ 坑一：数据目录权限不足
Jellyfin服务以 jellyfin 用户运行，它需要对数据目录有写入权限。

# 检查目录权限
ls -la /home/pzzhao/download/jellyfin/data/
# 如果所属用户/组不是jellyfin，或者权限过窄，使用chown和chmod修复
sudo chown -R jellyfin:jellyfin /home/pzzhao/download/jellyfin
# 更宽松的权限设置（生产环境建议细化权限）
sudo chmod -R 755 /home/pzzhao/download/jellyfin

⚠️ 坑二（最隐蔽）：ffmpeg路径问题
通过 apt 安装的Jellyfin，其自带的 ffmpeg 和 ffprobe 位于 /usr/lib/jellyfin-ffmpeg/ 下，并不在系统的默认PATH中。这导致Jellyfin在转码或调用这些工具时失败，进而影响刮削等功能。

解决方案：创建符号链接到系统路径

sudo ln -sf /usr/lib/jellyfin-ffmpeg/ffmpeg /usr/bin/ffmpeg
sudo ln -sf /usr/lib/jellyfin-ffmpeg/ffprobe /usr/bin/ffprobe

执行后，在终端输入 ffmpeg -version 测试，应能正常显示版本信息。

四、配置为系统服务（补充）

通常 apt 安装后服务已就绪。你可以使用以下命令管理：

# 启用开机自启
sudo systemctl enable jellyfin
# 常用命令
sudo systemctl start|stop|restart|status jellyfin
# 查看实时日志
sudo journalctl -u jellyfin -f

总结与成果

至此，所有“坑”已被填平。我的网心云OEC-T成功变身为一个：

存储充足：所有媒体文件和数据都存放在外接大容量SSD上。
同步自动化：通过Syncthing从下载机自动获取新影片。
功能完善的媒体中心：Jellyfin提供精美的海报墙、流畅的转码播放，支持全平台客户端。

这台成本低廉的“矿渣”设备，经过一番折腾，终于完美融入了我的数字生活。希望这个系列记录能帮助你少走弯路，享受DIY的乐趣！