在 Web 界面里直接修改配置：不用进容器/文件编辑器

为什么要 Web 改配置

改 config/config.json 通常有以下麻烦：

• Docker 容器里得 docker exec -it kikoeru bash 进去
• 找对文件路径、用 nano/vi 编辑
• Windows 用户倒还好，但不如 Web 界面直观

Web 配置页把这些全部简化：打开浏览器 → 设置 → 配置 → 直接改 → 保存 → 提示你重启。

能改哪些配置

Web 配置页通常按模块分组展示：

不同版本可配置项略有差异，但核心的端口、JWT、自动扫描肯定有。

操作流程

1. Web 界面左侧/顶部找到"设置 → 配置"
2. 修改你想改的字段（输入框、下拉菜单、开关）
3. 点"保存"
4. 页面提示"配置已保存，请重启服务器"
5. 重启服务（Docker 用 docker compose down && docker compose up -d，Windows 关掉 exe 重开）
6. 新配置生效

哪些配置改了不需要重启

• 临时设置（比如单次扫描参数）
• UI 偏好

大部分运行时配置（端口、JWT、爬虫参数）改完必须重启——后端启动时才会完整加载 config.json。

如果 Web 配置页打不开

说明你的版本可能没有这个功能，或者权限问题。直接手动改 config.json 是兜底方案：

• Docker：docker exec -it kikoeru nano /usr/src/kikoeru/config/config.json
• Windows：直接用记事本打开 config/config.json
• npm：找运行目录下的 config/config.json

配置文件的版本升级锁

config.js 里有"升级锁"（upgrade lock）机制——升级版本时如果 config.json 的 schema 变了，会自动迁移或提示手动处理。升级后如果遇到配置加载问题，先检查 config.json 里有没有新版本引入的必填字段。