Duckgres 是一个由 PostHog 开源的数据库服务器项目,它实现了 PostgreSQL 网络协议(Wire Protocol),同时底层使用 DuckDB 作为查询执行引擎。

Duckgres 采用 Go 语言开发,遵循 MIT 开源协议,代码托管在 GitHub:
https://github.com/PostHog/duckgres
功能特性
- PostgreSQL 协议兼容:Duckgres 实现了完整的 PostgreSQL 网络协议,因此可以使用 psql、pgAdmin、lib/pq、psycopg2 等客户端直接连接,支持各种 PostgreSQL 语法,包括简单查询、扩展查询(预编译语句等)、COPY FROM / TO 命令、系统视图、系统函数等。
- DuckDB 执行引擎:实际 SQL 语句的执行由 DuckDB 完成,可以利用 DuckDB 的列式存储、向量化执行(vectorized execution)、高效扫描与聚合等。
- 连接与安全:强制使用 TLS 加密连接,保护明文密码认证;每个用户使用独立的 DuckDB 数据库文件进行隔离;内置连接限流、登录失败封禁、优雅停机(graceful shutdown)等运维友好功能。
- DuckDB 扩展:支持 DuckDB 扩展加载(默认启用 DuckLake),可以将 DuckDB 作为 Lakehouse 查询层,访问对象存储(S3、GCS、MinIO 等)。
- 运行模式:Duckgres 支持多种部署方式,包括适合本地开发的单进程模式(Standalone),适合生产环境的多进程模式(Control Plane),以及云原生模式(Remote Worker)。

- 灵活配置:Duckgres 支持多种配置方式,优先级从高到低依次为命令行参数、环境变量、YAML 文件。
- 可观测性:内置 Prometheus Metrics,方便系统监控;常见指标包括当前连接数、查询耗时直方图、错误计数、鉴权失败次数等。
下载安装
使用 Docker 快速体验的命令如下:
bash
git clone https://github.com/PostHog/duckgres.git
cd duckgres
docker build -t duckgres:dev .
docker run --rm \
-p 5432:5432 -p 9090:9090 \
-v ./duckgres.yaml:/app/duckgres.yaml \
-v ./data:/app/data \
duckgres:dev
其中 5432 客户端连接端口,9090 是监控指标。
总结
Duckgres 能够让 PostgreSQL 生态直接使用 DuckDB 的高性能分析能力和灵活性。