Files
appstore/apps/questdb
okxlin 1e4682f7e0 refactor: minimize app lifecycle scripts
Keep new LiteLLM installs script-free while preserving legacy cached keys during upgrades. Simplify QuestDB and Directus initialization to the path, permission, and credential compatibility behavior proven necessary by real 1Panel install and upgrade tests.
2026-07-16 01:32:39 +08:00
..
2026-07-15 04:02:01 +08:00
2026-07-15 04:02:01 +08:00

QuestDB

产品介绍

QuestDB 是一个面向实时分析的开源时序数据库,提供高吞吐写入、低延迟 SQL 查询、Web Console、REST API、InfluxDB Line Protocol 和 PostgreSQL Wire Protocol。

主要功能

  • 面向时序数据的列式存储、WAL 和分区管理
  • Web Console、REST API 与 SQL 查询
  • 通过 HTTP 接收 InfluxDB Line Protocol 数据
  • 兼容 PostgreSQL Wire Protocol 的查询接口
  • 快照、检查点和持久化数据目录

访问说明

  • Web Console、REST API 和 ILP-over-HTTP 共用默认端口 9000
  • PostgreSQL Wire Protocol 默认使用端口 8812,数据库名为 qdb
  • 本应用默认启用 HTTP Basic 认证和 PGWire 密码认证,两个接口使用独立用户名与密码。
  • QuestDB 的 ILP TCP 端口 9009 默认不提供简单的用户名/密码保护。本应用为减少未认证写入面,默认关闭且不发布该端口;常见写入场景可直接使用已受 HTTP Basic 保护的 ILP-over-HTTP。
  • 内部 9003 端口仅用于容器健康检查,不发布到宿主机。健康状态端点不要求业务凭据,其他 HTTP 接口仍受 Basic 认证保护。

数据与安全

  • QuestDB 的完整数据根目录持久化到安装表单选择的数据目录,其中包含 dbconfpublic、快照和检查点等运行数据。
  • HTTP 与 PGWire 密码由 1Panel 安装表单随机生成。安装脚本仅把面板值缓存到 .questdb_http_password.questdb_pg_password,并在升级时恢复原值,避免 1Panel 回放安装参数造成凭据轮换。
  • 官方镜像入口以 root 启动,用于检查数据目录属主,然后以 UID/GID 10001:10001 运行 QuestDB。首次挂载既有数据目录时,上游入口可能调整其已知数据子目录的属主;迁移前应先备份并核对权限。
  • Web Console 和协议端口本身不提供 HTTPS。对外访问时应使用 HTTPS 反向代理、限制端口来源,并按需配置网络层 TLS。
  • 默认关闭匿名遥测,可在安装表单中按需开启。

升级说明

  • 升级前停止写入并完整备份数据目录及两个密码缓存文件。
  • 固定版与 latest 使用相同的数据路径和配置键,可通过 1Panel 执行跨版本升级。
  • 数据格式迁移可能在启动阶段完成。生产数据应先在副本环境验证目标版本,并在升级过程中等待健康检查通过后再恢复流量。

Introduction

QuestDB is an open-source time-series database for high-throughput ingestion and low-latency SQL analytics. This package exposes the authenticated Web/REST/ILP-over-HTTP endpoint and PGWire endpoint, while disabling unauthenticated ILP TCP by default.

Back up the full data directory, .questdb_http_password and .questdb_pg_password before upgrades. Public deployments should place the Web endpoint behind HTTPS and restrict direct access to the database ports.

Features

  • Column-oriented time-series storage, WAL and partition management
  • Web Console, REST API and SQL queries
  • Authenticated InfluxDB Line Protocol over HTTP
  • PostgreSQL Wire Protocol compatibility
  • Persistent checkpoints and snapshots

参考资料