ubuntu jellyfin配置方法
小樊
31
2025-12-22 19:55:38
Ubuntu 下 Jellyfin 配置全流程
一 环境准备与安装
- 更新系统并安装依赖
- sudo apt update && sudo apt upgrade -y
- sudo apt install -y apt-transport-https ca-certificates curl gnupg
- 导入 GPG 密钥(推荐写入 keyrings)
- sudo mkdir -p /etc/apt/keyrings
- curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
- 添加 APT 仓库(自动识别发行版代号)
- echo “deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(awk -F= ‘/^VERSION_CODENAME=/{print $2}’ /etc/os-release) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
- 安装并启动服务
- sudo apt update && sudo apt install -y jellyfin
- sudo systemctl enable --now jellyfin
- sudo systemctl status jellyfin
- 防火墙放行(如启用 UFW)
- sudo ufw allow 8096/tcp
- 如使用云服务器,还需在云平台安全组放行 TCP 8096。
二 首次初始化设置
- 访问 Web 界面:在浏览器打开 http://服务器IP:8096
- 设置管理员账户与密码
- 添加媒体库
- 选择内容类型(如:电影、电视剧、音乐)
- 指定媒体文件夹路径(需保证 Jellyfin 进程可读)
- 选择元数据语言(如:中文)
- 远程访问:按需开启“允许远程访问”
- 完成后进入控制台进行用户、播放、转码等细化设置。
三 反向代理与 HTTPS(Apache 示例)
- 安装与启用模块
- sudo apt install -y apache2 certbot python3-certbot-apache
- sudo a2enmod proxy proxy_http ssl proxy_wstunnel remoteip http2 headers
- sudo systemctl restart apache2
- 获取证书(将域名替换为你的)
- sudo certbot certonly --agree-tos --email you@example.com --no-eff-email --webroot -w /var/www/html -d your_domain
- 配置虚拟主机 /etc/apache2/sites-available/jellyfin.conf
- 建议将 HTTP 重定向到 HTTPS,并在 443 虚拟主机中反向代理到 http://127.0.0.1:8096
- 注意 WebSocket:ProxyPass “/socket” “ws://127.0.0.1:8096/socket”
- 启用站点并重启
- sudo a2ensite jellyfin.conf && sudo systemctl reload apache2
- 访问:使用 https://your_domain 打开 Jellyfin。
四 权限与路径排错要点
- 目录权限与所有权
- 若媒体目录无法读取,修正权限与属主(示例将目录替换为你的实际路径):
- sudo chmod 755 -R /path/to/media
- sudo chown -R jellyfin:jellyfin /path/to/media
- 防火墙与云安全组
- 本地防火墙放行 8096/tcp
- 云服务器需在控制台安全组放行 TCP 8096
- 服务状态与日志
- 查看与重启:sudo systemctl status jellyfin / sudo systemctl restart jellyfin
- 日志路径:/var/log/jellyfin/(排查启动、扫描、播放问题)。
五 Docker 部署与中文界面(可选)
- 安装 Docker(略)
- 运行容器(将卷与用户 ID 替换为你的环境)
- sudo docker run -d
–name jellyfin
–volume /path/to/media:/media
–volume /path/to/config:/config
-e UID=1000 -e GID=1000
-p 8096:8096
jellyfin/jellyfin
- 访问 http://localhost:8096 完成初始化,在“设置 → 界面语言”选择 中文。