高级设置
概述
高级设置页面集中管理网络安全、数据存储、系统维护等底层配置。大多数用户在初始向导中无需修改这些项，但在局域网共享、公网部署、数据迁移等场景下会用到。
网络与安全
监听地址
在 网络与安全 → Web 访问 / 网络 中，打开「允许外部访问（局域网/公网）」开关即可让局域网内其他设备访问。
安全提醒
开启外部访问后，请务必设置 Web 访问密码，否则同一网络内的任何人都能访问你的 Agent。
反向代理
| 变量 | 默认值 | 说明 |
|---|---|---|
TRUST_PROXY | false | 在 Nginx/Caddy 等代理后面时设为 true，以正确识别客户端真实 IP |
CORS_ORIGINS | — | 允许跨域请求的来源，多个用逗号分隔。如 https://your-domain.com |
Web 访问密码
为 Web 界面设置访问密码，适用于局域网或公网暴露场景：
- 在 高级配置 中找到「Web 访问密码」
- 输入密码并保存
- 之后访问 Web 界面时需输入密码
密码以 bcrypt 哈希存储在本地，不会明文保存。
环境变量管理
在高级配置页面中可查看和修改运行时环境变量，无需手动编辑文件。
- 新增 — 点击「添加变量」，输入 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 中。
系统重置
危险操作
系统重置会清除所有配置和数据，恢复到初始状态。此操作不可撤销。
重置前请确保已导出重要数据。重置后将回到首次启动的配置向导。