> For the complete documentation index, see [llms.txt](https://docs.imdcinsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imdcinsights.com/ying-yong-zhong-xin/yun-shu-ju-ku/cloudbeaver-kuai-su-ru-men.md).

# CloudBeaver快速入门

<br>

<figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-demogui-websoft9.png" alt=""><figcaption></figcaption></figure>

### 准备[​](https://support.websoft9.com/docs/cloudbeaver#%E5%87%86%E5%A4%87) <a href="#zhun-bei" id="zhun-bei"></a>

部署 创达睿通 提供的 CloudBeaver 之后，需完成如下的准备工作：

1. 在云控制台获取您的 **服务器公网IP地址**
2. 在云控制台安全组中，确保 **Inbound（入）规则** 下的 **TCP:80** 端口已经开启
3. 在服务器中查看 CloudBeaver 的 **默认账号和密码**
4. 若想用域名访问 CloudBeaver，务必先完成 **域名五步设置** 过程

### CloudBeaver 初始化向导[​](https://support.websoft9.com/docs/cloudbeaver#cloudbeaver-%E5%88%9D%E5%A7%8B%E5%8C%96%E5%90%91%E5%AF%BC) <a href="#cloudbeaver-chu-shi-hua-xiang-dao" id="cloudbeaver-chu-shi-hua-xiang-dao"></a>

#### 详细步骤[​](https://support.websoft9.com/docs/cloudbeaver#%E8%AF%A6%E7%BB%86%E6%AD%A5%E9%AA%A4) <a href="#xiang-xi-bu-zhou" id="xiang-xi-bu-zhou"></a>

1. 使用本地电脑浏览器访问：*<http://域名>* 或 *<http://服务器公网IP>*, 进入初始化页面&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-wizard001-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 设置用户名和密码，然后点击【Next】进入下一步&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-wizard002-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 继续点击【Next】进入下一步，最后点击【FINISH】完成初始化&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-wizard003-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 默认已经存在一个 SQlite 的演示连接&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-wizard004-websoft9.png" alt=""><figcaption></figcaption></figure>
5. 通过：【Administrator】>【Connection Management】，删除【SQLite - Chinook (Sample)】，避免遭受 SQL 注入攻击&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-wizard005-websoft9.png" alt=""><figcaption></figcaption></figure>
6. 再回到主页，默认的 SQLite 演示连接已经不存在

#### 出现问题？[​](https://support.websoft9.com/docs/cloudbeaver#%E5%87%BA%E7%8E%B0%E9%97%AE%E9%A2%98) <a href="#chu-xian-wen-ti" id="chu-xian-wen-ti"></a>

若碰到问题，请第一时刻联系 **技术支持**。也可以先参考下面列出的问题定位或 **FAQ** 尝试快速解决问题。

### CloudBeaver 使用入门[​](https://support.websoft9.com/docs/cloudbeaver#cloudbeaver-%E4%BD%BF%E7%94%A8%E5%85%A5%E9%97%A8) <a href="#cloudbeaver-shi-yong-ru-men" id="cloudbeaver-shi-yong-ru-men"></a>

> 需要了解更多 CloudBeaver 的使用，请参考官方文档

### CloudBeaver 常用操作[​](https://support.websoft9.com/docs/cloudbeaver#cloudbeaver-%E5%B8%B8%E7%94%A8%E6%93%8D%E4%BD%9C) <a href="#cloudbeaver-chang-yong-cao-zuo" id="cloudbeaver-chang-yong-cao-zuo"></a>

#### 共享数据连接[​](https://support.websoft9.com/docs/cloudbeaver#%E5%85%B1%E4%BA%AB%E6%95%B0%E6%8D%AE%E8%BF%9E%E6%8E%A5) <a href="#gong-xiang-shu-ju-lian-jie" id="gong-xiang-shu-ju-lian-jie"></a>

共享数据连接是指管理员可以通过更改连接配置来向用户团队授予共享连接访问权限。

1. 配置连接为 Shared（共享）

   ![](https://libs.websoft9.com/Websoft9/DocsPicture/en/cloudbeaver/cloudbeaver-share-set-websoft9.png)
2. 向用户授权

   ![](https://libs.websoft9.com/Websoft9/DocsPicture/en/cloudbeaver/cloudbeaver-access-set-websoft9.png)

#### 管理 MySQL[​](https://support.websoft9.com/docs/cloudbeaver#%E7%AE%A1%E7%90%86-mysql) <a href="#guan-li-mysql" id="guan-li-mysql"></a>

下面介绍如何使用 CloudBeaver 管理 MySQL 数据库

**准备**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E5%87%86%E5%A4%87-1)

提前准备 MySQL 服务并确保 MySQL 的远程访问已开放。

如果没有 MySQL 服务，请通过 MySQL 应用 快速部署一个自己的 MySQL 服务。

**配置**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E9%85%8D%E7%BD%AE)

1. 登录 CloudBeaver 控制台，点击右上角【Settings】图标，选择【Administration】>【Connection Management】，添加对应数据库，进行连接管理<br>

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/cloudbeaver/cloudbeaver-connection-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 设置连接信息：主机地址、端口、账号密码（可以勾选是否保存），然后点击【Save】&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-conmysql002-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 设置信息保存后，使用这个 MySQL 连接，输入数据库的账号和密码&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-conmysql003-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 成功连接到 MySQL，可以开始管理工作&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-conmysql004-websoft9.png" alt=""><figcaption></figcaption></figure>

#### 管理 PostgreSQL[​](https://support.websoft9.com/docs/cloudbeaver#%E7%AE%A1%E7%90%86-postgresql) <a href="#guan-li-postgresql" id="guan-li-postgresql"></a>

下面介绍如何使用 CloudBeaver 管理 PostgreSQL 数据库

**准备**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E5%87%86%E5%A4%87-2)

提前准备 PostgreSQL 服务并确保 PostgreSQL 的远程访问已开放。

若没有 PostgreSQL 服务，请通过 PostgreSQL 应用 快速部署一个自己的 PostgreSQL 服务。

**配置**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E9%85%8D%E7%BD%AE-1)

1. 登录 CloudBeaver 控制台，点击右上角【Settings】图标，选择【Administration】>【Connection Management】，添加对应数据库，进行连接管理<br>

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/cloudbeaver/cloudbeaver-connection-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 设置连接信息：主机地址、端口、账号密码（可以勾选是否保存），然后点击【Save】&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-connsetting-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 设置信息保存后，使用这个 PostgreSQL 连接，输入数据库的账号和密码&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-conlogin-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 成功连接到 PostgreSQL，可以开始管理工作

#### 管理 SQLServer[​](https://support.websoft9.com/docs/cloudbeaver#%E7%AE%A1%E7%90%86-sqlserver) <a href="#guan-li-sqlserver" id="guan-li-sqlserver"></a>

下面介绍如何使用 CloudBeaver 管理 SQLServer 数据库

**准备**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E5%87%86%E5%A4%87-3)

提前准备 SQLServer 服务并确保 SQLServer 的远程访问已开放。

若没有 SQLServer 服务，请通过 SQLServer 应用 快速部署一个自己的 SQLServer 服务。

**配置**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E9%85%8D%E7%BD%AE-2)

1. 登录 CloudBeaver 控制台，点击右上角【Settings】图标，选择【Administration】>【Connection Management】，添加对应数据库，进行连接管理<br>

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/cloudbeaver/cloudbeaver-connection-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 设置连接信息：主机地址、端口、账号密码（可以勾选是否保存），然后点击【Save】&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-connsetting-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 设置信息保存后，使用这个 SQLServer 连接，输入数据库的账号和密码&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-conlogin-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 成功连接到 SQLServer，可以开始管理工作

#### 管理 SQLite[​](https://support.websoft9.com/docs/cloudbeaver#%E7%AE%A1%E7%90%86-sqlite) <a href="#guan-li-sqlite" id="guan-li-sqlite"></a>

下面介绍如何使用 CloudBeaver 管理 SQLite 数据库

**准备**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E5%87%86%E5%A4%87-4)

提前准备 SQLite 服务并确保 SQLite 的远程访问已开放。

若没有 SQLite 服务，请通过 SQLite 应用 快速部署一个自己的 SQLite 服务。

**配置**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E9%85%8D%E7%BD%AE-3)

1. 登录 CloudBeaver 控制台，点击右上角【Settings】图标，选择【Administration】>【Connection Management】，添加对应数据库，进行连接管理<br>

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/cloudbeaver/cloudbeaver-connection-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 设置连接信息：主机地址、端口、账号密码（可以勾选是否保存），然后点击【Save】&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-openconnsqlite-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 设置信息保存后，使用这个 SQLite 连接，输入数据库的账号和密码&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-conlogin-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 成功连接到 SQLite，可以开始管理工作

#### 管理 Oracle Database[​](https://support.websoft9.com/docs/cloudbeaver#%E7%AE%A1%E7%90%86-oracle-database) <a href="#guan-li-oracledatabase" id="guan-li-oracledatabase"></a>

下面介绍如何使用 CloudBeaver 管理 Oracle 数据库

**准备**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E5%87%86%E5%A4%87-5)

提前准备 Oracle 服务并确保 Oracle 的远程访问已开放。

若没有 Oracle 服务，请通过 Oracle 应用 快速部署一个自己的 Oracle 服务。

**配置**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E9%85%8D%E7%BD%AE-4)

1. 登录 CloudBeaver 控制台，点击右上角【Settings】图标，选择【Administration】>【Connection Management】，添加对应数据库，进行连接管理<br>

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/cloudbeaver/cloudbeaver-connection-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 设置连接信息：主机地址、端口、账号密码（可以勾选是否保存），然后点击【Save】&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-connsetting-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 设置信息保存后，使用这个 Oracle 连接，输入数据库的账号和密码&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-conlogin-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 成功连接到 Oracle，可以开始管理工作

#### 重置密码[​](https://support.websoft9.com/docs/cloudbeaver#%E9%87%8D%E7%BD%AE%E5%AF%86%E7%A0%81) <a href="#zhong-zhi-mi-ma" id="zhong-zhi-mi-ma"></a>

常用的 CloudBeaver 重置密码相关的操作主要有修改密码和找回密码两种类型：

**修改密码**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E4%BF%AE%E6%94%B9%E5%AF%86%E7%A0%81)

1. 登录 CloudBeaver 后台，右上角打开：【Administrator】>【User】，找到所需修改密码的账号对象&#x20;

   <figure><img src="/files/qBA7EwSSSxC04yLaolG3" alt=""><figcaption></figcaption></figure>
2. 开始修改密码，点击【Save】后生效

**找回密码**[**​**](https://support.websoft9.com/docs/cloudbeaver#%E6%89%BE%E5%9B%9E%E5%AF%86%E7%A0%81)

如果用户忘记了密码，只能通过重置 CloudBeaver 容器的方式找回。

#### 驱动管理[​](https://support.websoft9.com/docs/cloudbeaver#%E9%A9%B1%E5%8A%A8%E7%AE%A1%E7%90%86) <a href="#qu-dong-guan-li" id="qu-dong-guan-li"></a>

Driver managements

#### 导出数据[​](https://support.websoft9.com/docs/cloudbeaver#%E5%AF%BC%E5%87%BA%E6%95%B0%E6%8D%AE) <a href="#dao-chu-shu-ju" id="dao-chu-shu-ju"></a>

![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/cloudbeaver/cloudbeaver-exportdata-websoft9.png)

### CloudBeaver 参数[​](https://support.websoft9.com/docs/cloudbeaver#cloudbeaver-%E5%8F%82%E6%95%B0) <a href="#cloudbeaver-can-shu" id="cloudbeaver-can-shu"></a>

CloudBeaver 应用中包含 Nginx, Docker 等组件，可通过 **通用参数表** 查看路径、服务、端口等参数。

通过运行`docker ps`，可以查看到 CloudBeaver 运行时所有的 Container：

```
CONTAINER ID   IMAGE                        COMMAND             CREATED       STATUS       PORTS                                       NAMES
34baab38d75f   dbeaver/cloudbeaver:latest   "./run-server.sh"   3 hours ago   Up 3 hours   0.0.0.0:8080->8978/tcp, :::8080->8978/tcp   cloudbeaver
```

下面仅列出 CloudBeaver 本身的参数：

#### 路径[​](https://support.websoft9.com/docs/cloudbeaver#path) <a href="#path" id="path"></a>

* CloudBeaver 配置文件： */data/apps/cloudbeaver/data/cloudbeaver/GlobalConfiguration/.dbeaver/data-sources.json*

> data-sources.json 存放数据库连接信息

#### 端口[​](https://support.websoft9.com/docs/cloudbeaver#%E7%AB%AF%E5%8F%A3) <a href="#duan-kou" id="duan-kou"></a>

| 端口号  | 用途                                   | 必要性 |
| ---- | ------------------------------------ | --- |
| 9090 | CloudBeaver 原始端口，已通过 Nginx 转发到 80 端口 | 可选  |

#### 版本[​](https://support.websoft9.com/docs/cloudbeaver#%E7%89%88%E6%9C%AC) <a href="#ban-ben" id="ban-ben"></a>

控制台查看

#### 服务[​](https://support.websoft9.com/docs/cloudbeaver#%E6%9C%8D%E5%8A%A1) <a href="#fu-wu" id="fu-wu"></a>

```
sudo docker start | stop | restart | stats cloudbeaver
```

#### 命令行[​](https://support.websoft9.com/docs/cloudbeaver#%E5%91%BD%E4%BB%A4%E8%A1%8C) <a href="#ming-ling-hang" id="ming-ling-hang"></a>

#### API[​](https://support.websoft9.com/docs/cloudbeaver#api) <a href="#api" id="api"></a>