配置模板
使用预制的配置模板,快速生成适配当前环境的配置文件
在 Pigsty 中,部署的蓝图细节由 配置清单 所定义,也就是 pigsty.yml 配置文件,您可以通过声明式配置进行定制。
然而,直接编写配置文件可能会让新用户望而生畏。为此,我们提供了一些开箱即用的配置模板,涵盖了常见的使用场景。
每一个模板都是一个预定义的 pigsty.yml 配置文件,包含了适用于特定场景的合理默认值。
您可以根据自己的需要,选择一个模板作为定制起点,然后根据需要进行修改,以满足您的具体需求。
使用模板
Pigsty 提供了 configure 脚本作为可选的配置向导,它将根据您的环境和输入,生成具有良好默认值的 配置清单。
使用 ./configure -c <conf> 指定配置模板,其中 <conf> 可以是相对于 conf/ 目录的路径(省略 .yml 后缀),也可以直接使用裸名称(按 conf/ → ha/ → fork/ → app/ → demo/ → build/ 顺序查找):
如果不指定模板,Pigsty 默认使用 meta.yml 单节点配置模板。
模板列表
主要模板
以下是单节点配置模板,可用于在单台服务器上安装 Pigsty:
| 模板 | 说明 |
|---|---|
meta.yml | 默认模板,单节点 PostgreSQL 在线安装 |
rich.yml | 富功能模板,包含本地软件源、Silo 及更多示例 |
slim.yml | 精简模板,仅安装 PostgreSQL,不含监控与基础设施 |
数据库内核模板
适用于各类数据库管理系统与内核的模板:
| 模板 | 说明 |
|---|---|
fork/pgsql.yml | 原生 PostgreSQL 内核,基础功能 (14~18) |
pg19.yml | PostgreSQL 19 Beta 专用试用模板 |
fork/mssql.yml | Babelfish 内核,兼容 SQL Server 协议 (17/18) |
fork/polar.yml | PolarDB PG 内核,Aurora/RAC 风格 (17) |
fork/ivory.yml | IvorySQL 内核,兼容 Oracle 语法 (18) |
fork/halo.yml | OpenHalo 内核,兼容 MySQL 协议 (14) |
fork/pgtde.yml | Percona PostgreSQL Server 透明加密 (18) |
fork/oriole.yml | OrioleDB 内核,OLTP 增强 (16~18) |
fork/agens.yml | AgensGraph 图数据库内核 (18) |
fork/pgedge.yml | pgEdge 分布式数据库内核 (15~18,默认 18) |
fork/mongo.yml | FerretDB / MongoDB 协议兼容示例 |
supabase.yml | Supabase 自托管配置 (15~18) |
您可以后续添加更多节点,或使用 高可用模板 在一开始就规划好集群。
高可用模板
您可以配置 Pigsty 在多节点上运行,组成高可用(HA)集群:
| 模板 | 说明 |
|---|---|
ha/dual.yml | 2 节点半高可用部署 |
ha/trio.yml | 3 节点标准高可用部署 |
ha/full.yml | 4 节点标准部署 |
ha/safe.yml | 3 节点安全增强部署,含离线查询从库 |
ha/octo.yml | 8 节点紧凑高可用仿真 |
ha/simu.yml | 20 节点生产环境模拟 |
ha/citus.yml | Citus 分布式高可用 PostgreSQL (14~18) |
应用模板
您可以使用以下模板运行 Docker 应用/软件:
| 模板 | 说明 |
|---|---|
supabase.yml | 启动单节点 Supabase |
app/supa.yml | 启动精简版 Supabase 应用栈 |
app/odoo.yml | 启动 Odoo ERP 系统 |
app/dify.yml | 启动 Dify AI 工作流系统 |
app/electric.yml | 启动 Electric 同步引擎 |
app/insforge.yml | 启动 Insforge 后端平台 |
app/hindsight.yml | 启动 Hindsight 应用 |
app/mattermost.yml | 启动 Mattermost 协作平台 |
app/teable.yml | 启动 Teable 表格数据库 |
app/maybe.yml | 启动 Maybe 财务应用 |
app/registry.yml | 启动 Docker Registry |
app/immich.yml | 启动 Immich 相册管理应用 |
app/jumpserver.yml | 启动 JumpServer 堡垒机 |
app/discourse.yml | 启动 Discourse 社区论坛 |
app/silo.yml | 启动独立的 Silo 对象存储应用 |
演示模板
除主要模板外,Pigsty 还提供了一组面向不同场景的演示模板:
| 模板 | 说明 |
|---|---|
demo/bare.yml | 最小化的单节点起步配置 |
demo/el.yml | EL 9/10 系统的全参数配置文件 |
demo/debian.yml | Debian/Ubuntu 系统的全参数配置文件 |
demo/remote.yml | 监控远程 PostgreSQL 集群或 RDS 的示例配置 |
demo/redis.yml | Redis 集群示例配置 |
demo/minio.yml | 4 节点 Silo 多盘集群示例 |
demo/kafka.yml | 单节点开发集群 + 三节点安全集群的 Kafka dynamic KRaft 示例 |
demo/mysql.yml | 原生 MySQL 8.4 单节点/三节点试点示例(区别于 OpenHalo fork/halo.yml) |
demo/kernel.yml | 10 节点内核矩阵演示配置 |
demo/saas.yml | 含全部扩展的富功能单节点模板 |
demo/wool.yml | 低成本阿里云 ECS 演示模板 |
demo/demo.yml | Pigsty 公开演示站 的配置文件 |
fat.yml | 含本地软件源与完整功能的单节点配置文件 |
infra.yml | 仅部署基础设施模块 |
vibe.yml | Vibe Coding / AI 应用开发模板 |
docker.yml | Docker 应用宿主模板 |
构建模板
以下配置模板用于软件包构建与跨发行版测试目的:
| 模板 | 说明 |
|---|---|
build/oss.yml | EL 9/10、Debian 12/13、Ubuntu 22.04/24.04/26.04 开源构建配置 |
build/dev.yml | 7 节点跨发行版本地开发测试构建配置 |
这个页面对您有帮助吗?
感谢反馈,我们会据此改进这篇文档。
哪里没有解决?(可选)