# Web 服务器

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：Web 与局域网。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/web_server/

## 它是什么

Web 服务器可以让你在同一局域网内,用电脑或其它设备的浏览器打开本机会话与模型配置,无需额外安装客户端。

## 怎么开启

打开 **设置 → 连接与高级 → Web 服务器**,打开开关即可启动服务;再次关闭开关会停止服务。服务停止后浏览器将无法访问。

## 访问地址

启动后会展示两类地址:

- **本机地址**:在本设备浏览器打开使用。
- **局域网地址**:与当前设备连接同一 Wi-Fi 的其它设备(电脑、平板等)可直接访问。

## 端口

端口可自定义,修改后访问地址也会随之变化。请避免与系统中已占用的端口冲突。

## 仅本机访问

开启 **仅本机访问** 后，只有本机能访问服务，局域网地址不再展示。该模式支持免密码启动和访问；对外开放时仍需按访问模式配置密码与鉴权，不能把本机免密规则用于局域网或公网。

## 安全提醒

关闭“仅本机访问”、又未启用「访问需要密码」时,服务会给出不安全提示。若需要让局域网或公网稳定使用,建议在页面的「安全保护」分区设置访问密码并开启「访问需要密码」。

## 给桌面 Agent 使用

Claude Code、Codex 等电脑上的 agent 也可以通过 Web 服务器直接读写记忆和系统提示词，用法见「桌面 Agent 迁移」。