websql 网页SQL管理工具

一、项目介绍

websql 是一款国产开源的网页版 SQL 管理与数据开发工具，定位是”开箱即用、简约而不简单”的在线 SQL 执行平台。项目托管在 Gitee（GVP 项目），Star 400+，Java 编写，当前版本 v4.0.7。

• 项目地址: gitee.com/boy_0214/websql
• 演示环境: websql.cgygeo.com（账号 demo / demo123，配置较低可能不稳定）
• 帮助文档: Gitee Wiki
• 许可证: GPL 3.0（注意：GPL 具有传染性，二次开发并分发需同样开源；仅内部使用不受影响）

与 Chat2DB 的差异定位：Chat2DB 偏”AI 数据库客户端”，websql 更偏团队协作的 SQL 管控平台——强调权限控制、团队数据隔离、执行审计、危险 SQL 拦截、定时监测告警和 ETL 同步。

二、核心功能

三、支持的数据库

对国产数据库（达梦、人大金仓、OceanBase、神州通用）的支持是它相对同类工具的一个亮点。

四、技术架构

• 后端: Spring Boot + JPA + Druid 连接池 + sa-token 权限框架 + langchain4j（AI），JDK 8 / 17 均可运行
• 前端: Layui + CodeMirror 编辑器
• 内置 H2 作为自身元数据库，无需额外装库建表，一条命令启动

五、部署方式

5.1 Docker 部署（推荐）

镜像托管在阿里云 ACR，国内拉取速度快：

docker run -di \
  --name websql \
  -v ~/docker/websql/data:/websql/data \
  -e H2_CONSOLE_ENABLED=true \
  -e DRUID_ENABLED=true \
  -e OPENAI_API_KEY=你的Key \
  -p 80:80 \
  registry.cn-beijing.aliyuncs.com/cgycms/websql:latest

说明：

• /websql/data 是持久化目录（内置 H2 数据、配置），必须挂载，否则容器删除后账号与数据源配置丢失
• OPENAI_API_KEY 仅 Text2Sql 功能需要，不用 AI 可不传
• 端口 80 被占用时用 -p 8080:80 改映射

5.2 JAR 部署

nohup java -jar websql.jar >> web.log &

• 默认端口 80，可用 --server.port=8080 修改
• 访问地址 http://localhost/index

5.3 默认账号

首次登录后请立即修改默认密码。

六、选型建议

• 需要给团队提供带权限管控的在线 SQL 入口、做定时数据监测告警 → 选 websql
• 需要个人/小队的 AI 辅助查库、桌面体验 → 选 Chat2DB
• 两者都支持 Docker 部署，也可以并存使用