主题

srebro2026-09-04

DBX：可 Web 访问的自托管数据库管理工具 ​

一、简介 ​

DBX 是一个轻量级的数据库管理工具，支持自托管部署，可通过浏览器访问。支持 60+ 种数据库类型，包括但不限于：

  • MySQL
  • MariaDB
  • PostgreSQL
  • SQLite
  • Redis
  • MongoDB
  • ClickHouse
  • Oracle
  • SQL Server
  • Elasticsearch
  • DuckDB
  • Cassandra
  • Apache Doris
  • TiDB
  • OpenSearch
  • InfluxDB

DBX 提供：

  • Web 图形化管理界面
  • SQL 编辑器
  • 数据库连接管理
  • 多数据库支持
  • Docker 部署
  • ARM64 与 AMD64 双平台支持
  • 数据持久化存储
  • 支持反向代理部署
  • 支持路径转发（Base Path）

二、环境要求 ​

2.1 Docker ​

建议版本：

bash
Docker >= 24.x

查看 Docker 版本：

bash
docker --version

查看 Docker Compose 版本：

bash
docker compose version

三、端口说明 ​

服务默认端口
DBX Web4224

默认访问地址：

bash
http://服务器IP:4224

四、Docker Compose 部署 ​

创建目录：

bash
mkdir -p /opt/dbx

创建配置文件：

bash
vim docker-compose.yml

写入以下内容：

yaml
services:
  dbx:
    image: docker.cnb.cool/dbxio.com/dbx:latest
    container_name: dbx
    pull_policy: always

    ports:
      - "4224:4224"

    environment:
      DBX_PASSWORD: "ChangeMe123!"

    volumes:
      - /home/application/database/dbx:/app/data

    restart: unless-stopped

启动服务：

bash
docker compose up -d

查看容器状态：

bash
docker ps

查看日志：

bash
docker logs -f dbx

五、访问方式 ​

浏览器访问：

bash
http://服务器IP:4224

输入部署时设置的密码即可登录：

bash
DBX_PASSWORD

例如：

bash
用户名：无需填写
密码：ChangeMe123!

六、数据持久化 ​

DBX 所有数据默认存储于：

bash
/app/data

建议映射到宿主机目录：

bash
/home/application/database/dbx

目录中主要保存：

  • 数据库连接信息
  • 驱动文件
  • 插件
  • 应用配置
  • 用户数据

删除该目录会导致所有配置丢失。

七、环境变量说明 ​

环境变量默认值说明
DBX_PASSWORD无登录密码
DBX_DISABLE_PASSWORDfalse是否关闭密码认证
DBX_DATA_DIR/app/data数据目录
DBX_PORT4224容器内部端口
DBX_PUBLIC_BASE_PATH/URL 路径前缀

八、关闭密码认证（不推荐） ​

如果仅在内网环境使用，可以关闭登录认证：

yaml
environment:
  DBX_DISABLE_PASSWORD: "true"

或：

bash
-e DBX_DISABLE_PASSWORD=true

WARNING

不建议在公网环境关闭密码认证。

最近更新