Pigsty PostgreSQL 企业级部署方案

1. 概述

Pigsty 是开源免费的 PostgreSQL 发行版，10 分钟部署企业级数据库，成本仅为云 RDS 的 1/10。

官网：https://pigsty.cc / 版本：v3.4

适用场景：B2B2B 平台主数据库、预算有限需要高可用、需要丰富 PG 扩展、AI Agent 自动运维。

2. 架构设计

2.1 单节点 MVP

一台 8C16G 云服务器跑全部组件。

2.2 高可用生产

3 节点：Primary(Node1 8C16G) + Replica(Node2 8C16G) + etcd/PgBouncer/HAProxy(Node3 4C8G)，Patroni 自动故障切换。

3. 安装

3.1 环境准备

操作系统：Debian 12 / Ubuntu 22.04 / Rocky 9

sudo setenforce 0
sudo systemctl disable --now firewalld
sudo apt install -y curl wget sshpass python3

3.2 单节点安装

curl https://pigsty.cc/install | bash

cat > ~/pigsty.yml << 'EOF'
node_dedicated: true
node_tune: tiny
pg_cluster:
  - name: pg-b2b2b
    scope: b2b2b
    roles:
      - name: pg
        ip: 127.0.0.1
pg_default_conf:
  - max_connections: 200
  - shared_buffers: 4GB
  - effective_cache_size: 12GB
  - work_mem: 64MB
  - maintenance_work_mem: 512MB
  - wal_level: replica
  - random_page_cost: 1.1
  - effective_io_concurrency: 200
EOF

./node.yml && ./pgsql.yml && ./infra.yml

安装后：PG localhost:5432 / PgBouncer localhost:6432 / Grafana http://IP:3000

3.3 高可用安装

pigsty.yml 添加多节点 roles 定义，指定 patroni_role: replica 和 replication_access: true，然后执行 node.yml + pgsql.yml + infra.yml。

4. 监控

内置 Prometheus + Grafana，看板：PG Overview / PG Stat Activity / PG Table / PG Log / PG Replication。

关键指标：

5. 备份与恢复

pgBackRest：每周日全量(保留4周) + 每日差异(保留7天) + WAL 持续归档(保留7天)，AES-256 加密。

pgbackrest --stanza=b2b2b info
pgbackrest --stanza=b2b2b --type=full restore
pgbackrest --stanza=b2b2b --type=time --target="2026-04-15 10:30:00" restore

6. 迁移

7. 性能调优

PG 参数 8C16G

shared_buffers = '4GB'
effective_cache_size = '12GB'
work_mem = '64MB'
maintenance_work_mem = '512MB'
wal_level = 'replica'
max_wal_senders = 10
max_connections = 200
max_worker_processes = 8
max_parallel_workers_per_gather = 4
random_page_cost = 1.1
effective_io_concurrency = 200
autovacuum_max_workers = 4
autovacuum_vacuum_scale_factor = 0.02
log_min_duration_statement = '500ms'
log_lock_waits = on

PgBouncer

[pgbouncer]
pool_mode = transaction
max_client_conn = 1000
default_pool_size = 50
reserve_pool_size = 10
query_timeout = 30

8. 安全

• SSL/TLS：默认启用 CA 签发证书
• pg_hba.conf：白名单只允许应用网段
• pgaudit：记录 DDL 和写操作

shared_preload_libraries = 'pgaudit,pg_stat_statements'
pgaudit.log = 'write,ddl'

角色分离：app_readonly（SELECT）、app_readwrite（CRUD）、app_admin（ALL）。

9. 扩展插件