配置文件说明
1 功能简介
SQLBot 的运行参数保存在 .env 与 conf/sqlbot.conf。调整跨域、默认密码、数据库、MCP 图片地址等，一般两处一并修改后重启。
2 配置文件位置
默认运行目录为 /opt/sqlbot（SQLBOT_BASE=/opt）。主要文件如下：
表 1 主要配置文件
| 文件 | 默认路径 | 说明 |
|---|---|---|
.env | /opt/sqlbot/.env | 安装生成的 SQLBOT_* 变量 |
sqlbot.conf | /opt/sqlbot/conf/sqlbot.conf | 应用运行配置 |
docker-compose.yml | /opt/sqlbot/docker-compose.yml | 容器编排 |
.env 与 sqlbot.conf
安装时由 .env 渲染生成 sqlbot.conf（如 SQLBOT_SERVER_IMAGE_HOST → SERVER_IMAGE_HOST）。安装后改参请两处保持一致。
3 修改与生效
修改前先备份：
cp /opt/sqlbot/.env /opt/sqlbot/.env.bak.$(date +%F)
cp /opt/sqlbot/conf/sqlbot.conf /opt/sqlbot/conf/sqlbot.conf.bak.$(date +%F)
vi /opt/sqlbot/.env
vi /opt/sqlbot/conf/sqlbot.conf
保存后重启：
sctl restart
修改后需重启
须执行 sctl restart 才会生效；sctl reload 不能替代重启。见 命令行工具。
4 参数说明
.env / sqlbot.conf 中常见参数如下（安装后请两处保持一致）：
表 2 参数说明
| 参数名称 | 默认值 | 可选项 | 说明 |
|---|---|---|---|
| SQLBOT_SERVER_IMAGE_HOST （SERVER_IMAGE_HOST） | — | — | MCP 图片地址，IP 为 SQLBot 服务器地址，端口为 MCP 端口（默认 8001）；见 MCP Server |
| SQLBOT_CORS_ORIGINS （BACKEND_CORS_ORIGINS） | http://localhost,http://localhost:5173,... | — | 跨域白名单，多个来源以逗号分隔 |
| SQLBOT_DEFAULT_PWD （DEFAULT_PWD） | SQLBot@123456 | — | 普通用户默认密码 |
| SQLBOT_SECRET_KEY （SECRET_KEY） | — | — | JWT 签名密钥；备份与迁移须保留原值，见 备份 |
| SQLBOT_LOG_LEVEL | INFO | DEBUG INFO WARNING ERROR | 日志级别 |
| POSTGRES_HOST / PORT / DB / USER / PASSWORD | — | — | 数据库连接信息（以 sqlbot.conf 为准） |