centos上jellyfin的端口配置方法

CentOS 上 Jellyfin 端口配置方法

一 系统服务方式修改端口

• 编辑配置文件：打开 /etc/jellyfin/config/config.yaml，在 server 段设置端口与监听地址，例如将 HTTP 改为 8080，并确保监听所有地址：

  server:
    port: 8080
    host: 0.0.0.0
  

  如需启用 HTTPS，可同时设置 httpsPort: 8920（并在控制台配置证书）。修改后重启服务：

  sudo systemctl restart jellyfin
  

• 放行防火墙（firewalld）：开放对应端口（示例为 8080/TCP；若启用 HTTPS，同时放行 8920/TCP）

  sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp
  sudo firewall-cmd --permanent --zone=public --add-port=8920/tcp  # 可选
  sudo firewall-cmd --reload
  

• 访问测试：浏览器打开 http://服务器IP:8080。若使用云服务器，还需在云厂商安全组放行对应端口。

二 Docker 部署的端口映射

• 映射常用端口（示例将宿主机 8080 映射到容器 8096，同时映射 HTTPS、自动发现与 DLNA 端口）：

  docker run -d --name=jellyfin \
    -p 8080:8096 \
    -p 8920:8920 \
    -p 7359:7359/udp \
    -p 1900:1900/udp \
    -v /srv/jellyfin/config:/config \
    -v /srv/jellyfin/cache:/cache \
    -v /media:/media \
    -e TZ=Asia/Shanghai \
    --restart unless-stopped \
    nyanmisaka/jellyfin:latest
  

  如需使用主机网络模式（–net=host），容器内端口即为宿主机端口，注意避免端口冲突。
• 防火墙放行（示例为 8080/TCP 与 1900/UDP；若启用 HTTPS，放行 8920/TCP）

  sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp
  sudo firewall-cmd --permanent --zone=public --add-port=1900/udp
  sudo firewall-cmd --permanent --zone=public --add-port=8920/tcp  # 可选
  sudo firewall-cmd --reload
  

• 访问测试：浏览器打开 http://服务器IP:8080。

三 常用端口与作用

四 排查与注意事项

• 服务状态与日志：

  sudo systemctl status jellyfin
  sudo journalctl -xeu jellyfin
  sudo tail -n 50 /var/log/jellyfin/*.log
  

• 配置热加载：修改 config.yaml 后需重启服务生效（Docker 需重建或重启容器）。
• 云服务器安全组：除 firewalld 外，还需在云平台安全组放行对应端口（如 8080/TCP、1900/UDP）。
• 端口冲突：避免将 Jellyfin 端口与系统已有服务（如 8080 被其他程序占用）冲突；必要时更换端口并同步防火墙规则。