端口修改与冲突解决——让 KsuWebUI 和其他服务共存

为什么默认是 8080

8080 是 HTTP 服务常用的替代端口——当 80 端口被系统占用时，Web 服务通常选择 8080。Android 系统的本地回环接口 127.0.0.1:8080 通常没有被占用。

什么时候会端口冲突

手机上其他 APP 也可能在本地启动 Web 服务：

• 某些游戏加速器
• 代理工具（如 Clash 的 Web UI 默认也用 8080）
• 其他模块管理器

如果 KsuWebUI 启动时发现 8080 被占了，它会报「Web 服务初始化失败」。

修改端口步骤

1. 打开 KsuWebUI APP
2. 进入设置页面
3. 找到「本地服务端口」或「Port」配置项
4. 输入新端口（比如 8081、8888、9000）
5. 保存设置
6. 重启 KsuWebUI APP 让新端口生效

重启后新地址变成：

• 本地访问：http://127.0.0.1:新端口
• 远程访问：http://手机IP:新端口

选什么端口好

建议选择 1024-65535 之间的高位端口，避开常见的：

选一个你手机上没有其他服务在用的高位端口，比如 8092、9173 之类不太常见的。

修改后注意事项

• 远程访问时记得同步更新电脑浏览器的地址
• 如果局域网 IP 也变了（WiFi 重连后 DHCP 可能重新分配），要一起改
• 某些脚本或快捷方式里如果硬编码了端口，也要同步修改

端口冲突排查

不确定是不是端口冲突导致的启动失败？可以用终端命令排查：

su
netstat -tlnp | grep 8080

如果有输出，说明 8080 确实被占用了，输出里会告诉你是哪个进程。

其他解决思路

如果不想换端口，也可以考虑：

• 关闭占用端口的其他 APP
• 临时禁用冲突的模块
• 在路由器上用端口转发（适用于远程访问场景的高级玩法）