侧边栏壁纸
博主头像
Setyg的博客

当秋风染红落叶的时候,就是新生~

  • 累计撰写 86 篇文章
  • 累计创建 66 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录
AI

LM Studio 实践:Windows 下模型存放路径与绑定内网 IP 配置

Setyg
2026-09-29 / 0 评论 / 0 点赞 / 1 阅读 / 0 字

LM Studio 实践:Windows 下模型存放路径与绑定内网 IP 配置

把 LM Studio 当成本地推理服务器用的时候,两件事最常被问到:模型文件到底放在哪,以及怎么让它只绑定内网某个 IP,好让局域网里的其他机器或别的工具直接调用。本文把这两件事一次说清,配置基于 Windows 下的真实目录实测整理。

一、模型默认存放路径

LM Studio 的数据目录在用户主目录下的 .lmstudio,模型默认放在它的 models 子目录里:

C:\Users\<用户名>\.lmstudio\models

其中 <用户名> 是本机登录用户名。Windows 的 8.3 短名形式下,同一个路径也可能显示为下面这样,两者完全等价:

C:\Users\Admini~1\.lmstudio\models

目录层级结构

模型不是平铺存放,而是按「发布者 / 模型仓库 / 量化文件」三层组织。一个实际例子:

C:\Users\<用户名>\.lmstudio\models\
└─ openbmb\
   └─ MiniCPM5-1B-GGUF\
      └─ MiniCPM5-1B-Q8_0.gguf      (约 1.1 GB)

也就是说,下载了 openbmb/MiniCPM5-1B-GGUF 这个仓库的 Q8_0 量化版本,落到磁盘上就是 models\openbmb\MiniCPM5-1B-GGUF\MiniCPM5-1B-Q8_0.gguf。想手工搬运模型时,保持这个层级把整个仓库目录拷到 models 下即可,不用逐个改配置。

.lmstudio 里还有什么

目录 / 文件作用
models\模型文件本体,默认存放位置
.internal\内部配置与缓存,本地服务的配置文件就在这里
bin\lms.exeLM Studio 命令行工具,可管理模型与本地服务
server-logs\本地服务日志
conversations\聊天记录
projects\项目数据
credentials\凭据,注意保密
hub\模型下载与 hub 相关缓存
extensions\扩展 / 插件
config-presets\模型加载参数预设
user-files\、working-directories\用户文件与工作目录
settings.json、mcp.json应用设置与 MCP 配置

因为模型和配置都在这个目录下,换机器或做备份时,整体拷走 .lmstudio 就行;如果只想搬模型,拷 models 子目录即可。

二、绑定内网 IP:改本地服务配置

本地 HTTP 服务的配置在这个文件里:

C:\Users\<用户名>\.lmstudio\.internal\http-server-config.json

默认内容大致如下(networkInterface 为 0.0.0.0,表示监听所有网卡):

{
  "autoStartOnLaunch": false,
  "port": 1234,
  "cors": true,
  "logSensitiveData": true,
  "logIncomingTokens": false,
  "verbose": true,
  "logLinesLimit": 500,
  "networkInterface": "0.0.0.0",
  "justInTimeModelLoading": true,
  "fileLoggingMode": "succinct"
}

要让服务只绑定到指定的内网 IP,把 networkInterface 改成自己机器那张内网网卡的地址即可:

{
  "autoStartOnLaunch": true,
  "port": 1234,
  "cors": true,
  "logSensitiveData": true,
  "logIncomingTokens": false,
  "verbose": true,
  "logLinesLimit": 500,
  "networkInterface": "10.172.100.219",
  "justInTimeModelLoading": true,
  "fileLoggingMode": "succinct"
}

上面 10.172.100.219 只是示例,必须换成本机实际的内网 IP(怎么查见下一节)。

字段说明

字段含义
networkInterface服务绑定的网卡地址。0.0.0.0 = 监听所有网卡;填具体 IP 则只监听该网卡
port服务端口,默认 1234
autoStartOnLaunch启动 LM Studio 时是否自动启动本地服务。false 表示需要手动开启
cors是否允许跨域请求。浏览器页面直连该接口时需要开启
justInTimeModelLoading按需加载模型:请求指定的模型未加载时自动加载,省去手工预载
verbose / logLinesLimit是否输出详细日志、日志保留行数上限
fileLoggingMode文件日志模式
logSensitiveData是否把敏感内容(提示词、补全内容等)写进日志。排查问题很有用,但涉及隐私,用完全局服务后建议按需关闭
logIncomingTokens是否记录入参 token 明细

三个必须注意的点

  • 这是严格 JSON,不要写注释。LM Studio 解析该文件时不允许 // 或 /* */,参考别人的配置时如果带了行内注释,一定要删掉,否则文件会被判为非法。
  • 改完要重启 LM Studio 或重启本地服务,配置在服务启动时读取。
  • 绑定具体 IP 之后,127.0.0.1 就访问不到了。本机上的客户端也要改用这个内网 IP;想让本机回环和局域网都能访问,就继续用 0.0.0.0。

该文件属于 LM Studio 的内部配置(放在 .internal 下),应用升级后建议复查一次字段是否仍然存在、取值有没有被重置。

三、查本机内网 IP(多网卡要挑对)

最直接的方式是开一个终端:

ipconfig

或者用 PowerShell 只列出 IPv4 地址和对应网卡:

Get-NetIPAddress -AddressFamily IPv4 |
  Where-Object { $_.IPAddress -ne '127.0.0.1' } |
  Select-Object IPAddress, InterfaceAlias, PrefixLength

需要注意的是,装了虚拟机、Hyper-V、WSL 或蓝牙的机器会列出一大堆网卡地址,容易挑错。典型输出如下:

IPAddressInterfaceAlias能不能选
10.172.100.133以太网能选,这就是真实内网地址
192.168.80.1vEthernet (Default Switch)不能选,Hyper-V 虚拟网卡
192.168.204.1VMware Network Adapter VMnet8不能选,VMware NAT 网卡
192.168.233.1VMware Network Adapter VMnet1不能选,VMware 仅主机网卡
169.254.191.203以太网 3不能选,169.254.x.x 是没拿到 DHCP 地址时的自动地址

判断口诀:169.254.x.x 直接排除;VirtualBox、VMware、vEthernet、WSL 相关的排除;剩下真实物理网卡(以太网 / WLAN)的地址才是要填进 networkInterface 的值。

四、验证是否生效

服务启动后,先确认监听地址。如果绑定成功,看到的是具体 IP 而不是 0.0.0.0:

netstat -ano | findstr :1234

再直接请求接口,列出当前可用的模型:

Invoke-RestMethod -Uri 'http://10.172.100.219:1234/v1/models' -Method Get

或者用 curl:

curl http://10.172.100.219:1234/v1/models

返回模型列表就说明服务在跑。最后从另一台内网机器上访问同一个地址,能通就完成了。

另外提一下自带的命令行工具:C:\Users\<用户名>\.lmstudio\bin\lms.exe,可以用它管理服务和模型,例如:

lms server start
lms server status

五、常见问题

现象原因与处理
本机能访问,局域网其他机器访问不通多半是 Windows 防火墙拦了。为 lms.exe 或 1234 端口放行入站规则
换了网络环境后服务起不来、访问不到networkInterface 里写死了旧 IP。网卡地址变了(重装系统、换路由器、切有线/无线)就要同步改
服务完全起不来检查端口占用:netstat -ano | findstr :1234,冲突就换 port
浏览器页面直连报跨域错误确认 cors 为 true
想让本机和局域网都能访问把 networkInterface 改回 0.0.0.0
配置文件改完没反应没有重启服务;另外确认文件是严格 JSON——带了注释就整份失效
模型列表是空的确认模型确实在 models\<发布者>\<仓库名>\ 层级下,且是 .gguf 文件

六、小结

两个路径记住就够了:模型默认在 C:\Users\<用户名>\.lmstudio\models,按「发布者 / 模型仓库 / 量化文件」三层存放;本地服务的绑定地址在 .internal\http-server-config.json 的 networkInterface 字段,默认 0.0.0.0(所有网卡),改成具体内网 IP 即只监听该网卡。

改配置时最容易踩的两个坑:一是把 // 注释也一起抄进去,严格 JSON 直接失效;二是多网卡环境挑错了地址,绑到 Hyper-V 或 VMware 的虚拟网卡上,结果只有本机能连。按上一节的排除法挑真实物理网卡的 IP,再用 netstat 和 /v1/models 各验证一次,基本一次就能配好。

0
  1. 支付宝打赏

    qrcode alipay
  2. 微信打赏

    qrcode weixin

评论区