v3.4.0 稳定版极简极速本地 MySQL 客户端

macOS 与 Windows 快速安装与连接配置指南 | VloamDb 文档手册

VloamDb 是面向 macOS 和 Windows 的本地原生轻量 MySQL 客户端。本章介绍双系统的安装流程、免安装绿色模式及首次连接数据库配置。

macOS 安装与 Gatekeeper 隔离解除

VloamDb 为 macOS 提供 Universal DMG 安装包,原生支持 Apple Silicon (M1/M2/M3/M4) 及 Intel 架构处理器。

1

下载 DMG 镜像并挂载

从官网下载最新版 VloamDb.dmg,双击打开挂载磁盘镜像。

2

拖拽至 Applications 目录

将 VloamDb 图标拖入右侧 Applications 文件夹,完成本地部署。

3

首次启动与安全授权

若系统弹出「无法验证开发者」安全警告,请在「系统设置 → 隐私与安全性」底部点击「仍要打开」,或使用右键点击应用选择「打开」。

💡
终端一键解除 Gatekeeper 隔离标识

如遇到「应用已损坏,应移至废纸篓」误报,打开终端执行以下命令即可清除隔离属性:

zsh / bash
xattr -cr /Applications/VloamDb.app

Windows 安装与便携模式

VloamDb 为 64 位 Windows 10/11 系统提供标准安装包 (.exe) 与免安装绿色便携版 (.zip)。

标准安装程序 (Recommended)

双击运行安装包,支持自动创建桌面与开始菜单快捷方式,支持静默就地更新。

绿色便携版 (Zero Install)

解压至任意目录或 U 盘即可直接运行,所有配置存储于同级 data 目录,不修改系统注册表。

🛡️
Windows SmartScreen 拦截提示

首次运行时若遇到 Windows Defender SmartScreen 拦截,点击「更多信息」→「仍要运行」即可正常启动。

新建第一个 MySQL 连接

启动 VloamDb 后,点击左上角「新建连接」或按快捷键 <code>⌘N</code> (macOS) / <code>Ctrl+N</code> (Windows),即可打开连接配置弹窗。

配置字段默认值说明与注意事项
Host / 地址127.0.0.1MySQL 服务器主机名、IP 地址或远程域名
Port / 端口3306标准 MySQL 端口,如改动请输入自定义端口号
User / 用户名root数据库登录用户名
Password / 密码-凭据安全保存在本机操作系统 Keychain / DPAPI 中
Environment / 环境标签Dev (开发)可选择 Dev (绿)、Staging (黄)、Prod (红),触发相应防手滑保护

填写完成后,点击右下角「测试连接」。连接成功后点击「保存并连接」,即可立即进入工作台。