如何轻松配置Jellyfin端口，实现家庭影院无障碍远程访问？

一、什么是 Jellyfin？说起来，

Jellyfin 是一款开源的媒体服务器软件。能够帮助您在家中建立强大的媒体库，并将视频、音乐、图片等内容分发到任何支持的家庭影院设备上。其实，相比传统的商业媒体服务器，Jellyfin 完全免费且高度可定制。深受技术爱好者和家庭使用者的喜爱。

二、使用者常见痛点

• ❌ 远程访问总是提示“无法连接”，不知道是哪一步出了问题。
• ❌ 防火墙默认阻止了 Jellyfin 的端口，导致局域网内外都访问不了。
• ❌ 公司的网络安全策略要求更改默认端口，却找不到配置入口。
• ❌ 修改完端口后忘记重新启动，仍然看到旧端口的错误信息。

三、在 CentOS 上定位并编辑 Jellyfin 配置文件

1. 找到配置文件所在目录

在 CentOS 程序中，Jellyfin 的主要配置文件通常位于 /etc/jellyfin/ 目录下。最常用的配置文件是 config.yaml。

sudo nano /etc/jellyfin/config/config.yaml

2. 修改端口设置

打开后找到类似下面的行：

server:
port这方面。8096

将默认的 8096 改成您想要使用的端口，例如 8080。说到修改后应该是，

server:
至于port，8080

3. 保存并关闭编辑器

在 nano 中。按 Ctrl + X → 按 Y 确认保存 → 按 Enter 完成退出。

四、让防火墙放通新端口

1. 添加永久规则

# 将 8080 替换为您实际使用的端口号
sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp

2. 重新加载防火墙，使规则立即生效

sudo firewall-cmd --reload

3. 检查端口是否已经打开

# 查看 public 区域已开放的端口列表
sudo firewall-cmd --zone=public --list-ports
# 应该能看到类似 “8080/tcp” 的输出

五、重启 Jellyfin 服务。 使新配置生效

# 重新启动
sudo systemctl restart jellyfin
# 可选：检查服务状态确保没有报错
sudo systemctl status jellyfin

六、验证远程访问是否成功

a) 局域网内测试：

• 在同一网络下的电脑或手机浏览器打开：:8080/`。
• If web UI loads normally,port configuration is correct.

b) 外网测试：

• 确保路由器已将外部请求转发到内部服务器对应的 IP 与新端口。
• 使用外部网络访问：:8080/`。
• If you see Jellyfin login page,remote access is fully functional.

七、常见错误及快速排查教程

问题表现	可能原因 & 解决办法
"连接超时"	- 防火墙未放通新端口 - 路由器未做正确的端口映射 - 服务未成功重启。请检查`systemctl status jellyfin`
"页面显示 404 或空白"	- 配置文件中的 port 行缩进错误 - 使用了已经被占用的端口，请换一个未使用的端口再尝试。
"登录后媒体库为空"	- 实际访问的是旧实例，请确认浏览器地址栏中的端口与 config.yaml 中一致。
"SSL/TLS 无法工作"	- 如果同时修改了 HTTPS 端口，需要在同一文件中更新 `https_port` 并在防火墙开放对应的 8920 或自定义值。其实，

八、轻松搞定 Jellyfin 远程访问。让家庭影院随时随地畅享，

只要按照这些步骤：定位配置文件 → 修改所需端口 → 防火墙放通 → 重新启动 → 验证连通性。就能彻底摆脱“只能在本地观看”的尴尬，实现真正意义上的无障碍远程访问。以后想换一个更安全、更符合公司政策的端口。只需要重复第 3‑5 步即可，无需重新安装或大幅改动程序。

祝您观影愉快 🎬🍿！其实，