进阶 questdb.com 2026-10-13 06:17:07 · 43 阅读
第13章 使用 Docker 部署 QuestDB
使用 Docker 部署 QuestDB
QuestDB 在 Docker Hub 上提供了适用于 Linux/macOS 和 Windows 的镜像。
安装 Docker
首先,请安装 Docker。你可以参考官方文档查找对应平台的安装指南。
运行 QuestDB 镜像
安装好 Docker 后,你需要从 Docker Hub 拉取 QuestDB 镜像并创建容器。
通过以下单条命令即可完成:
docker run \
-p 9000:9000 -p 9009:9009 -p 8812:8812 -p 9003:9003 \
questdb/questdb:10.0.1
该命令启动了基于 questdb/questdb 镜像的 Docker 容器,并开放部分端口以便你探索 QuestDB。 为了配置 QuestDB,建议挂载卷以实现数据持久化。只需在上方命令中添加 -v 参数: -v "/host/volume/location:/var/lib/questdb"
下面详细描述各个参数。 -p 参数用于映射端口 该参数将端口映射到宿主机。你可以指定: -p 9000:9000 - REST API 和 Web 控制台 -p 9009:9009 - InfluxDB 行协议 -p 8812:8812 - Postgres 线协议 -p 9003:9003 - 最小健康服务器 所有端口均为可选,你只需选择所需的端口。例如,如果仅计划使用 Postgres 线协议,开放 8812 端口即可。 -v 参数用于挂载存储 该参数使本地目录对 QuestDB Docker 容器可用。它会包含所有摄入 QuestDB 的数据、服务器日志和配置。 容器内 QuestDB 的 root_directory 位于 /var/lib/questdb 路径。 Docker 镜像版本 默认情况下,questdb/questdb 指向 Docker 上可用的最新 QuestDB 版本。但建议指定使用的版本。 questdb/questdb:10.0.1
环境变量 在 Docker 中运行时,可以通过 -e 标志向容器传递环境变量来配置 QuestDB 服务器: docker run -p 4000:4000 -e QDB_HTTP_BIND_TO=0.0.0.0:4000 questdb/questdb
配置选项列表参见 配置。 容器状态 你可以使用 docker ps 检查容器状态。 它还列出了映射的端口、容器名称、运行时长等: 使用 docker ps 查找容器状态docker ps
docker ps 的结果CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
dd363939f261 questdb/questdb "/app/bin/java -m io…" 3 seconds ago Up 2 seconds 8812/tcp, 9000/tcp frosty_gauss
这个容器: ID 为 dd363939f261 使用 8812 和 9000 端口,分别对应 Postgres wire protocol 和 HTTP 基于 questdb/questdb 镜像 通过运行 java 启动二进制文件 创建时间:3 秒前 运行时长:2 秒 名字是 frosty_gauss 有关容器状态的完整信息,请参考 docker ps 文档。 调试容器日志 Docker 可能会生成运行时错误。报错信息可能并不准确,真正的错误源头通常位于日志的更上方。 要查看完整日志,请使用 docker ps 获取 UUID(即 CONTAINER ID): 查找 CONTAINER IDCONTAINER ID IMAGE ...
dd363939f261 questdb/questdb ...
然后将 CONTAINER ID(即 dd363939f261)作为参数传递给 docker logs 命令: 从 CONTAINER ID 生成 docker 日志$ docker logs dd363939f261
No arguments found, start with default arguments
Running as questdb user
Log configuration loaded from: /var/lib/questdb/conf/log.conf
...
...
注意,默认情况下日志会从 /var/lib/questdb/conf/log.conf 拉取。在寻求 Docker 部署支持时,共享此日志有助于我们定位根本原因。 导入数据和发送查询 当 QuestDB 运行起来后,你可以通过以下端口开始交互: 9000 端口用于 REST,更多信息见 REST 文档页。 8812 端口用于 Postgres,请查阅 Postgres 参考页。 9009 端口专为 InfluxDB Line Protocol 设计,请查阅 InfluxDB 协议页。 数据持久化 挂载卷 可以将卷挂载到 QuestDB Docker 容器中,以持久化数据或将服务器配置传递给实例。以下示例展示了如何在 Docker run 命令中使用 -v 标志将当前目录挂载到 QuestDB 容器: 挂载卷docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
-v "$(pwd):/var/lib/questdb" \
questdb/questdb:10.0.1
此时,当前目录中的数据会被持久化到磁盘,方便迁移或备份: 当前目录内容├── conf
│ └── server.conf
├── db
├── log
├── public
└── snapshot (optional)
你也可以通过挂载本地目录到 QuestDB 容器来提供服务器配置文件。假设有一个覆盖了默认 HTTP bind 属性的配置文件: ./server.confhttp.bind.to=0.0.0.0:4000
使用 -v 参数运行容器,可以把当前目录挂载到容器内 QuestDB 的 conf 目录。配置好上面的 server.conf 后,Web Console 和 REST API 的 HTTP 端口即可通过 http://localhost:4000 访问: docker run -v "$(pwd):/var/lib/questdb/conf" -p 4000:4000 questdb/questdb
注意:如果要在 Docker 中使用 ZFS 部署 QuestDB,需要在 Docker 所用宿主机卷上启用 ZFS。更多信息请参阅 Docker 官方文档。 升级 QuestDB 版本 只要挂载了卷以实现数据持久化,就可以在 Docker 上升级 QuestDB 实例。 注意 请先查看 release notes,并确认必要的备份已完成。 只有原实例挂载了卷才能进行升级。如果原实例没有挂载卷,以下步骤会创建一个新实例,旧实例中的数据将无法找回。 运行 docker ps 获取容器名称或 ID: 容器状态
# 现有 QuestDB 版本为 6.5.2:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
dd363939f261 questdb/questdb:6.5.2 "/app/bin/java -m io…" 3 seconds ago Up 2 seconds 8812/tcp, 9000/tcp frosty_gauss
停止实例并删除容器: docker stop dd363939f261
docker rm dd363939f261
拉取最新版 QuestDB 镜像: docker pull questdb/questdb:10.0.1
用新版本启动新容器,并挂载原来的卷: docker run -p 8812:8812 -p 9000:9000 -v "$(pwd):/var/lib/questdb" questdb/questdb:10.0.1
将日志写入磁盘 向 Docker 容器挂载卷时,可以在容器的 /conf/log.conf 路径下提供日志配置文件: 当前目录内容└── conf
├── log.conf
└── server.conf
例如,可以创建一个包含以下内容的文件: ./conf/log.conf# list of configured writers
writers=file,stdout,http.min
# file writer
w.file.class=io.questdb.log.LogFileWriter
w.file.location=questdb-docker.log
w.file.level=INFO,ERROR,DEBUG
# stdout
w.stdout.class=io.questdb.log.LogConsoleWriter
w.stdout.level=INFO
# min http server, used monitoring
w.http.min.class=io.questdb.log.LogConsoleWriter
w.http.min.level=ERROR
w.http.min.scope=http-min-server
当前目录可以挂载到 QuestDB 容器中: 将当前目录挂载到 QuestDB 容器 docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
-v "$(pwd):/root/.questdb/" questdb/questdb
容器日志会根据 conf/log.conf 文件中指定的日志级别和文件名写入磁盘,在本例中写入 ./questdb-docker.log: 当前目录树 ├── conf
│ ├── log.conf
│ └── server.conf
├── db
│ ├── table1
│ └── table2
├── public
│ ├── ui / assets
│ ├── ...
│ └── version.txt
└── questdb-docker.log
有关日志配置的更多信息,请参阅配置参考文档。 重启现有容器 运行以下命令可为 QuestDB 镜像创建一个新的容器: docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
questdb/questdb
通过 --name container_name 参数为容器命名,后续即可方便地引用该容器: docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
--name docker_questdb \
questdb/questdb
若需在容器停止后复用其数据,可使用以下命令: # 启动容器
docker start docker_questdb
# 停止容器
docker stop docker_questdb
或者,使用容器 ID 重启: 通过容器 ID 启动容器 docker start dd363939f261
-p 9000:9000 -p 9009:9009 -p 8812:8812 -p 9003:9003 \
questdb/questdb:10.0.1
该命令启动了基于 questdb/questdb 镜像的 Docker 容器,并开放部分端口以便你探索 QuestDB。 为了配置 QuestDB,建议挂载卷以实现数据持久化。只需在上方命令中添加 -v 参数: -v "/host/volume/location:/var/lib/questdb"
下面详细描述各个参数。 -p 参数用于映射端口 该参数将端口映射到宿主机。你可以指定: -p 9000:9000 - REST API 和 Web 控制台 -p 9009:9009 - InfluxDB 行协议 -p 8812:8812 - Postgres 线协议 -p 9003:9003 - 最小健康服务器 所有端口均为可选,你只需选择所需的端口。例如,如果仅计划使用 Postgres 线协议,开放 8812 端口即可。 -v 参数用于挂载存储 该参数使本地目录对 QuestDB Docker 容器可用。它会包含所有摄入 QuestDB 的数据、服务器日志和配置。 容器内 QuestDB 的 root_directory 位于 /var/lib/questdb 路径。 Docker 镜像版本 默认情况下,questdb/questdb 指向 Docker 上可用的最新 QuestDB 版本。但建议指定使用的版本。 questdb/questdb:10.0.1
环境变量 在 Docker 中运行时,可以通过 -e 标志向容器传递环境变量来配置 QuestDB 服务器: docker run -p 4000:4000 -e QDB_HTTP_BIND_TO=0.0.0.0:4000 questdb/questdb
配置选项列表参见 配置。 容器状态 你可以使用 docker ps 检查容器状态。 它还列出了映射的端口、容器名称、运行时长等: 使用 docker ps 查找容器状态docker ps
docker ps 的结果CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
dd363939f261 questdb/questdb "/app/bin/java -m io…" 3 seconds ago Up 2 seconds 8812/tcp, 9000/tcp frosty_gauss
这个容器: ID 为 dd363939f261 使用 8812 和 9000 端口,分别对应 Postgres wire protocol 和 HTTP 基于 questdb/questdb 镜像 通过运行 java 启动二进制文件 创建时间:3 秒前 运行时长:2 秒 名字是 frosty_gauss 有关容器状态的完整信息,请参考 docker ps 文档。 调试容器日志 Docker 可能会生成运行时错误。报错信息可能并不准确,真正的错误源头通常位于日志的更上方。 要查看完整日志,请使用 docker ps 获取 UUID(即 CONTAINER ID): 查找 CONTAINER IDCONTAINER ID IMAGE ...
dd363939f261 questdb/questdb ...
然后将 CONTAINER ID(即 dd363939f261)作为参数传递给 docker logs 命令: 从 CONTAINER ID 生成 docker 日志$ docker logs dd363939f261
No arguments found, start with default arguments
Running as questdb user
Log configuration loaded from: /var/lib/questdb/conf/log.conf
...
...
注意,默认情况下日志会从 /var/lib/questdb/conf/log.conf 拉取。在寻求 Docker 部署支持时,共享此日志有助于我们定位根本原因。 导入数据和发送查询 当 QuestDB 运行起来后,你可以通过以下端口开始交互: 9000 端口用于 REST,更多信息见 REST 文档页。 8812 端口用于 Postgres,请查阅 Postgres 参考页。 9009 端口专为 InfluxDB Line Protocol 设计,请查阅 InfluxDB 协议页。 数据持久化 挂载卷 可以将卷挂载到 QuestDB Docker 容器中,以持久化数据或将服务器配置传递给实例。以下示例展示了如何在 Docker run 命令中使用 -v 标志将当前目录挂载到 QuestDB 容器: 挂载卷docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
-v "$(pwd):/var/lib/questdb" \
questdb/questdb:10.0.1
此时,当前目录中的数据会被持久化到磁盘,方便迁移或备份: 当前目录内容├── conf
│ └── server.conf
├── db
├── log
├── public
└── snapshot (optional)
你也可以通过挂载本地目录到 QuestDB 容器来提供服务器配置文件。假设有一个覆盖了默认 HTTP bind 属性的配置文件: ./server.confhttp.bind.to=0.0.0.0:4000
使用 -v 参数运行容器,可以把当前目录挂载到容器内 QuestDB 的 conf 目录。配置好上面的 server.conf 后,Web Console 和 REST API 的 HTTP 端口即可通过 http://localhost:4000 访问: docker run -v "$(pwd):/var/lib/questdb/conf" -p 4000:4000 questdb/questdb
注意:如果要在 Docker 中使用 ZFS 部署 QuestDB,需要在 Docker 所用宿主机卷上启用 ZFS。更多信息请参阅 Docker 官方文档。 升级 QuestDB 版本 只要挂载了卷以实现数据持久化,就可以在 Docker 上升级 QuestDB 实例。 注意 请先查看 release notes,并确认必要的备份已完成。 只有原实例挂载了卷才能进行升级。如果原实例没有挂载卷,以下步骤会创建一个新实例,旧实例中的数据将无法找回。 运行 docker ps 获取容器名称或 ID: 容器状态
# 现有 QuestDB 版本为 6.5.2:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
dd363939f261 questdb/questdb:6.5.2 "/app/bin/java -m io…" 3 seconds ago Up 2 seconds 8812/tcp, 9000/tcp frosty_gauss
停止实例并删除容器: docker stop dd363939f261
docker rm dd363939f261
拉取最新版 QuestDB 镜像: docker pull questdb/questdb:10.0.1
用新版本启动新容器,并挂载原来的卷: docker run -p 8812:8812 -p 9000:9000 -v "$(pwd):/var/lib/questdb" questdb/questdb:10.0.1
将日志写入磁盘 向 Docker 容器挂载卷时,可以在容器的 /conf/log.conf 路径下提供日志配置文件: 当前目录内容└── conf
├── log.conf
└── server.conf
例如,可以创建一个包含以下内容的文件: ./conf/log.conf# list of configured writers
writers=file,stdout,http.min
# file writer
w.file.class=io.questdb.log.LogFileWriter
w.file.location=questdb-docker.log
w.file.level=INFO,ERROR,DEBUG
# stdout
w.stdout.class=io.questdb.log.LogConsoleWriter
w.stdout.level=INFO
# min http server, used monitoring
w.http.min.class=io.questdb.log.LogConsoleWriter
w.http.min.level=ERROR
w.http.min.scope=http-min-server
当前目录可以挂载到 QuestDB 容器中: 将当前目录挂载到 QuestDB 容器 docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
-v "$(pwd):/root/.questdb/" questdb/questdb
容器日志会根据 conf/log.conf 文件中指定的日志级别和文件名写入磁盘,在本例中写入 ./questdb-docker.log: 当前目录树 ├── conf
│ ├── log.conf
│ └── server.conf
├── db
│ ├── table1
│ └── table2
├── public
│ ├── ui / assets
│ ├── ...
│ └── version.txt
└── questdb-docker.log
有关日志配置的更多信息,请参阅配置参考文档。 重启现有容器 运行以下命令可为 QuestDB 镜像创建一个新的容器: docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
questdb/questdb
通过 --name container_name 参数为容器命名,后续即可方便地引用该容器: docker run -p 9000:9000 \
-p 9009:9009 \
-p 8812:8812 \
-p 9003:9003 \
--name docker_questdb \
questdb/questdb
若需在容器停止后复用其数据,可使用以下命令: # 启动容器
docker start docker_questdb
# 停止容器
docker stop docker_questdb
或者,使用容器 ID 重启: 通过容器 ID 启动容器 docker start dd363939f261