112 lines
5.7 KiB
Plaintext
112 lines
5.7 KiB
Plaintext
---
|
||
title: 通过 1Panel 部署 DBX
|
||
description: 使用 1Panel 应用商店安装、访问和更新 DBX Web 版。
|
||
---
|
||
|
||
1Panel 应用商店提供了 DBX 官方 Docker 镜像，可以直接在服务器上完成安装和更新，不需要手动编写 Docker 命令。
|
||
|
||
<Callout type="info">
|
||
1Panel 安装的是 DBX Web 版。数据库查询、对象浏览、数据编辑、导入导出、AI 和驱动管理等核心能力在服务器端运行；本机文件选择、Deep Link、本机 CLI Agent 和桌面版定时数据库备份不属于 Web 运行方式。
|
||
</Callout>
|
||
|
||
## 可选的服务器方案
|
||
|
||
如果你还没有用于部署 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 拉取镜像并启动容器。
|
||
|
||
<Callout type="info">
|
||
访问密码不是数据库密码，而是 DBX Web 版的登录密码。请保存安装时设置或生成的密码。
|
||
</Callout>
|
||
|
||
## 访问 DBX
|
||
|
||
安装完成后，在浏览器中打开：
|
||
|
||
```text
|
||
http://服务器 IP:端口
|
||
```
|
||
|
||
例如端口保持默认值时：
|
||
|
||
```text
|
||
http://192.168.1.100:4224
|
||
```
|
||
|
||
在登录页面输入安装时设置的 **访问密码**。如果无法访问，请依次检查：
|
||
|
||
- 1Panel 中 DBX 应用是否显示为运行中；
|
||
- 浏览器地址中的端口是否与安装表单中的端口一致；
|
||
- 云服务器安全组和系统防火墙是否允许该端口；
|
||
- 端口是否被其他服务占用。
|
||
|
||
## 持久化与更新
|
||
|
||
DBX 的应用数据保存在 1Panel 应用目录的 `data` 目录，并挂载到容器内的 `/app/data`。这里包含 DBX 自身的存储数据库、已保存连接、插件、驱动和其他持久化状态。重启容器或更新 DBX 时，只要挂载目录未被删除，这些数据就会继续保留。
|
||
|
||
更新时，在 1Panel 的 **已安装** 应用中打开 DBX，选择可用的新版本并执行更新。更新前建议先确认数据目录已经纳入服务器备份。
|
||
|
||
<Callout type="warn">
|
||
不要直接删除 DBX 的应用数据目录，否则会同时删除已保存的连接配置和其他本地数据。卸载应用前请先完成备份。
|
||
</Callout>
|
||
|
||
<Callout type="warning">
|
||
备份 `/app/data` 只保护 DBX 的应用配置和运行数据，不会备份 MySQL、PostgreSQL 等目标数据库中的业务数据。Web 版不提供桌面版的定时数据库备份任务；业务数据库仍应使用数据库原生备份、云服务快照或独立备份系统。
|
||
</Callout>
|
||
|
||
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)。
|
||
|
||
<Callout type="info">
|
||
`4224` 是 DBX Web 服务端口，不是目标数据库端口。连接数据库时仍需填写 MySQL、PostgreSQL、Redis 等目标数据库自身的端口。
|
||
</Callout>
|
||
|
||
## 生产部署建议
|
||
|
||
- 使用足够长且唯一的访问密码，不要保留示例值；
|
||
- 通过 1Panel 反向代理配置 HTTPS，并限制安全组和主机防火墙暴露范围；
|
||
- 需要受控升级时固定版本，更新前备份 `/app/data` 并阅读[更新日志](/cn/changelog)；
|
||
- 为 DBX 使用独立、最小权限的数据库账号，生产连接优先启用只读保护；
|
||
- 定期检查驱动和插件来源，不要把不受信任的 JAR 或可执行文件放入数据目录。
|
||
|
||
更多连接、写入、AI 和 API 边界见[生产安全](/cn/docs/production-safety)。
|
||
|
||
<Cards>
|
||
<Card title="驱动管理" href="/cn/docs/driver-management">
|
||
安装 Web 版需要的 DuckDB、JDBC 和 Agent 驱动，并查看运行状态。
|
||
</Card>
|
||
<Card title="数据库备份" href="/cn/docs/database-backup">
|
||
了解桌面版定时备份的支持范围，以及 Web 部署为什么需要外部备份方案。
|
||
</Card>
|
||
</Cards>
|