Electric:PostgreSQL 同步引擎
使用 Pigsty 自建 Electric,同步 PostgreSQL 数据到前端应用,支持部分复制与实时分发。
Electric 是 PostgreSQL 同步引擎,专注于将数据库变更高效分发到前端/边缘应用。
Pigsty 提供 app/electric 配置模板(conf/app/electric.yml),用于配置数据库、容器与访问入口。
快速开始
默认访问地址:
http://<IP>:8002http://elec.pigsty(按模板默认域名)
Prometheus 指标端点默认关闭且未发布端口。除非已配置定期抓取,否则不要启用 ELECTRIC_PROMETHEUS_PORT:启用但未被抓取的 reporter 会持续保留指标,最终可能耗尽内存。
关键配置
conf/app/electric.yml 会在 apps.electric.conf 中覆盖 /opt/electric/.env。常见参数:
DATABASE_URL:Electric 使用的 PostgreSQL 连接串(需要REPLICATION权限)ELECTRIC_PORT:容器内监听端口,默认3000ELECTRIC_PUBLISH_PORT:宿主机发布端口,默认8002ELECTRIC_PERSISTENT_STATE:默认FILE,在容器重建时保留同步状态ELECTRIC_STORAGE:默认FAST_FILE(Electric 1.7.12+ 接受MEMORY或FAST_FILE,旧值FILE启动会失败)ELECTRIC_STORAGE_DIR:容器内持久化绝对路径,默认/var/lib/electricELECTRIC_INSECURE:开发环境默认为true;生产环境暴露前必须设为false并配置ELECTRIC_SECRET
模板默认跟随上游未固定标签的 electricsql/electric 镜像(验证快照对应 sync-service 1.7.12);需要受控升级窗口的生产环境建议显式固定镜像版本或摘要。
缓存与持久化
Compose 默认将命名卷 electric-data 挂载到 ELECTRIC_STORAGE_DIR(默认 /var/lib/electric),在同版本容器重建且 PostgreSQL 时间线未变时保留 shape 句柄与日志数据。
PostgreSQL 保存权威业务数据,Electric 缓存卷不能替代数据库备份。当缓存卷丢失或 PostgreSQL 实例身份/时间线发生变化时,缓存的 shape 会失效,客户端仍须处理 409 / must-refetch 控制消息并丢弃本地缓存重新同步。
运维命令
参考
- Electric 官网: https://electric-sql.com/
- Electric 文档: https://electric-sql.com/docs
- Pigsty 模板: https://github.com/pgsty/pigsty/blob/main/conf/app/electric.yml
这个页面对您有帮助吗?
感谢反馈,我们会据此改进这篇文档。
哪里没有解决?(可选)