# 通过 1Panel 部署 DBX

> 使用 1Panel 应用商店安装、访问和更新 DBX Web 版。

Source: https://dbxio.com/cn/docs/1panel

Language: zh-CN

Relative links resolve against https://dbxio.com/cn/docs/1panel.



1Panel 应用商店提供了 DBX 官方 Docker 镜像，可以直接在服务器上完成安装和更新，不需要手动编写 Docker 命令。

1Panel 安装的是 DBX Web 版。数据库查询、对象浏览、数据编辑、导入导出、AI 和驱动管理等核心能力在服务器端运行；本机文件选择、Deep Link、本机 CLI Agent 和桌面版定时数据库备份不属于 Web 运行方式。

## 可选的服务器方案

如果你还没有用于部署 DBX 的服务器，可以了解[雨云](https://www.rainyun.com/MTE5Mjc4Ng==_)。雨云是面向开发者和站长的云服务提供商，提供云服务器、物理服务器、游戏云和配套基础设施服务。当然，任何满足 Docker 和 1Panel 运行要求的服务器都可以部署 DBX。

## 安装 DBX

1. 登录 1Panel，打开 **应用商店**。

2. 搜索 `DBX`，选择 DBX 官方应用。

3. 选择要安装的版本，点击 **安装**。

4. 在安装表单中确认以下配置：

   | 配置项  | 默认值    | 说明                                                               |
   | ---- | ------ | ---------------------------------------------------------------- |
   | 端口   | `4224` | 服务器对外提供 DBX Web 访问的端口。若该端口已被占用，请改为其他未使用端口。                       |
   | 访问密码 | 自动生成   | 打开 DBX Web 版时使用的登录密码。1Panel 会按 `random: true` 规则生成默认值，也可以在安装时修改。 |

5. 点击 **确定**，等待 1Panel 拉取镜像并启动容器。

访问密码不是数据库密码，而是 DBX Web 版的登录密码。请保存安装时设置或生成的密码。

## 访问 DBX

安装完成后，在浏览器中打开：

```text
http://服务器 IP:端口
```

例如端口保持默认值时：

```text
http://192.168.1.100:4224
```

在登录页面输入安装时设置的 **访问密码**。如果无法访问，请依次检查：

* 1Panel 中 DBX 应用是否显示为运行中；
* 浏览器地址中的端口是否与安装表单中的端口一致；
* 云服务器安全组和系统防火墙是否允许该端口；
* 端口是否被其他服务占用。

## 持久化与更新

DBX 的应用数据保存在 1Panel 应用目录的 `data` 目录，并挂载到容器内的 `/app/data`。这里包含 DBX 自身的存储数据库、已保存连接、插件、驱动和其他持久化状态。重启容器或更新 DBX 时，只要挂载目录未被删除，这些数据就会继续保留。

更新时，在 1Panel 的 **已安装** 应用中打开 DBX，选择可用的新版本并执行更新。更新前建议先确认数据目录已经纳入服务器备份。

不要直接删除 DBX 的应用数据目录，否则会同时删除已保存的连接配置和其他本地数据。卸载应用前请先完成备份。

备份 `/app/data` 只保护 DBX 的应用配置和运行数据，不会备份 MySQL、PostgreSQL 等目标数据库中的业务数据。Web 版不提供桌面版的定时数据库备份任务；业务数据库仍应使用数据库原生备份、云服务快照或独立备份系统。

DuckDB 不嵌入 `dbx-web` 镜像。首次启动后如需使用 DuckDB，请在[驱动管理器](/cn/docs/driver-management)中单独安装；驱动保存在 `/app/data/agents`，因此也依赖同一个持久化目录。

## Web 版路径与文件

在 1Panel 部署中，DBX 后端读取的是服务器或容器文件系统：

* SSH 私钥路径必须是容器可读取的路径，不是浏览器电脑上的路径；
* JDBC JAR、插件、Agent 和下载的驱动保存在服务器端数据目录；
* 浏览器上传的导入文件会先进入服务器端受控目录，再由任务读取；
* 数据库文件连接和服务器端路径都必须从容器视角判断可访问性。

不要因为浏览器运行在个人电脑上，就把本机绝对路径填写到 Web 版配置中。桌面版与 Web 版的完整边界见[什么是 DBX](/cn/docs/what-is-dbx)。

## 连接数据库

登录 DBX 后，点击 **新建连接**，填写目标数据库的类型、地址、端口、用户名和数据库密码。运行在 1Panel 服务器上的 DBX 容器必须能够访问目标数据库：

* 如果数据库也运行在同一台服务器上，使用服务器可访问的地址和端口；
* 如果数据库运行在同一个 Docker 网络中，使用数据库容器名和容器端口；
* 如果数据库位于内网，确保 1Panel 服务器已经接入对应网络，或按需配置 [SSH 隧道](/cn/docs/ssh-tunnel)。

`4224` 是 DBX Web 服务端口，不是目标数据库端口。连接数据库时仍需填写 MySQL、PostgreSQL、Redis 等目标数据库自身的端口。

## 生产部署建议

* 使用足够长且唯一的访问密码，不要保留示例值；
* 通过 1Panel 反向代理配置 HTTPS，并限制安全组和主机防火墙暴露范围；
* 需要受控升级时固定版本，更新前备份 `/app/data` 并阅读[更新日志](/cn/changelog)；
* 为 DBX 使用独立、最小权限的数据库账号，生产连接优先启用只读保护；
* 定期检查驱动和插件来源，不要把不受信任的 JAR 或可执行文件放入数据目录。

更多连接、写入、AI 和 API 边界见[生产安全](/cn/docs/production-safety)。

### [驱动管理](/cn/docs/driver-management)

安装 Web 版需要的 DuckDB、JDBC 和 Agent 驱动，并查看运行状态。

### [数据库备份](/cn/docs/database-backup)

了解桌面版定时备份的支持范围，以及 Web 部署为什么需要外部备份方案。