离线安装

1 环境要求

部署服务器要求：

操作系统: Ubuntu 22.04 / CentOS 7.6 64 位系统
CPU/内存: 4 核 8 G
磁盘空间: 100G

提示：Docker 版本太老可能会导致安装失败，建议使用安装包内的 Docker，或者使用 v23.0.5 版本及以上的 Docker。

2 下载离线安装包

打开飞致云开源社区 SQLBot 社区版下载 页面下载最新版本安装包，并上传至部署服务器（以 v1.0.0 为例说明安装部署过程）。

社区版不提供 arm 架构安装包，需要在 arm 架构下安装，以可通过在线安装方式安装。

3 端口要求

离线部署 SQLBot 需要开通的访问端口说明如下：

表 1 离线部署端口要求

端口	作用	说明
22	SSH	安装、升级及管理使用
8000	Web 服务端口	默认 Web 服务访问端口，可根据实际情况进行更改
8001	MCP 服务端口	默认 MCP 服务访问端口，可根据实际情况进行更改

4 安装部署

4.1 解压安装包

以 root 用户通过 ssh 协议登录到部署服务器, 对安装包进行解压：

tar -zxvf sqlbot-v1.0.0-x86_64-offline-installer.tar.gz

4.2 设置安装参数（可选）

SQLBot 安装目录、服务运行端口、数据库配置等信息可在安装包解压后中的 install.conf 文件进行配置。

# 基础配置
## 安装目录
SQLBOT_BASE=/opt
## SQLBot 端口
SQLBOT_WEB_PORT=8000
SQLBOT_MCP_PORT=8001

# 数据库配置
## 是否使用外部数据库（仅限支持向量扩展的 PG 数据库）
SQLBOT_EXTERNAL_DB=false
## 数据库地址
SQLBOT_DB_HOST=localhost
## 数据库端口 (仅使用外部数据库时才生效)
SQLBOT_DB_PORT=5432
## SQLBot 数据库库名
SQLBOT_DB_DB=sqlbot
## 数据库用户名
SQLBOT_DB_USER=root
## 数据库密码，密码如包含特殊字符，请用双引号引起来，例如 SQLBOT_DB_PASSWORD="Test@4&^%*^"
SQLBOT_DB_PASSWORD=Password123@pg

# 其他配置
## 普通用户默认密码
SQLBOT_DEFAULT_PWD=SQLBot@123456
## SQLBot Secret Key，随机 32 位字符，不包含特殊字符，用于 jwt 签名
SQLBOT_SECRET_KEY=y5txe1mRmS_JpOrUzFzHEu-kIQn3lf7ll0AOv9DQh0s
## Cross-Origin Resource Sharing (CORS) 设置
SQLBOT_CORS_ORIGINS=http://localhost,http://localhost:5173,https://localhost,https://localhost:5173
## 日志级别 DEBUG, INFO, WARNING, ERROR
SQLBOT_LOG_LEVEL="INFO"
## 缓存类型
SQLBOT_CACHE_TYPE="memory"
## MCP 图片存储路径
SQLBOT_SERVER_IMAGE_HOST=http://YOUR_SERVER_IP:MCP_PORT/images/

4.3 执行安装脚本

# 进入安装包解压缩后目录  
cd sqlbot-v1.0.0-x86_64-offline-installer

# 执行安装命令
bash install.sh

5 登录访问

安装成功后即可通过浏览器访问地址 http://目标服务器 IP 地址:8000，并使用默认的管理员用户和密码登录 SQLBot。

用户名：admin

默认密码：SQLBot@123456

访问SQLBot

图 1 访问 SQLBot

离线安装#

#1 环境要求

#2 下载离线安装包

#3 端口要求

#4 安装部署

#4.1 解压安装包

#4.2 设置安装参数（可选）

#4.3 执行安装脚本

#5 登录访问