Chat2DB 离线部署实操笔记40 数据库的本地 SQL 客户端一条 Docker 命令先跑起来【免费下载链接】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某次在内网机房做数据排查装好的数据库客户端打开就连不上模型服务补全和 AI 功能直接罢工换成需要云端协同的工具又过不了数据不能出内网这条线。Chat2DB 社区版走的是本地优先local-first路线它是个免费的跨平台数据库客户端单机就能连 40 多种数据库编辑、执行 SQL、管理表对象、导入导出数据AI 部分由你自己接模型不依赖任何外部云。下面按先跑起来、再看原理、最后选版本的顺序把离线部署过程记一遍。三步把 Chat2DB 离线部署跑起来 最省事的方式是 Docker。先说两个硬指标Docker 19.03.0 以上、机器 2 核 4 GiB 以上内存。部署前需要先生成一把本地加密密钥——数据源密码和 AI 的 API Key 都用 AES-256-GCM 落盘加密Web 方式启动时没有合法密钥会直接拒绝启动所以这步不能跳# 1. 仓库里执行一次依赖 openssl密钥落在 ~/.config/chat2db-community/encryption.key ./script/security/init-community-encryption-key.sh # 2. 启动容器注意只映射到 127.0.0.1 的 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即可。不想手敲参数可以用仓库自带的编排文件 docker/docker-compose.yml改好端口变量后docker compose --file docker/docker-compose.yml up -d一条命令搞定。⚠️ 两个容易踩的坑一是升级镜像、重建容器时encryption.key必须原样保留换一把密钥旧密码就再也解不开了二是 HTTP 服务只建议绑定127.0.0.1它本质是单用户本机工具别把它裸奔到办公网里。如果要从源码构建比如要定制插件环境需要 Temurin JDK 17、Node 18.17、Maven 3.8git clone https://gitcode.com/GitHub_Trending/ch/Chat2DB cd Chat2DB cd chat2db-community-client yarn install --frozen-lockfile yarn run build cd .. mvn -B clean package -Dmaven.test.skiptrue -f chat2db-community-server/pom.xml -pl chat2db-community-start -am ./script/security/init-community-encryption-key.sh java -Dloader.pathchat2db-community-server/chat2db-community-start/target/lib \ -Dchat2db.guifalse -Dchat2db.runtime.modecommunity -Dchat2db.modeWEB \ -Dchat2db.network.statusOFFLINE -Dserver.address127.0.0.1 -Dserver.port10825 \ -jar chat2db-community-server/chat2db-community-start/target/chat2db-community.jar构建脚本里-Dchat2db.network.statusOFFLINE这个参数值得留意它明确了整套进程按离线模式运行。桌面端则是直接下 Windows / macOS / Linux 安装包Linux 有 deb、rpm 和 AppImage装上即用。离线能力是怎么撑起来的部署跑通之后再看几个关键点每项一句话说清原理就够了。多数据库靠插件矩阵。后端按数据库拆成 30 多个独立插件模块MySQL、PostgreSQL、Oracle、ClickHouse、Redis、MongoDB、Snowflake、国产的 DM/人大金仓/Oscar 都在里面新增一个 JDBC 数据库基本只需要配置不用动核心代码。这也是它能覆盖 40 多种数据库的方式。敏感信息本地加密。数据源密码、AI 模型的 API Key 用 AES-256-GCM 加密后存在本机的/root/.chat2db-community容器内路径或桌面端应用目录密钥每个安装实例独立生成初始化逻辑见 script/security/init-community-encryption-key.sh。SQL 台数据走 IndexedDB。前端把控制台内容、DDL 这类状态存进浏览器的 IndexedDB表结构定义在 chat2db-community-client/src/indexedDB/table.ts刷新、断网都不丢也不需要额外部署存储。AI 是自带模型模式。社区版不内置云端模型而是在设置里配置自己的模型端点——内网里指向一台装了本地推理服务的机器就行再配合 MCP 配置可以把 AI 接到工作流里。SQL 补全这类轻量能力则由前端本地完成src/constants/IntelliSense/ 目录里按 MySQL、Oracle、PG、SQL Server、Redis 等方言分别维护了关键词和上下文规则。一句话概括数据库连接、SQL 工作台、元数据管理全部闭环在本机唯一可能需要网络的只有你自己选接的模型服务而这个服务放内网即可。版本怎么选社区版够不够用一句话版只要需求是断网环境里管理自己的数据库社区版5.3.0Source Available 许可就是完整可用的需要官方 AI 服务、团队账号体系和多端同步才看商业版。Community本仓库本地数据库客户端全套能力——SQL 编辑/补全/执行、表对象 DDL/DML 管理、数据导入导出、Dashboard 与图表、自定义 AI 模型、MCP 支持、开源 CLI。单用户定位没有账号体系。Pro / Enterprise商业版在同一核心上增加官方 AI 服务、账号体系、云端存储与多设备同步以及团队协作和权限治理。这部分不在本仓库内。所以选型问题通常很简单数据在哪、团队要多大。单机或小组内网自用社区版加 Docker 就结束多人共享配置、要审计和多端同步再考虑商业版。进阶配置与后续方向企业内网落地时多做的几件事把密钥放到受控目录并纳入备份流程用 Compose 的CHAT2DB_BIND_ADDRESS/CHAT2DB_PORT变量统一改绑定地址和端口桌面端按 jpackage 打包脚本产出 deb/rpm/AppImage 走内部分发。后续演进上社区版持续在加数据库插件和 MCP 能力而官方 AI 服务、账号同步、团队治理是商业版的主线内网用户用社区版 自建模型服务基本可以覆盖。本地优先、自带模型、一条 Docker 命令起步——内网跑数据库管理这条路线值得试。仓库https://gitcode.com/GitHub_Trending/ch/Chat2DB 详细说明见 README_CN.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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考