写 SQL 最烦的往往不是敲那几行 SELECT，而是要在好几种数据库之间来回切：MySQL 一套写法，PostgreSQL 又有差别，临时查一下 ClickHouse 还得翻文档。想让 AI 帮忙写复杂查询，不少工具又要把连接信息和数据传到云端，或者只能用它们自家的模型按量收费。

Chat2DB 社区版是一个开源的 AI 数据库客户端，Windows、macOS、Linux 都能装。整个应用跑在你自己的机器上，AI 助手连的是你自己配置的模型，不绑定任何厂商。

这篇按实际使用顺序来讲：Chat2DB 能做什么、桌面版和 Docker 两种装法、加密密钥怎么保管，以及和 Navicat、DBeaver 怎么搭配。适合经常和多种数据库打交道的开发者、DBA 和数据分析人员。

Chat2DB 能做什么

先说定位：它是一个功能完整的 SQL 工作台，AI 是长在里面的助手，而不是一个只会聊天的玩具。

一个客户端连 40 多种数据库：MySQL、PostgreSQL、Oracle、SQL Server、ClickHouse、MongoDB、Redis、SQLite、MariaDB、TiDB、Hive、DB2、Snowflake、BigQuery、Elasticsearch、Trino 等都在支持列表里，还能通过插件扩展；新的 JDBC 数据库只改配置就能加，不用改代码。
SQL 工作台功能齐全：编辑、自动补全、格式化、执行、保存常用 SQL、查看执行历史都有。
AI 助手连你自己的模型：用自然语言描述需求生成 SQL，解释看不懂的 SQL，优化跑得慢的查询。模型和 API Key 都是你自己配的。
数据库管理：浏览元数据，建表改表，直接在界面上编辑数据，还有 ER 图把库结构画出来。
导入导出和图表：内置数据导入导出、仪表盘和图表，另有一个支持 MCP 的开源 CLI，可以接进自动化流程。

另外，官方最近发布了 5.4.0-beta.1 预览版，加入了可选的本地 Agent 运行时，支持 Skill、外部 MCP 服务以及文件和终端工具。它既不是稳定版也不是常规 Beta，想尝鲜的话要在 Settings → About Us 里打开接收 Beta 版本。

为什么强调“本地运行”

Chat2DB 社区版是单用户、本地优先的应用，没有账号体系，也没有用户之间的权限隔离，本来就是给你自己用的。

数据源密码和 AI 模型的 API Key 用 AES-256-GCM 加密后存在本地，每个安装实例一把独立的密钥。也就是说，数据库凭证和模型密钥不会经过第三方服务器。对需要连公司内网库或生产库的人来说，这一点很实在。

Chat2DB 安装：桌面版

桌面版最省事。到 GitHub Releases 页面下载对应平台的安装包，装好后直接新建连接即可，不需要额外配置。桌面模式在缺少加密密钥时会自动生成一把。

Chat2DB 安装：Docker 部署

想跑在服务器或者一台常开的机器上，可以用 Docker。和桌面版不同，Web 和无界面模式在没有有效密钥时会启动失败，所以要先生成加密密钥。

第一步，克隆仓库并生成密钥（脚本依赖 openssl）：

git clone https://github.com/OtterMind/Chat2DB.git
cd Chat2DB
./script/security/init-community-encryption-key.sh

密钥默认写到 ~/.config/chat2db-community/encryption.key。

第二步，启动容器。下面的 /home/you 换成你自己的用户主目录：

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

启动后在浏览器打开 http://localhost:10825 就能用了。

升级和密钥保管

升级时拉取新镜像，删掉旧容器，再用同样的命令启动一次。
加密密钥一定要单独备份，升级和重建容器时都要保留。密钥丢了或换了，之前保存的数据源密码和模型 API Key 都无法解密。
上面的 docker run 把数据放在主目录下的 .chat2db-community-docker，官方的 Compose 配置用的是名为 chat2db-community-data 的数据卷，两者的数据不互通，换部署方式时要注意。
默认只绑定 127.0.0.1。社区版没有用户隔离，不要把它暴露到公网或不可信网络。

配置 AI 助手

Chat2DB 的 AI 助手连接你自己的模型服务，填入模型地址和 API Key 即可。如果你已经在用 AI 编程工具，也可以把同样的思路用在 SQL 上：让 AI 先生成查询，你来审核和执行。想了解不同 AI 编程工具的取舍，可以看 Claude Code 与 Codex 怎么选，定价、编码能力与适用场景对比。

和 Navicat、DBeaver 怎么搭配

对比项	Navicat / DBeaver	Chat2DB 社区版
成熟度	打磨多年，细节完善	功能齐全，迭代较快
AI 能力	视版本而定	内置 AI 助手，连你自己的模型
数据位置	本地客户端	全部在本地，凭证加密存储
资源占用	原生或较轻	Java 应用，启动和内存占用偏重

已经在用 DBeaver 的话完全可以并存：平时用熟悉的客户端，需要 AI 帮忙写 SQL、又不想让数据离开本地时再打开 Chat2DB。

使用时的注意事项

AI 生成的 SQL 要复核：尤其是要在生产库上执行的语句，先在测试环境跑一遍，确认影响范围。
把外部内容当不可信数据：导入的配置、SQL 文件、数据库里的内容和 AI 的回复，都应该先看清楚再执行。
不要暴露到公网：社区版没有用户隔离，只在本机或可信内网使用。

总结

Chat2DB 把一个成熟的 SQL 工作台和一个连你自己模型的 AI 助手装进了一个全本地运行的客户端，解决了两个实际问题：多种数据库来回切换的麻烦，以及想用 AI 就得把数据交出去的顾虑。免费、开源、跨平台，桌面版下载即用，服务器上用 Docker 部署也不复杂。

如果你平时也在用 Claude Code 或 Codex 处理数据库相关的开发任务，可以在 AIGoCode 上用一个 API Key 接入这些工具，和 Chat2DB 配合着用。

参考链接

Chat2DB GitHub：https://github.com/OtterMind/Chat2DB
Chat2DB 官网：https://chat2db.ai
Chat2DB CLI（支持 MCP）：https://github.com/OtterMind/Chat2DB-CLI