LM Studio 本地服务 1234 端口被占用怎么换端口

现象

Windows 上打开 LM Studio 的 LoCal Server,界面显示 Running,但用 curl 请求 HTTP://127.0.0.1:1234/v1/models 报 Failed to connect to 127.0.0.1 port 1234: Connection refused。浏览器直接访问也一样,重启软件后短暂可用,过一会又连不上。

原因

1234 是 LM Studio 的默认端口,很容易和别的本地服务撞车,比如某些代理工具、前端 mock 服务或者另一个推理框架。端口被占用时 LM Studio 不一定会弹窗,只是监听失败,界面仍然显示启动成功。另一种情况是它只绑定了 IPv6 回环地址,用 127.0.0.1 访问自然被拒绝。

解决步骤

第一步,确认是谁占了端口。用系统自带命令查监听进程,记下 PID 后再决定是结束它还是给 LM Studio 换端口。

netstat -ano | findstr :1234
taskkill /PID 8124 /F
netstat -ano | findstr :1234

第二步,换一个不冲突的端口。在 LM Studio 的 Developer 页面把端口改成 1235 或 18080,重新启动服务,用 curl 验证返回的模型列表。端口号建议固定在四位数以上,避开常用开发端口。

第三步,处理只监听 IPv6 的情况。如果 netstat 里只看到 [::1]:1234,把服务地址改成 127.0.0.1 再启动;需要局域网访问时绑定 0.0.0.0,并在防火墙放行对应端口,不要直接暴露到公网。

验证

curl 返回 JSON,里面有 data 数组和模型 id;同时 netstat 显示监听地址与预期一致,杀掉旧进程后端口不再被抢占,连续重启两次都能连上,说明问题解决。

小结

界面显示 Running 不等于端口可用,先 netstat 定位占用,再改端口并确认监听地址。把端口写进固定配置,比每次开机手工点一遍更稳。

您可以还会对下面的文章感兴趣: