📅 更新时间：2026-03-17
👤 适用人群：新手小白
💻 环境：Win11 + DBeaver + 某公司云电脑

---

📋 目录

• 一、环境准备
• 二、下载 DBeaver
• 三、配置 SSH 隧道连接
• 四、连接测试
• 五、查看数据
• 六、常见问题

---

一、环境准备

1.1 你的环境

项目	信息
操作系统	Windows 11
所在地	北京
数据库客户端	DBeaver（待安装）

1.2 服务器环境

项目	信息
云服务商	某公司云电脑
服务器地址	公网 IP（联系管理员获取）
SSH 端口	22
SSH 用户	admin
SSH 密码	[联系管理员获取]
MySQL 数据库	clc8_db
MySQL 用户	root
MySQL 密码	联系管理员获取

1.3 为什么用 SSH 隧道？

连接方式	优点	缺点
SSH 隧道	✅ 安全（SSH 加密） ✅ 不需要开放 3306 端口 ✅ 云平台默认支持	需要 SSH 密码
直接连接	配置简单	❌ 需要开放 3306 端口 ❌ 有安全风险 ❌ 云平台默认关闭

🎯 推荐：SSH 隧道方式

---

二、下载 DBeaver

2.1 访问官网

打开浏览器，访问：https://dbeaver.io/download/

2.2 选择版本

1. 找到 Windows 版本
2. 点击 Download 按钮
3. 选择 Installer（推荐）或 Portable 版本

2.3 安装步骤

1. 双击下载的安装包
2. 点击 Next → I Agree
3. 选择安装路径（默认即可）
4. 点击 Install → Finish

2.4 首次启动

双击桌面 DBeaver 图标，启动程序。

---

三、配置 SSH 隧道连接

3.1 新建数据库连接

1. 打开 DBeaver
2. 点击左上角 🔌 新建数据库连接 按钮
3. 或者按快捷键 F3

3.2 选择数据库类型

1. 在弹出的窗口中选择 MySQL
2. 点击 Next

3.3 配置主连接（Main 标签页）

⚠️ 重要：这里填 localhost，不是公网 IP！

Host: localhost
Port: 3306
Database: clc8_db
Username: root
Password: [联系管理员获取]

截图说明：

• Host 填写 localhost（因为通过 SSH 隧道访问）
• Port 填写 3306（MySQL 默认端口）
• Database 填写实际数据库名
• Username 填写 MySQL 用户名
• Password 填写 MySQL 密码

3.4 配置 SSH 隧道（SSH 标签页）

1. 点击顶部的 SSH 标签页
2. 勾选 ✅ Use SSH Tunnel

SSH Host: [联系管理员获取公网 IP]
SSH Port: 22
SSH Username: admin
SSH Password: [联系管理员获取]

✅ Save password locally（可选，方便下次自动登录）

截图说明：

• 勾选 Use SSH Tunnel
• SSH Host 填写服务器公网 IP（联系管理员获取）
• SSH Port 填写 22（SSH 默认端口）
• SSH Username 填写 SSH 用户名
• SSH Password 填写 SSH 登录密码

3.5 测试连接

1. 点击左下角的 Test Tunnel 按钮
   • 应该显示：SSH tunnel connected ✅
2. 点击 Test Connection 按钮
   • 应该显示：Connected ✅

3.6 完成配置

1. 点击 Finish 按钮
2. 连接创建成功！

---

四、连接测试

4.1 验证连接

1. 在左侧数据库列表中，找到刚创建的连接
2. 双击连接名称（或右键 → Connect）
3. 如果连接成功，会显示数据库结构

4.2 查看数据库结构

展开连接，应该能看到：

clc8_db (MySQL)
├── tables
│   ├── admin_users      (管理员表)
│   ├── orders           (订单表)
│   ├── order_items      (订单项表)
│   ├── payments         (支付表)
│   ├── products         (商品表)
│   └── users            (用户表)
└── views

---

五、查看数据

5.1 查看商品数据

1. 右键点击 products 表
2. 选择 查看数据 → 查看所有数据
3. 或者直接双击 products 表

应该能看到示例商品：

id	name	description	price	stock	status
1	高性能云服务器	2 核 4G | 50G SSD | 100M 带宽	199.00	100	ONLINE

tips:这里是举例子哈，你的表里不一定有数据

5.2 查看管理员数据

1. 右键点击 admin_users 表
2. 选择 查看数据

应该能看到超级管理员：

id	username	email	status
1	admin	admin@example.com	ACTIVE

tips:这里是举例子哈，你的表里不一定有数据

5.3 执行 SQL 查询

1. 按 F3 打开 SQL 编辑器
2. 输入 SQL 语句
3. 按 Ctrl + Enter 执行

常用 SQL 示例：

-- 查看所有商品
SELECT * FROM products;

-- 查看所有订单（按时间倒序）
SELECT * FROM orders ORDER BY created_at DESC;

-- 查看订单详情（带商品信息）
SELECT o.order_no, o.total_amount, o.status, p.name 
FROM orders o 
JOIN order_items oi ON o.id = oi.order_id 
JOIN products p ON oi.product_id = p.id
ORDER BY o.created_at DESC;

-- 统计订单数量
SELECT status, COUNT(*) as count FROM orders GROUP BY status;

-- 查看今日订单
SELECT * FROM orders 
WHERE DATE(created_at) = CURDATE();

5.4 导出数据

1. 右键点击表名
2. 选择 导出数据
3. 选择导出格式（CSV/Excel/SQL）
4. 选择保存路径
5. 点击 完成

---

六、常见问题

6.1 连接失败：Communications link failure

错误信息：

Can not read response from server. Expected to read 4 bytes, read 0 bytes

原因： 配置成了直接连接公网 IP:3306，但 MySQL 在 Docker 容器里

解决方法：

1. 删除当前连接
2. 重新创建连接
3. Main 标签页 的 Host 填写 localhost（不是公网 IP）
4. SSH 标签页 填写服务器公网 IP

---

6.2 SSH 连接失败：Authentication failed

错误信息：

SSH tunnel connection failed: Authentication failed

原因： SSH 密码错误

解决方法：

1. 确认 SSH 密码是否正确
2. 如果不记得密码，联系管理员重置密码
3. 重启服务器后重试

---

6.3 SSH 连接失败：Connection refused

错误信息：

SSH tunnel connection failed: Connection refused

原因： SSH 服务未启动或端口错误

解决方法：

1. 确认 SSH 端口是 22
2. 检查云平台安全组是否开放 22 端口
3. 联系管理员确认 SSH 服务状态

---

6.4 数据库不存在：Unknown database ‘clc8_db’

错误信息：

Unknown database 'clc8_db'

原因： 数据库未创建

解决方法：

1. 联系管理员创建数据库
2. 或者自行创建：

CREATE DATABASE clc8_db DEFAULT CHARACTER SET utf8mb4;

---

6.5 中文乱码

现象： 查询结果显示乱码

解决方法：

1. 右键连接 → 编辑连接
2. 选择 Driver properties 标签页
3. 添加属性：

   characterEncoding: utf8
   useUnicode: true
   

4. 重新连接

---

七、安全提示

7.1 密码管理

• ✅ 不要在公共电脑保存密码
• ✅ 定期更换服务器密码
• ✅ 不要将密码分享给他人

7.2 数据操作

• ✅ 查询数据可以随意操作
• ⚠️ 修改/删除数据前请确认
• ⚠️ 生产环境谨慎操作

7.3 连接管理

• ✅ 使用完毕后断开连接
• ✅ 不要将连接配置导出分享
• ✅ 定期检查连接日志

---

八、快捷操作

快捷键	功能
F3	新建连接 / 打开 SQL 编辑器
Ctrl + Enter	执行 SQL
F5	刷新数据
Ctrl + D	复制当前行
Ctrl + /	注释/取消注释 SQL

---

九、总结

配置要点

1. Main 标签页：Host 填 localhost
2. SSH 标签页：Host 填服务器公网 IP（联系管理员获取）
3. SSH 隧道：必须勾选

连接信息汇总

项目	值
SSH 主机	联系管理员获取
SSH 端口	22
SSH 用户	admin
MySQL 主机	localhost（通过 SSH 隧道）
MySQL 端口	3306
MySQL 数据库	clc8_db
MySQL 用户	root
MySQL 密码	联系管理员获取

---

十、后续学习

推荐资源

• DBeaver 官方文档：https://dbeaver.com/docs/
• MySQL 官方文档：https://dev.mysql.com/doc/
• SQL 入门教程：https://www.w3schools.com/sql/

进阶功能

• 数据导入/导出
• SQL 脚本执行
• 数据库备份
• 性能监控
• ER 图查看

---

🎉 恭喜！你已经成功连接某公司云电脑 MySQL 数据库！

有问题随时联系管理员～ 🚀

---

附录：敏感信息脱敏说明

本教程已对以下敏感信息进行脱敏处理：

原信息类型	脱敏后
公网 IP 地址	联系管理员获取
云服务商名称	某公司云电脑
SSH 密码	联系管理员获取
MySQL 密码	联系管理员获取
管理员邮箱	admin@example.com

🚀BTW 实际使用时，可联系草履虫君，也欢迎到草履虫吧来坐坐cLc8.cn！