Electric:PostgreSQL 同步引擎

使用 Pigsty v4.2 自建 Electric,同步 PostgreSQL 数据到前端应用,支持部分复制与实时分发。

Electric 是 PostgreSQL 同步引擎,专注于将数据库变更高效分发到前端/边缘应用。

Pigsty 在 v4.2 提供了 app/electric 配置模板(conf/app/electric.yml),可一键完成数据库、容器与入口配置。

快速开始

curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty
./bootstrap
./configure -c app/electric
vi pigsty.yml                 # 修改域名、密码、密钥
./deploy.yml
./docker.yml
./app.yml

默认访问地址:

  • http://<IP>:8002
  • http://elec.pigsty(按模板默认域名)

指标端口默认 8003ELECTRIC_PROMETHEUS_PORT)。

关键配置

conf/app/electric.yml 会在 apps.electric.conf 中覆盖 /opt/electric/.env。常见参数:

  • DATABASE_URL:Electric 使用的 PostgreSQL 连接串(需要复制权限)
  • ELECTRIC_PORT:Electric HTTP 服务端口(默认 8002
  • ELECTRIC_PROMETHEUS_PORT:指标端口(默认 8003
  • ELECTRIC_INSECURE:开发环境可设为 true,生产环境建议关闭并使用密钥

运维命令

cd /opt/electric
make up
make logs
make down

参考


最后修改 2026-02-19: batch doc update (81d5b4a)