如何使用 Unsloth LAN Access 从网络中的任何设备提供本地 AI 模型服务

你可以在家中或办公室的任何支持 LAN 访问的设备上运行本地 AI 模型，使用 Unsloth。启用后，本地模型可从同一 Wi‑Fi 或有线网络上的手机、笔记本电脑或另一台电脑访问，而无需将任何内容发送到云端。不需要公网 URL 或互联网连接——你的 AI 会留在你的机器和你的网络中。

LAN 访问是从另一台设备使用本地模型的最快方式。流量不会离开你的网络，因此延迟很低。

开启 LAN 访问后，Unsloth 会在你机器的网络地址上响应，例如 http://192.168.1.42:8888。在你的手机、笔记本电脑或同一网络中的任何设备上打开它。

它是免费的，而且可离线运行。没有任何内容会离开你的网络，你也无需接触路由器或防火墙。若要从网络外部访问，请使用 远程访问 。

有两种开启方式：

• 启动 Unsloth 时： 添加 -H 0.0.0.0 到你的 unsloth studio 命令

• 在 Unsloth 运行时： 前往 设置 → API → 远程与 LAN，找到 LAN 访问 卡片，然后按 启动

⚡ 快速开始

首先，我们需要下载 Unsloth Desktop 应用。

1. 安装适用于 macOS、Windows 或 Linux

2. 启动应用

3. 然后前往 设置 → API → 远程与 LAN.

当 Unsloth 已在运行，并且你想在同一建筑内的另一台设备上使用它时，请使用此方法。按 启动 位于 LAN 访问 卡片上的按钮。 在线 表示该地址已经有响应，而不只是被请求过。

自动启动

该 自动启动 LAN 访问卡片下方的开关会让 Unsloth 每次启动时都加入网络。现在停止 LAN 访问不会关闭它；该开关是一个独立于运行状态的偏好设置。

CLI：LAN 方式

手动安装 Unsloth 后，请在终端中运行：

unsloth studio -H 0.0.0.0 -p 8888

Unsloth 会绑定到每个接口，因此原始端口可从你的网络访问。不会发布公开的 Cloudflare URL， -H 0.0.0.0 单独使用即可让你停留在 LAN 中。打印出的第一行是其他设备使用的地址：

正在 http://[<你的机器的网络地址>]:8888 上启动 Unsloth Studio

该地址可能是 IPv6，像上面一样用方括号括起来。请连同方括号一起复制整个 URL。

CLI：LAN 加公开链接

unsloth studio -H 0.0.0.0 --cloudflare -p 8888

原始端口仍可在你的网络中访问 并且 会发布一个公开的 Cloudflare URL。横幅正是为此提醒你，因为这是隐私性最低的模式。 远程访问页面 中有说明。

UI：将一个已在网络上运行的服务器

1. 打开 设置 → API → 远程与 LAN.

2. 找到 LAN 访问 卡片上的按钮。

3. 点击 启动.

4. 当状态显示 在线时，请在同一网络中的任意设备上打开所示地址。

每种启动方式实际暴露的内容

启动	可从以下位置访问
unsloth studio	仅此机器
unsloth studio -H 0.0.0.0	你的网络
unsloth studio -H 0.0.0.0 --cloudflare	你的网络，以及一个公开的 Cloudflare URL
unsloth studio --secure	仅公开的 Cloudflare URL，LAN 保持关闭

--secure 与 LAN 访问是相反的： --secure 会强制进行 loopback 绑定，因此你网络中的任何内容都无法访问原始端口。

🔒 安全性

将 Unsloth 放到网络上意味着该网络中的每台设备都能看到它。

• 连接未加密。 LAN 流量是明文 HTTP。同一网络段上的任何人都可以读取它。在你无法控制的网络上，请使用 远程访问 代替；Cloudflare 链接是 HTTPS。

• 服务器端工具将以你的用户身份运行。 网页搜索、Python 和终端执行默认已开启，因此任何拿到你的 API 密钥并访问服务器的人都可以在那台机器上运行代码。传入 --disable-tools 在暴露 Unsloth 时使用，并妥善保管 API 密钥。每一种可通过网络访问的启动方式都会在横幅中提示这一点。

• Unsloth 会检查端口是否越过路由器泄露到外网。 在通配绑定下，可达性探测会测试原始端口是否意外可从互联网访问，如果是，启动横幅会提示这一点。该探测会联系 ifconfig.me 并且 check-host.net；设置 UNSLOTH_STUDIO_DISABLE_PUBLIC_CHECK 即可跳过这两项。

❔ 故障排查

• 错误：Unsloth Studio 已在端口 8888 上运行（PID ...）. 另一个实例占用了该端口。先运行 unsloth studio stop ，或者将此实例启动到不同的 --port.

• 该地址无法从另一台设备上响应。 两台设备必须在同一网络中。访客 Wi‑Fi、客户端隔离（“AP 隔离”）和 VPN 通常是罪魁祸首。还要检查该机器自身的防火墙是否允许该端口的入站连接。

• 地址已更改。 LAN IP 由路由器分配，可能会变化。请在路由器设置中为这台机器分配静态 IP 或 DHCP 保留，以获得稳定地址。

• UI 中的“启动”按钮是灰色的。 查看卡片下方的消息，其中会说明阻止原因。

🌱 环境变量

变量	用途
UNSLOTH_STUDIO_DISABLE_PUBLIC_CHECK	1 在通配绑定时跳过第三方原始端口可达性探测。
UNSLOTH_STUDIO_TRUST_FORWARDED	1 遵循 X-Forwarded-For 在你自己的反向代理后面。

🌐 HTTP API

这四项都需要一个 UI 会话， API 密钥会被拒绝。被拒绝的操作会返回 409 ，并将阻止原因作为 detail。

方法	路径	用途
GET	/api/settings/lan-access	当前状态、地址， can_start / can_stop, block_reason.
POST	/api/settings/lan-access/start	安排由设置管理的启动。幂等。
POST	/api/settings/lan-access/stop	安排由设置管理的停止。不会更改自动启动偏好。
PUT	/api/settings/lan-access/auto-start	{"enabled": true|false}.