Q1.在部署Kilolink Server Pro后如何修改端口和公共IP地址

12/30/2025 / 462

在Kilolink Server Pro部署完成后，需要修改端口和公网IP地址。

1.概述

在完成Kilolink Server Pro的部署工作后，若需调整端口(静态/动态)或公共IP地址，则可通过重新安装(升级)过程进行配置，或修改配置文件并重新启动服务。以下场景展示了操作方法，并适用于不同的需求(如端口冲突、网络环境变化等)。

2.通过重新安装(升级)过程修改端口和公共IP地址
(1)适用场景

(2)操作步骤
备份关键数据(可选但推荐)-
如果服务器已存在设备配置和历史数据，请执行以下命令进行备份(以避免重新安装和丢失):

#进入容器(如果需要在容器内备份数据)
docker exec -it kilolinkserver bash

#将数据目录复制到主机计算机(假设主机计算机的备份路径为/data_mack)
cp -rf /data /data_back

执行重新安装/升级命令
通过官方脚本启动重新安装过程(该脚本将触发端口和IP配置交互):
/bin/bash <( curl -fsSL https://github.com/kiloview/kInk-server/raw/main/install.sh ))
配置端口和公网IP地址

端口配置:

当脚本提示Web端口用于访问KiloLink服务器管理控制台时，输入新的Web端口(例如默认的80:80，可更改为8080);
当提示链接端口用于设备连接时，输入新的链接端口(需要是偶数，例如原始默认值50000:50001，可更改为50010:50011)

公共IP配置:

当脚本检测到需要手动配置一个公共IP地址(如在云服务器环境中)时，请输入一个新的公共IP地址(确保其与该服务器的实际公共IP地址相符)。

验证配置是否生效
重新安装后，通过新端口访问Web界面(例如http://新的公网IP:新的Web端口)，并检查
1. 设备是否正常连接(当原设备需要重新注册时，使用新的Link端口完成);
2. 端口监听状态:执行netstat-tunlp命令，确认新端口(如8080、50010)已被kilolinkserver进程占用。

3.通过修改配置文件并重启服务(无需重新安装)
(1)适用场景

(2)操作步骤(以修改Web端口和公网IP为例)

进入容器环境
执行命令以进入Kilolink Server Pro容器:
docker exec -it kilolinkserver bash
修改Web端口(Nginx配置)编辑Nginx配置文件:
vi/usr/local/openresty/nginx/conf/nginx.conf
找到服务器{listen 80;}的代码片段，将80更改为新端口(例如8080)，保存并退出(按Esc键-输入:wq)
修改公网IP(平台配置)
编辑平台配置文件:
vi/data/configs/platform.conf
找到PLATFORM-IP字段，将值更改为新的公网IP(例如PLATFORM-IP=10.0.0.100)，保存并退出。
重启服务以使配置生效重启Nginx服务:
/usr/local/openresty/nginx/sbin/nginx-s重新加载
重启Kilolin Server Pro容器(主机执行):
dockerrestart千基链接服务器
验证修改结果
访问新地址:http://新公网IP:新Web端口，确认网页界面可以登录;
检查设备连接:通过新的Link端口(例如50010)注册设备，并确认设备可以正常连接到管理。

4.常见问题和注意事项
(1)修改端口后，设备无法连接

原因：链路端口必须为偶数(如50000)，而klnkfwdportr则需要为链路端口加1(如50001)。若未能同步并修改配置文件，将导致设备连接失败。

解决方案：检查/data/config/platform.exe 中的 kInkport和klnkfwdportr字段，确保满足klnkfwdportr=klnkport+1的条件，修改后重启服务。

(2)修改公网IP后，无法访问Web界面
原因：防火墙未开放新端口(如云服务器安全组、服务器本地防火墙)。

解决方法：云服务器(如AWS和阿里云):在安全组中添加入站规则，并打开新的Web端口(如8080)和链接端口(如50010);

本地服务器：执行防火墙命令--permanent--add port=新端口/tcp(或udp)，然后执行firewall cmd --reload即可生效。

(3)动态端口范围可以修改吗?

动态端口(如30000:30300、5960:6500等)是为系统预留的媒体流传输端口，不建议进行手动修改(因为这可能会导致音频和视频流以及NDI流出现异常传输)。
如需进行调整，则需同步修改代码层面的配置(风险较高仅限专业场景适用)。

5.概要
在Kilolink Server Pro中，修改端口和公网IP地址有两种路径:

重新安装/升级流程:适用于大规模配置调整(如初始部署优化、跨:版本升级)的场景，需对端口和IP地址进行交互式配置
修改配置文件并重启:适用于小规模变更(例如临时端口调整)，需要进入容器编辑
Nginx和平台配置文件。

操作核心需注意端口关联(如Link端口和klnkfwdport)，在防火墙中开放新端口，并确保设备正常连接及网页访问。