40+ 种数据库管理一个工具搞定:Chat2DB 跨平台部署与安装快速上手

40+ 种数据库管理一个工具搞定:Chat2DB 跨平台部署与安装快速上手

【免费下载链接】Chat2DBChat2DB is a free, cross-platform, local-first database client and SQL workspace for developers, DBAs, analysts, and data teams. Connect to 40+ databases, manage data, edit and run SQL, and use your own AI model to generate, explain, and optimize queries. Available on desktop, web, Docker, and CLI, with MCP support.项目地址: https://gitcode.com/GitHub_Trending/ch/Chat2DB

Chat2DB 是一款免费、本地优先的 AI 驱动 SQL 客户端,可连接 MySQL、PostgreSQL、Oracle、Redis 等 40+ 种数据库,支持 SQL 编辑执行、元数据管理和用你自己的 AI 模型生成、解释查询。不管这次 Chat2DB 部署的目标是个人电脑还是团队服务器,下文的命令都能直接复制执行,目标是让你十几分钟内完成 Chat2DB 安装并连上第一张表。

先做选型:桌面客户端、Docker、源码编译,哪种适合你

别急着敲命令,先用一张表对号入座,三种方式的差异一目了然:

有一个容易被忽略的点:Chat2DB Community 用 AES-256-GCM 加密存储数据源密码和 AI 模型的 API Key。桌面模式会自动帮你生成密钥;而 Docker 或 Web 方式启动前,需要你先手动初始化一次密钥文件,后面每节里都会给到具体命令。

桌面客户端:Windows、macOS、Linux 一张表讲清

各平台安装包对应关系

Chat2DB 桌面客户端同时覆盖三大平台,官方发布页按平台提供了不同格式的安装包(安装脚本见 script/package/):

三个平台的体验基本一致,没有"某个平台少功能"的情况。

装好后第一次连数据库

首次启动只做三件事:

1. 左侧新建连接,选数据库类型,填主机、端口、账号密码;
2. 双击表名预览结构,或点表右侧的"查看数据"直接翻数据;
3. 如果需要 AI 能力,进入设置填入你自有模型的 API 地址和 Key——用的就是你自己的模型,不是官方服务。

提示:自定义 JDBC 驱动属于可执行的 Java 代码,只建议安装来自可信来源的驱动。

Docker 部署:一条命令跑起 Chat2DB

先初始化一次加密密钥

这条脚本负责生成密钥文件,只需执行一次,重复执行会复用已有合法密钥(依赖openssl):

./script/security/init-community-encryption-key.sh

执行后密钥写入~/.config/chat2db-community/encryption.key。请把这个文件单独备份:升级、重建容器时只要带上它,已保存的数据库密码和 AI Key 才不会解密失败。Web 模式下缺少合法密钥会直接启动失败,不会静默跳过。

一条 docker run 启动 Chat2DB

下面这段命令做两件事:挂载密钥和应用数据目录,然后把容器端口绑到本机127.0.0.1:10825——Chat2DB 是单用户、本机优先的应用,官方要求 HTTP 只绑定回环地址,不要把 10825 端口直接暴露到局域网:

docker run --detach \ --name chat2db-community \ --restart unless-stopped \ --publish 127.0.0.1:10825:10825 \ --volume "$HOME/.chat2db-community-docker:/root/.chat2db-community" \ --env CHAT2DB_COMMUNITY_ENCRYPTION_KEY_FILE=/run/secrets/chat2db-community-encryption.key \ --volume "$HOME/.config/chat2db-community/encryption.key:/run/secrets/chat2db-community-encryption.key:ro" \ chat2db/chat2db:latest

然后浏览器打开http://localhost:10825即可。如果你更喜欢 Compose 写法,仓库自带了一份 docker/docker-compose.yml,一条命令启动:

docker compose --file docker/docker-compose.yml up --detach

两种方式的数据存放位置不同:docker run示例存在$HOME/.chat2db-community-docker,Compose 用名为chat2db-community-data的命名卷,它们之间不会自动共享数据,选一种并坚持下去。

源码编译:Chat2DB 前后端各一条命令跑通

前端开发模式启动命令

先确认环境:JDK 用 Temurin 17,Node.js 18.17.0+,Maven 3.8+。克隆代码并启动前端(注意仓库锁文件是 Yarn,必须用--frozen-lockfile安装):

git clone https://gitcode.com/GitHub_Trending/ch/Chat2DB cd Chat2DB/chat2db-community-client yarn install --frozen-lockfile yarn run start:community:hot

启动成功后前端开发服务器跑在http://127.0.0.1:8889。

后端打包与运行

后端只编译启动模块及其依赖,跳过测试,产出一个可执行 jar:

cd Chat2DB mvn -B clean package -Dmaven.test.skip=true -Dchat2db.finalName=chat2db-community \ -f chat2db-community-server/pom.xml \ -pl chat2db-community-start -am

打包完成后初始化密钥并启动(与 Docker 相同,先确保密钥文件存在):

./script/security/init-community-encryption-key.sh java -Dloader.path=chat2db-community-server/chat2db-community-start/target/lib \ -Dchat2db.gui=false \ -Dchat2db.runtime.mode=community \ -Dchat2db.mode=WEB \ -Dchat2db.network.status=OFFLINE \ -Dchat2db.community.encryption-key-file="$HOME/.config/chat2db-community/encryption.key" \ -Dserver.address=127.0.0.1 \ -Dserver.port=10825 \ -Dspring.profiles.active=dev \ -jar chat2db-community-server/chat2db-community-start/target/chat2db-community.jar

进阶玩法一句话带过:编译产物还可以打成自己的 Docker 镜像,./docker/docker-build.sh 5.3.0 chat2db/chat2db:5.3.0即可。

启动失败或打不开页面?按顺序查这四处

按报错信息对号入座

这是 Chat2DB 常见问题里出镜率最高的一组:

升级容器时别丢的两样东西

• 密钥文件~/.config/chat2db-community/encryption.key:丢了它,所有已保存的密码和 AI Key 都无法解密;
• 数据目录:5.3.0 起 Community 版使用独立的/root/.chat2db-community目录,不会自动迁移旧镜像里的/root/.chat2db,升级前先确认旧数据要带过去。

按场景选一种就够了

• 个人日常用:装对应平台的桌面客户端,五分钟开干,密钥都帮你省了;
• 服务器或团队共用:Docker 部署 + Compose,记得备份密钥文件和数据卷;
• 要改代码或出定制镜像:走源码编译,前后端各一条命令,改完直接本地跑。

更多细节可参考 README_CN.md 与 SECURITY.md。

【免费下载链接】Chat2DBChat2DB is a free, cross-platform, local-first database client and SQL workspace for developers, DBAs, analysts, and data teams. Connect to 40+ databases, manage data, edit and run SQL, and use your own AI model to generate, explain, and optimize queries. Available on desktop, web, Docker, and CLI, with MCP support.项目地址: https://gitcode.com/GitHub_Trending/ch/Chat2DB