通过 1Panel 部署 DBX

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

安装 DBX

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

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

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

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

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

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

访问 DBX

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

http://服务器 IP:端口

例如端口保持默认值时：

http://192.168.1.100:4224

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

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

持久化与更新

DBX 的应用数据保存在 1Panel 应用目录的 data 目录，并挂载到容器内的 /app/data。重启容器或更新 DBX 时，连接配置和其他应用数据会继续保留。

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

连接数据库

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

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