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.exe | LM 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 或蓝牙的机器会列出一大堆网卡地址,容易挑错。典型输出如下:
| IPAddress | InterfaceAlias | 能不能选 |
|---|---|---|
| 10.172.100.133 | 以太网 | 能选,这就是真实内网地址 |
| 192.168.80.1 | vEthernet (Default Switch) | 不能选,Hyper-V 虚拟网卡 |
| 192.168.204.1 | VMware Network Adapter VMnet8 | 不能选,VMware NAT 网卡 |
| 192.168.233.1 | VMware 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 各验证一次,基本一次就能配好。
评论区