高级设置
概述
高级设置页面集中管理网络安全、数据存储、系统维护等底层配置。大多数用户在初始向导中无需修改这些项，但在局域网共享、公网部署、数据迁移等场景下会用到。
网络与安全
监听地址
v1.28 起，监听地址按运行环境自动选择：
| 环境 | 默认 API_HOST | 说明 |
|---|---|---|
| Windows / macOS / 带桌面的 Linux | 127.0.0.1 | 仅本机访问 |
| 无桌面的 Linux（headless / SSH / Docker） | 0.0.0.0 | 局域网可访问；首次远程访问会强制设置密码 |
桌面端用户可在 网络与安全 → Web 访问 / 网络 打开「允许外部访问（局域网/公网）」开关来切换到 0.0.0.0；该开关本质上是写 API_HOST=0.0.0.0 到 .env。
环境变量优先级：
- 显式
API_HOST（.env / 系统环境变量） — 最高优先级 settings.api_lan_mode=True或 headless 自动检测 →0.0.0.0- 否则 →
127.0.0.1
反向代理
| 变量 | 默认值 | 说明 |
|---|---|---|
TRUST_PROXY | false | 在 Nginx/Caddy 等代理后面时设为 true，以正确识别客户端真实 IP |
CORS_ORIGINS | — | 允许跨域请求的来源，多个用逗号分隔。如 https://your-domain.com |
Web 访问密码
v1.28 起 OpenAkita 不再自动生成随机密码。首次从非本机地址访问 Web 界面时，会强制进入 Setup 流程让用户亲自设置；本机直连（Tauri 桌面 / curl 127.0.0.1）始终免密码。
密码以 scrypt 哈希存储在 data/web_access.json，写入走原子替换 + fsync + 目录 fsync（POSIX）的硬持久化路径，断电不丢。
忘记密码：
openakita reset-password执行后重启 backend，下次访问会重新进入 Setup 流程。
修改已有密码：在 高级配置 找到「Web 访问密码」，输入旧密码 + 新密码并保存（本机访问可跳过旧密码校验）。
环境变量管理
在高级配置页面中可查看和修改运行时环境变量，无需手动编辑文件。
- 新增 — 点击「添加变量」，输入 Key 和 Value
- 编辑 — 直接修改已有变量的值
- 删除 — 点击变量右侧的删除按钮
提示
环境变量修改后需重启 Agent 才能生效。API Key 等敏感变量建议通过此界面管理，而非写入代码。
数据备份与还原
导出备份
点击 「导出工作区」 将以下内容打包为 .zip 文件：
- 配置文件（LLM 端点、IM 通道、技能配置等）
- 记忆数据（三层记忆）
- 身份文件（SOUL.md、AGENT.md、USER.md、MEMORY.md）
- 会话历史
- Agent 定义
注意
备份中包含 API Key 等敏感信息。请妥善保管备份文件，不要上传到公开位置。
从备份还原
- 点击 「导入工作区」 → 选择之前导出的
.zip文件 - 选择还原范围（全部 / 仅配置 / 仅数据）
- 确认后自动还原并重启
工作区迁移
将 OpenAkita 的数据目录从当前位置迁移到其他路径：
- 点击 「工作区迁移」
- 选择目标目录
- 系统自动复制数据并更新配置
适用于磁盘空间不足或需要将数据迁移到其他分区的场景。
存储清理
清理系统运行中产生的缓存和临时文件：
- 缓存文件 — LLM 响应缓存、工具执行缓存
- 临时文件 — 上传的文件副本、中间处理结果
- 旧日志 — 超过保留天数的日志文件
点击 「清理」 后显示可回收空间大小，确认后执行。
诊断导出
遇到问题时，导出诊断信息用于排查或提交 Issue：
- 系统环境信息（OS、Python 版本、依赖版本）
- 运行时配置（脱敏后，API Key 不会包含在内）
- 最近的错误日志
- LLM 连接状态
导出为 .json 文件，可直接附到 GitHub Issue 中。
系统重置
危险操作
系统重置会清除所有配置和数据，恢复到初始状态。此操作不可撤销。
重置前请确保已导出重要数据。重置后将回到首次启动的配置向导。