安装与卸载

发行包已经包含编译后的程序，普通用户安装时无需安装 GHC 或 Rust 工具链。

在线安装

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/TheBadRoger/ChuSQL/main/scripts/install.sh | sh -s -- --component web

Windows PowerShell：

irm https://raw.githubusercontent.com/TheBadRoger/ChuSQL/main/scripts/install.ps1 -OutFile "$env:TEMP\install.ps1"
& "$env:TEMP\install.ps1" -Component web

安装方式

ChuSQL 支持三种安装方式：

方式	适用场景
在线安装	有网络，希望安装发行版本
包内安装	已下载发行包，或处于离线环境
源码安装	当前平台没有发行包，或需要自行修改源码

安装时可以选择 Web 管理端、命令行客户端，或同时安装两者。数据库服务及核心组件会按需安装。

安装过程中必须为管理员账号设置口令。口令不会以明文写入配置文件。

完成系统目录初始化后，安装程序默认会启动 chusql-server；如不希望自动启动，可使用 --no-start（Windows 为 -NoStart）。

包内安装

解压发行包后，在包根目录执行：

./install.sh --component web

Windows：

.\install.ps1 -Component web

常用安装选项

Linux / macOS	Windows	说明
`--component web\|cli\|both`	`-Component`	选择安装组件
`--install-dir DIR`	`-InstallDir`	指定安装目录
`--data-dir DIR`	`-DataDir`	指定数据目录
`--user NAME`	`-RootUser`	指定管理员账号名
`--no-start`	`-NoStart`	安装后不自动启动服务
`--version TAG`	`-Version`	指定发行版本
`--list-versions`	`-ListVersions`	列出可安装版本
`--from-source`	—	从源码构建并安装

自动化安装时建议通过环境变量提供管理员口令，避免口令出现在 shell 历史中。

从源码安装

源码安装需要 git、cargo、stack 和 ghc；部分 Linux 环境还需要 zlib 开发包。

./install.sh --component web --from-source

源码构建完成后的配置、初始化和启动流程与发行包安装一致。

安装完成后

默认安装包含以下主要内容：

chusql-server：数据库服务；
csql：命令行客户端；
chusql-web：Web 管理端；
csql-bootstrap：系统目录初始化工具；
settings.toml：全局配置文件；
数据目录与日志目录。

常用命令：

chusql-server
csql
csql-web

管理员使用安装时设置的口令登录。

卸载