docker-jellyfin完全指南：如何搭建你的免费媒体服务器
【免费下载链接】docker-jellyfin项目地址: https://gitcode.com/gh_mirrors/do/docker-jellyfin
Jellyfin是一款功能强大的免费开源媒体服务器软件，让你能够轻松管理和流式传输个人媒体文件，打造属于自己的家庭影院系统。通过docker-jellyfin，你可以快速部署这一强大工具，无需复杂配置即可享受高品质的媒体服务。
为什么选择docker-jellyfin？
🆓 完全免费开源
Jellyfin采用MIT许可证，所有功能完全免费，无隐藏费用或高级订阅限制。相比其他商业媒体服务器解决方案，它让你真正掌控自己的媒体内容。
🔄 跨平台支持
docker-jellyfin支持多种架构，包括：
- x86-64（amd64）
- ARM64（arm64v8）
这意味着你可以在从个人电脑到树莓派的各种设备上运行它。
🚀 丰富功能特性
- 支持多种媒体格式播放
- 自动媒体元数据搜刮与整理
- 多用户管理与权限控制
- 硬件加速转码
- 多设备同步与远程访问
- 支持DLNA和Chromecast
准备工作
在开始之前，请确保你的系统满足以下要求：
- Docker和Docker Compose已安装
- 至少2GB RAM（推荐4GB以上）
- 足够的存储空间存放媒体文件
- 稳定的网络连接
快速安装步骤
使用Docker Compose（推荐）
首先克隆仓库：
git clone https://gitcode.com/gh_mirrors/do/docker-jellyfin cd docker-jellyfin创建
docker-compose.yml文件，内容如下：--- services: jellyfin: image: lscr.io/linuxserver/jellyfin:latest container_name: jellyfin environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - JELLYFIN_PublishedServerUrl=http://192.168.0.5 #可选 volumes: - /path/to/jellyfin/library:/config - /path/to/tvseries:/data/tvshows - /path/to/movies:/data/movies ports: - 8096:8096 - 8920:8920 #可选 - 7359:7359/udp #可选 - 1900:1900/udp #可选 restart: unless-stopped根据你的实际情况修改上述文件中的路径和参数，然后启动容器：
docker-compose up -d
使用Docker命令行
如果你 prefer 使用命令行，可以直接运行：
docker run -d \ --name=jellyfin \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e JELLYFIN_PublishedServerUrl=http://192.168.0.5 `#可选` \ -p 8096:8096 \ -p 8920:8920 `#可选` \ -p 7359:7359/udp `#可选` \ -p 1900:1900/udp `#可选` \ -v /path/to/jellyfin/library:/config \ -v /path/to/tvseries:/data/tvshows \ -v /path/to/movies:/data/movies \ --restart unless-stopped \ lscr.io/linuxserver/jellyfin:latest配置参数详解
必要参数
| 参数 | 功能 |
|---|---|
-p 8096:8096 | Http webUI访问端口 |
-e PUID=1000 | 用户ID，用于权限控制 |
-e PGID=1000 | 组ID，用于权限控制 |
-e TZ=Etc/UTC | 指定时区，例如Asia/Shanghai |
-v /config | Jellyfin配置文件存储路径 |
-v /data/tvshows | 电视剧存储路径 |
-v /data/movies | 电影存储路径 |
可选参数
| 参数 | 功能 |
|---|---|
-p 8920:8920 | HTTPS webUI访问端口（需自行配置证书） |
-p 7359:7359/udp | 允许客户端在局域网发现Jellyfin服务器 |
-p 1900:1900/udp | DNLA和客户端使用的服务发现端口 |
-e JELLYFIN_PublishedServerUrl | 设置自动发现响应的域名或IP地址 |
首次访问与设置
容器启动后，打开浏览器访问http://<你的IP地址>:8096，你将看到Jellyfin的初始化向导：
- 选择语言：选择你偏好的界面语言
- 创建管理员账户：设置用户名和密码
- 添加媒体库：选择你要添加的媒体类型（电影、电视节目等）并指定对应的文件夹
- 完成设置：等待媒体库扫描完成
硬件加速配置
为了获得更好的性能，特别是在播放高清内容时，建议配置硬件加速。
Intel/AMD显卡
添加以下参数到你的启动命令中：
--device=/dev/dri:/dev/driNVIDIA显卡
首先安装NVIDIA容器运行时：
# 根据你的系统选择合适的安装方法添加以下参数到启动命令：
--runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all
树莓派
对于树莓派用户，根据不同的硬件加速方式添加相应参数：
OpenMAX (MMAL):
--device=/dev/vcsm:/dev/vcsm --device=/dev/vchiq:/dev/vchiq -v /opt/vc/lib:/opt/vc/libV4L2:
--device=/dev/video10:/dev/video10 --device=/dev/video11:/dev/video11 --device=/dev/video12:/dev/video12日常维护与更新
更新Jellyfin容器
使用Docker Compose：
docker-compose pull jellyfin docker-compose up -d jellyfin使用Docker命令行：
docker pull lscr.io/linuxserver/jellyfin:latest docker stop jellyfin docker rm jellyfin # 然后重新运行docker run命令查看日志
docker logs -f jellyfin进入容器
docker exec -it jellyfin /bin/bash常见问题解决
权限问题
如果媒体文件无法访问，通常是权限问题。确保宿主机器上的媒体文件夹权限正确，或调整PUID/PGID参数使其与宿主文件夹的所有者匹配。
可以使用以下命令查看当前用户的PUID和PGID：
id your_username性能问题
如果遇到卡顿或转码问题：
- 确保已配置硬件加速
- 检查服务器资源使用情况
- 尝试降低视频质量设置
媒体库扫描问题
如果媒体库未正确扫描：
- 检查文件夹路径是否正确映射
- 确认文件权限
- 在Jellyfin界面中手动触发扫描
结语
通过docker-jellyfin，你可以轻松搭建一个功能强大的个人媒体服务器，完全掌控自己的媒体内容。无论是在家中还是远程，都能随时随地享受你的电影、音乐和照片收藏。
Jellyfin的开源特性意味着它会不断更新和改进，社区也提供了丰富的插件和支持。开始使用docker-jellyfin，开启你的家庭媒体中心之旅吧！
【免费下载链接】docker-jellyfin项目地址: https://gitcode.com/gh_mirrors/do/docker-jellyfin
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
