配置文件说明
1 功能简介
MaxKB 的运行参数主要保存在运行目录的 .env。调整服务端口、数据库、Redis、工作流循环上限等，一般改这个文件后重新加载即可。
2 配置文件位置
默认运行目录为 /opt/maxkb（离线安装，由 MAXKB_BASE=/opt 决定；在线 docker run 常见挂载为 ~/.maxkb）。主要文件如下：
表 1 主要配置文件
| 文件 | 默认路径 | 说明 |
|---|---|---|
.env | /opt/maxkb/.env | 主运行配置 |
redis.conf | /opt/maxkb/conf/redis.conf | 内置 Redis |
postgresql.conf | /opt/maxkb/data/postgresql/pgdata/postgresql.conf | 内置 PostgreSQL |
mkctl 适用范围
mkctl 用于离线安装包环境；在线安装、1Panel 安装方式默认不内置该工具。
3 修改与生效
修改前先备份：
cp /opt/maxkb/.env /opt/maxkb/.env.bak.$(date +%F)
vi /opt/maxkb/.env
保存后重新加载：
mkctl reload
修改后需重新加载
配置不会热更新，须执行 mkctl reload（或等价的容器重建 / 重启）。见 命令行工具。
4 参数说明
.env 及内置库配置中常见参数如下：
表 2 参数说明
| 参数名称 | 默认值 | 可选项 | 说明 |
|---|---|---|---|
| MAXKB_BASE | /opt | — | 安装目录前缀，运行目录为 ${MAXKB_BASE}/maxkb |
| MAXKB_PORT | 8080 | — | 服务端口 |
| max_connections （postgresql.conf） | — | — | 内置 PostgreSQL 最大连接数；出现 too many clients already 时可调大，见 安装部署 FAQ |
其他可调项