企业官网建设流程全解析

LibreDB Studio 是一款免费的开源 SQL IDE 与数据库管理客户端，一个浏览器标签页即可连接 PostgreSQL、MySQL、Oracle、SQL Server、MongoDB、Redis、SQLite 等数据库。本文带你从零完成部署，并手把手连接PostgreSQL、MySQL 与 MongoDB三大主流数据库，覆盖SSL 加密与SSH 隧道两种常见生产配置，让你快速写出第一条查询。

为什么选 LibreDB Studio

在连接多个数据库时，你通常要装一堆工具：psql、MySQL Workbench、MongoDB Compass……LibreDB Studio 把这些整合进一个 Web 界面：

• 🗄️一个入口，多种引擎：关系型（PostgreSQL/MySQL/Oracle）+ 文档（MongoDB）+ 缓存（Redis）都在同一个侧边栏。
• 🔐安全内置：SSO、审计日志、数据脱敏，无企业墙。
• 🚀轻量快速：Docker 一条命令即可运行，无需本地编译。
• 🆓MIT 开源：完整功能免费，无任何付费门槛。

一键安装 LibreDB Studio

无需 clone、无需构建，两种方式任选：

# 方式一：Docker（推荐） docker run -p 3000:3000 ghcr.io/libredb/libredb-studio:latest # 方式二：Node.js 24+ 直接运行 npx @libredb/studio

启动后打开http://localhost:3000。首次启动会把管理员密码打印到日志（零配置）。

💡 提示：若通过局域网 IP（如http://192.168.x.x:3000）访问，记得设置AUTH_COOKIE_SECURE=false，否则会出现“健康检查通过但登录被弹回”的情况。

安装细节可参考 README.md。

认识 New Connection 连接弹窗

登录进入主界面后，点击左上角+或侧边栏的 Connections，打开New Connection弹窗。这里是你配置一切数据库连接的起点：

弹窗的核心要素：

• Connection Name：连接备注名（如My Database），方便在列表里辨认。
• Environment：环境标签PROD / STAGING / DEV / LOCAL，避免误连生产库。
• 数据库类型网格：PostgreSQL、MySQL、SQLite、Oracle、SQL Server、MongoDB 等，选中后展开对应参数。
• Paste URL：支持直接粘贴postgres://、mysql://、mongodb://连接串，自动解析字段。
• 底部Test Connection先测连通性，再点Establish Connection建立连接。

界面实现见 src/components/ConnectionModal.tsx。

连接 PostgreSQL 数据库

选中PostgreSQL，填写：

默认端口5432，支持标准postgres:///postgresql://连接串，也支持连接池与事务。对常见云服务商（Supabase、Neon、Render、AWS、Azure、GCP 等）还会自动开启 SSL，省去手动配置。

📌 深入：PostgreSQL 是该项目的参考实现，完整设计见 docs/providers/postgres.md。

连接 MySQL 数据库

选中MySQL，填写：

默认端口3306，支持mysql://连接串。若连接串里带?ssl-mode=REQUIRED/?ssl=true，系统会自动识别并开启对应加密模式，无需额外勾选。

📌 深入：MySQL 提供器与 SSL 自动检测见 docs/providers/mysql.md。

连接 MongoDB 数据库

MongoDB 是文档型数据库，选中MongoDB后有两种填写方式：

方式一：离散字段| 字段 | 说明 | |---|---| | Host | 如localhost| | Port | 默认27017| | Database | 要打开的库 | | Username / Password | 账号密码 | |Auth Source| 账号实际所在的库（常见为admin） |

方式二：粘贴连接串

mongodb+srv://user:pass@cluster.example.net/app?authSource=admin

⚠️两个易踩的坑：

1. authSource（Auth Source）：MongoDB 的账号建在某个库里（通常是admin），而你要操作的数据在另一个库。若账号建在admin，必须填authSource=admin，否则会报“凭据错误”——它看起来像密码错，其实是认证库不对。
2. 版本下限：需MongoDB 4.4+，更低版本会被驱动直接拒绝。

mongodb+srv://协议会自动走 DNS 与 TLS，适合 Atlas 等云服务。

📌 深入：MongoDB 的 MQL 查询、authSource与 TLS 详解见 docs/providers/mongodb.md。

配置 SSL/TLS 加密连接

生产环境务必开启 SSL。在连接弹窗下滑到SSL / TLS面板（非文件型数据库均提供），选择SSL Mode：

• 选verify-system：无需粘贴任何证书，云服务的公开根证书系统已信任，最省心。
• 选verify-ca/verify-full：在CA Certificate (PEM)里粘贴私有 CA；需要双向 TLS 时再填客户端证书/私钥。

💡 提示：直接粘贴postgres://...?sslmode=verify-full这类连接串时，系统会自动解析并选到对应模式，弹窗里也能看到当前生效的模式。

SSL 面板的实现见 src/components/ConnectionModal.tsx#L1294-L1358。

配置 SSH 隧道穿透内网

当数据库只在内网可达（如 VPC 私有实例），而你能登录一台跳板机时，用SSH 隧道：

在弹窗下方展开SSH Tunnel，勾选Enable SSH Tunnel，填写：

连接建立后，Studio 会先走 SSH 隧道转发到目标数据库端口，再执行真正的数据库连接——目标库地址不用公网暴露，更安全。

SSH 隧道表单实现见 src/components/ConnectionModal.tsx#L1430-L1561。

执行第一条查询

点击Test Connection确认绿点后，Establish Connection。连接会出现在左侧树中，展开可见Tables / Views / Indexes / Triggers。

在编辑器里输入第一条查询并点RUN：

SELECT * FROM employee LIMIT 50;

下方Results立即返回行列数据，支持Format / Copy / Export，敏感列会显示MASKED脱敏标记：

📌 更多可用引擎清单见 docs/DATABASE_PROVIDERS.md。

进阶：用 ERD 图与数据画像快速看懂数据

连上之后，不用只盯着 SQL，两个功能能帮你秒懂结构：

• ERD Visualizer：一键生成实体关系图，自动画出表、主键、外键连线，还能导出 PNG / SVG。

• Data Profiler：对单表做数据画像，给出总行数、列数、空值率、每列的分布、min/max 与去重值，帮你快速判断数据质量。

常见问题 FAQ

Q：连不上，报“凭据错误”？优先检查 MongoDB 的authSource是否等于账号建库（多为admin）；PostgreSQL/MySQL 再核对库名与账号权限。

Q：云数据库要不要手动开 SSL？不必。PostgreSQL/MySQL 对常见云商会自动开启 SSL；手动选verify-system即可覆盖绝大多数云场景。

Q：内网库怎么安全接入？用SSH 隧道，把跳板机地址与私钥填入隧道面板，目标库无需公网端口。

Q：如何只读保护生产库？把 Environment 设为PROD，配合 Studio 内置的只读配置与审计日志，可避免误写。

小结

LibreDB Studio 用一个标签页统一了 SQL 与文档数据库的连接、查询与可视化。掌握本文的SSL 模式与SSH 隧道后，你就能安全地接入生产与内网环境——从第一条查询开始，享受免费、开源、无企业墙的数据库开发体验。