跳到主要内容

安装指南

本页帮助你完成 DBLens 的安装、启动和首次检查。

支持平台​

DBLens 提供桌面版客户端，支持：

  • Windows
  • macOS
  • Linux

安装前建议​

  • 确认当前设备具备访问目标数据库的网络权限。
  • 如果数据库位于内网，提前准备好 VPN、堡垒机或 SSH 隧道信息。
  • 如果你计划使用离线登录或离线授权，建议先阅读 离线激活。

获取安装包​

请从官网的下载页获取对应平台版本：

如果你所在团队有统一的软件分发流程，也可以由管理员统一下发安装包。

安装与启动​

Windows​

  1. 下载对应安装包。
  2. 双击安装程序并完成安装。
  3. 安装完成后，从桌面快捷方式或开始菜单启动 DBLens。

macOS​

  1. 下载对应安装包。
  2. 将应用拖入 Applications。
  3. 首次启动时如遇到系统安全提示，请在系统设置中允许打开。

Linux​

  1. 下载对应安装包。
  2. 按发行版使用对应方式安装。
  3. 从应用菜单或命令行启动 DBLens。

首次启动后会发生什么​

  • 客户端会启动桌面壳和本地服务。
  • 本地服务会处理数据库连接、SQL 执行、AI 调用等能力。
  • 成功启动后，你会看到登录页或主工作台。

首次检查清单​

  • 能正常打开客户端。
  • 能看到登录方式或激活码验证入口。
  • 能新建一个数据库连接。
  • 能成功测试至少一个数据库连接。

常见问题​

安装后打不开​

  • 先确认安装包是否与当前系统架构匹配。
  • 检查是否被安全软件拦截。
  • 如是 macOS，检查系统是否阻止了未知来源应用。

启动后一直空白​

  • 先完全退出应用后重新打开。
  • 如果问题持续，请联系支持团队并附上系统版本、产品版本和问题截图。

要不要联网​

  • 在线登录、更新检查、官网订阅管理等功能需要联网。
  • 数据库连接本身是否联网，取决于你的数据库部署位置。
  • 离线登录场景可使用激活码验证，但流程与在线登录不同。