📌 项目地址：OtterMind/Chat2DB | ⭐ 26,239 颗星 | 🔧 Java | 📜 未标注
核心价值：把AI模型接入数据库客户端
Chat2DB 是一个免费的跨平台数据库客户端，集成了完整的 SQL 编辑器、数据库管理、数据导入导出和仪表盘功能。与 DataGrip、DBeaver 等传统工具最大的不同是，它内置了一个 AI 助手——你可以用自己的 AI 模型（如 OpenAI、本地模型）来生成 SQL、解释查询或优化性能。所有对话和查询都在本地或你自己的网络环境中完成，没有外部数据泄露风险。
它支持 30+ 种数据库，包括 MySQL、PostgreSQL、Oracle、SQL Server、ClickHouse、MongoDB、Redis、SQLite、MariaDB、TiDB、Hive、DB2、Snowflake、BigQuery、Elasticsearch 等，并且可以通过插件继续扩展。除了 SQL 编辑外，还提供 ER 图、数据就地编辑、批量导入导出等企业级常见功能。
实际用法：桌面端和 Docker 两种部署方式
桌面端（零配置）
从 GitHub Releases 下载对应操作系统的安装包（Windows/macOS/Linux），安装后即可打开连接数据库。AI 助手需要在设置中配置你自己的模型 API，例如 OpenAI API Key 或自建的本地模型服务。
Docker 部署（服务端模式）
适合团队内使用或需要远程访问的场景。Docker 要求 19.03.0+，至少 2 核 CPU、4 GiB 内存。
第一步，克隆仓库并初始化加密密钥（密码学安全，必须执行）：
git clone https://github.com/OtterMind/Chat2DB.git && cd Chat2DB
./script/security/init-community-encryption-key.sh
第二步，运行容器：
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。
也可以使用自带的 docker-compose 文件：
docker compose --file docker/docker-compose.yml up --detach
注意：Docker 示例将数据存储在 $HOME/.chat2db-community-docker，而 Compose 版本使用名为 chat2db-community-data 的命名卷，两者不共享数据，请选择一种并保持一致。
与同类工具的区别
| 对比项 | Chat2DB | DataGrip / DBeaver |
|---|---|---|
| AI 集成 | 自带 AI 助手，需要用户自备模型 | 无原生 AI 能力，需第三方插件 |
| 模型控制 | 完全用户控制，可连接本地模型或公网 API | 依赖外部服务（如 GitHub Copilot） |
| 部署方式 | 桌面应用 + Docker 服务端 | 多数仅桌面应用（DBeaver 有 Web 版但非主流） |
| 数据库覆盖 | 30+，通过插件扩展 | 类似，但各有侧重 |
| 数据可视化 | 内置仪表盘、图表、ER 图 | 有类似功能但需插件 |
Chat2DB 的优势在于“自带 AI 但不绑定 AI”——你可以根据数据安全要求选择使用 OpenAI 还是本地的 Llama、Qwen 等模型。
注意事项
- 加密密钥：Docker 部署时必须执行
init-community-encryption-key.sh生成密钥文件，并妥善保管。重建容器时复用同一密钥，否则无法解密已有数据。 - 更新：拉取新镜像后，删除旧容器再运行启动命令。请保留
~/.config/chat2db-community/encryption.key文件。 - AI 模型成本：社区版本身免费，但使用 AI 功能时产生的 API 调用费用由用户自行承担（如果你使用 OpenAI 等付费模型）。
- 许可证：社区版是免费使用的，但仓库未明确声明开源许可证（部分代码可能为开源，CLI 工具明确标注开源，建议查看仓库
LICENSE文件确认）。