Q3.部署完成后无法使用Kilolink Server Pro

问题背景

在Kilolink Server Pro部署完成后，难以访问Web界面、注册设备和创建绑定，主要原因是端口问题。

常见问题排查思路

一、云服务器端口未开放导致无法使用的常见场景

1. 云服务器（如 AWS、阿里云）上部署后，Web 访问失败（无法打开 Kilolink Server Pro Web 界面）
   • 原因： Kilolink Server Pro Web 访问依赖 TCP 80:80 端口（默认） ，若云服务器安全组、防火墙未开放该端口，外部无法建立 TCP 连接访问 Web 界面。
   • 解决方法（以 AWS、阿里云为例）：
     • AWS： 登录 AWS 控制台 → 进入 EC2 实例 → 找到对应安全组 → 添加入站规则，协议选 TCP，端口填 80:80，来源设为需要访问的 IP（可临时设为 0.0.0.0/0 测试，生产环境建议限制具体 IP ）；同时检查实例防火墙（如ufw firewalld ），确保未拦截 80 端口。
     • 阿里云：登录阿里云控制台 → 进入云服务器 ECS → 找到对应实例的安全组 → 配置入站规则，开放 TCP 80:80 端口；登录服务器执行systemctl status firewalld（或对应防火墙服务），确认防火墙未屏蔽该端口，必要时添加放行规则（如firewall-cmd --permanent --add-port=80/tcp --reload ）。
2. 设备外接访问异常（Encode/Decode Device external access 失败）
   • 原因： 设备外接访问依赖 UDP 50000:50001 端口（默认） ，云服务器未开放该 UDP 端口时，外部设备无法与 Kilolink Server Pro 建立数据传输通道。

• 解决方法（以 AWS、阿里云为例）：
  • AWS：在 EC2 安全组入站规则中，添加 UDP 50000:50001 端口，来源按需配置（测试可设 0.0.0.0/0 ）；登录服务器检查iptables或firewalld，确保未拒绝 UDP 50000 - 50001 流量（如firewall-cmd --permanent --add-port=50000-50001/udp --reload ）。
  • 阿里云：在 ECS 安全组入站规则开放 UDP 50000:50001 端口；登录服务器验证防火墙规则，确保端口未被拦截，必要时手动添加放行策略。

3. mDNS（NDI Stream Discovery）功能失效
   • 原因：mDNS 依赖 UDP 5353:5353 端口（默认） ，云服务器未开放该端口时，NDI 流发现功能无法正常工作，导致无法识别、调用 NDI 流。
   • 解决方法（以 AWS、阿里云为例）：
     • AWS：在安全组入站规则添加 UDP 5353:5353 端口，来源设为内网或需要的 IP 范围（因 mDNS 多为局域网场景，公网环境需结合实际需求）；检查服务器防火墙，确保允许 UDP 5353 流量。
     • 阿里云：在 ECS 安全组开放 UDP 5353:5353 端口；登录服务器确认防火墙未屏蔽该端口，可通过telnet或nc工具测试端口是否可访问（如nc -uzv 127.0.0.1 5353）。
4. 音视频流传输异常（AV stream deliver 失败）
   • 原因：AV stream deliver 依赖 TCP/UDP 30000:30300 端口（默认动态范围） ，若云服务器安全组、防火墙未开放该端口段，音视频流无法正常传输，会出现画面卡顿、无法预览等问题。
   • 解决方法（以 AWS、阿里云为例）：
     • AWS：在安全组入站规则添加 TCP 和 UDP 的 30000:30300 端口段，来源按需配置（测试可放宽，生产环境建议限定业务 IP ）；检查服务器防火墙，确保该端口段流量可通过（如firewall-cmd --permanent --add-port=30000-30300/tcp --add-port=30000-30300/udp --reload ）。
     • 阿里云：在 ECS 安全组开放 TCP/UDP 30000:30300 端口段；登录服务器验证防火墙规则，确保端口段未被拦截，可通过模拟音视频流传输测试（如使用ffmpeg推送测试流）验证端口是否生效。
5. NDI 流控制 / 传输异常（NDI stream Control/Delivery 失败）
   • 原因：NDI stream Control 依赖 TCP 5960:6500 端口（默认） ，NDI stream deliver 依赖 UDP/TCP 7960:10000 端口（默认） ，若这些端口未开放，会导致 NDI 流控制指令无法下发、流数据无法传输。
   • 解决方法（以 AWS、阿里云为例）
     • AWS：在安全组入站规则分别开放 TCP 5960:6500、UDP/TCP 7960:10000 端口段；检查服务器防火墙，确保对应端口流量可通过（如添加firewall-cmd --permanent --add-port=5960-6500/tcp --add-port=7960-10000/udp --add-port=7960-10000/tcp --reload ）。
     • 阿里云：在 ECS 安全组配置对应端口开放规则；登录服务器验证防火墙策略，通过 NDI 流测试工具（如 NDI Tools 的ndi-send/ndi-receive ）验证端口是否正常工作。

二、云服务器端口开放通用检查流程

1、确认云服务商安全组规则：登录 AWS、阿里云等控制台，检查对应实例的安全组，确保入站规则包含 Kilolink Server Pro 所需的静态 / 动态端口（参考端口说明表），协议（TCP/UDP）、端口范围、来源 IP 配置正确。

2、验证服务器本地防火墙：登录 Kilolink Server Pro 所在服务器，通过firewall-cmd（CentOS/RHEL）、ufw（Ubuntu）或iptables等工具，检查防火墙是否放行相关端口，必要时添加放行规则并重启防火墙服务。

3、测试端口可达性：使用外部设备（如本地电脑）通过telnet（TCP）、nc -u（UDP）测试云服务器公网 IP 的目标端口是否可访问（如telnet 公网IP 80测试 Web 端口，nc -uzv 公网IP 5353测试 mDNS 端口 ），若不通则回到前两步排查配置。

三、总结

Kilolink Server Pro 部署后无法使用，若因端口未开放导致，需重点检查云服务器（AWS、阿里云等）的安全组规则和本地防火墙配置，确保静态端口（80、50000 - 50001、5353 等）、动态端口（30000 - 30300、5960 - 6500、7960 - 10000 等）按协议（TCP/UDP）开放，通过 “检查安全组→验证本地防火墙→测试端口可达性” 三步排查，可快速定位并解决端口相关问题。