ChuSQL/docs/config.md

配置选项

ChuSQL 使用统一配置文件 chusql.toml。默认位置：

平台	路径
Windows	%APPDATA%\ChuSQL\chusql.toml
Linux / macOS	$XDG_CONFIG_HOME/ChuSQL/chusql.toml；未设置时为 ~/.config/ChuSQL/chusql.toml

chusql-server、chusql-web 和 csql 均可通过 --config <path> 临时指定其他配置文件。配置优先级为：命令行参数 > 配置文件 > 内置默认值。

存储配置

配置项	默认值	说明
[page] size	4096	数据页大小（字节）
[btree] order	4	B+ 树阶数
[buffer] pool_size	1024	缓冲池页数
[storage] data_dir	平台默认数据目录	数据文件保存位置
[log] level	info	日志级别

数据目录仅由 chusql-server 访问。生产环境建议使用绝对路径。

Web 配置

配置项	默认值	说明
host	127.0.0.1	Web 服务监听地址
port	7778	Web 服务端口
static_dir	static	静态资源目录
user	root	管理员账号名
cookie_secure	false	HTTPS 部署时应启用
body_limit	65536	请求体大小上限（字节）
session_idle	28800	会话空闲超时（秒）
session_max	86400	会话最大存活时间（秒）
login_max_attempts	5	登录失败限制阈值
login_window	300	登录限制统计窗口（秒）
rows_per_page	25	默认分页大小
max_page_size	500	最大分页大小
max_rows	1000	单次查询最大返回行数
max_sql_length	20000	SQL 最大字符数
seed	false	空库时是否写入演示数据
password_min_length	12	普通账号最短口令长度
password_classes	2	口令至少包含的字符类别数

Server 配置

配置项	默认值	说明
host	127.0.0.1	数据库服务监听地址
port	7777	数据库服务端口
max_message	1048576	单条请求最大大小（字节）
max_rows	1000	单次查询最大返回行数

修改 Server 相关配置后需要重启 chusql-server。

账号与安全

账号口令不保存在配置文件中，而保存在系统数据库中。管理员口令在安装或系统引导时设置，之后可通过 SQL 或 Web 管理界面修改。

系统目录未完成初始化时，chusql-server 将拒绝启动并提示运行 csql-bootstrap。

对外部署时建议：

• 数据库服务仅监听受控网络接口；
• Web 服务通过 HTTPS 或反向代理提供；
• HTTPS 环境启用 cookie_secure。

修改配置

配置可通过以下方式修改：

1. 直接编辑 chusql.toml；
2. 通过 Web 设置页面修改。

大多数配置在相关服务下次启动时生效。