# pg-sync-expert

**Repository Path**: mlfh/pg-sync-expert

## Basic Information

- **Project Name**: pg-sync-expert
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 🚀 PostgreSQL Sync Expert (PG-Sync-Pro)

<p align="center">
  <img src="logo-1.png" alt="Logo" width="100" height="100">
</p>
<p align="center">
  <img src="https://img.shields.io/badge/build-passing-brightgreen.svg" alt="Build Status">
  <img src="https://img.shields.io/badge/node-%3E%3D14.0.0-blue" alt="Node Version">
  <img src="https://img.shields.io/badge/license-MIT-orange" alt="License">
  <a href="https://github.com/yinzhenCoder/pg-sync-expert/stargazers"><img src="https://img.shields.io/github/stars/yinzhenCoder/pg-sync-expert" alt="GitHub Stars"></a>
</p>

<p align="center">
  <strong>一款现代化、高性能、可视化的 PostgreSQL 数据库批量同步与迁移工具。</strong><br>
  告别龟速的逻辑传输，基于 Pipe流技术，专为开发者和 DBA 打造。
</p>
<p align="center">
  <img src="assets/demo.gif" alt="PostgreSQL Sync Expert Demo" width="100%">
</p>
---

## ✨ 为什么选择它？(Key Features)

传统的数据库管理工具（如 Navicat、DBeaver）在进行跨库大量数据同步时，往往速度缓慢且容易卡死。**PG-Sync-Expert** 解决了这个问题：

* 🚀 **极速同步**：底层基于 `pg_dump | psql` 管道流技术，比传统 GUI 工具快 **10 倍以上**。
* 🎨 **现代化交互**：抽屉式表单、静默校验、分组管理，媲美原生 App 的丝滑体验。
* 🛡️ **安全可靠**：支持 **数据源连接测试**、**Bin 目录有效性检测**，同步前自动检测目标库冲突。
* 📊 **全链路监控**：可视化的进度条、实时滚动的控制台日志，一切尽在掌握。
* 📝 **审计日志**：内置日志记录器，支持关键词高亮搜索、导出备份及安全清空，操作留痕。
* 🔒 **隐私安全**：所有配置数据仅存储在本地浏览器 (LocalStorage)，不经过任何云端服务器。

---

## 🖼️ 功能预览 (Screenshots)

### 1. 现代化仪表盘 & 分组管理
支持对数据源进行分组（文件夹）管理，拖拽式体验，一键检测所有连接健康状态。
![Dashboard](assets/home-dashboard.png)

### 2. 优雅的抽屉式交互
摒弃烦人的弹窗，采用侧滑抽屉进行配置，支持实时静默校验与密码显隐。
![Drawer Interaction](assets/add-source-drawer.png)

### 3. 可视化同步监控
拒绝黑盒操作！实时展示创建库、删除库、数据传输的每一步细节。
![Sync Process](assets/step3.png)

### 4. 专业的日志审计系统
内置日志查看器，支持正则搜索、关键词高亮、一键导出与安全清空逻辑。
![Log Audit](assets/log-audit.png)

---

## 🛠️ 快速开始 (Quick Start)

### 前置要求
1.  **Node.js**: 版本需 >= 14.0.0。
2.  **PostgreSQL Client**: 本机必须安装 PostgreSQL（需要 `pg_dump` 和 `psql` 命令）。

### 安装与运行

```bash
# 1. 克隆仓库
git clone [https://github.com/yinzhenCoder/pg-sync-expert.git](https://github.com/yinzhenCoder/pg-sync-expert.git)

# 2. 进入目录
cd pg-sync-expert

# 3. 安装依赖
npm install

# 4. 启动服务
node server.js

```

启动成功后，浏览器访问：[http://localhost:3000](https://www.google.com/search?q=http://localhost:3000)

---

## 📖 使用指南 (User Guide)

1. **环境配置**：
* 首次进入，请在顶部输入框填写本机 PostgreSQL 的 `bin` 目录路径（例如：`D:\PostgreSQL\16\bin`）。
* 点击 **"🔍 检测路径"** 确保环境就绪。


2. **添加数据源**：
* 点击左侧 **+** 号，在抽屉中填写数据库连接信息。
* 支持自定义 **分组**，方便管理不同环境（如：生产环境、测试环境）。
* 点击 **"🔍 测试并保存"**，系统会自动验证连接连通性。


3. **建立同步链路**：
* **Step 1**: 在主界面选择 [源数据源] 和 [目标数据源]。
* **Step 2**: 勾选需要同步的数据库，支持设置 **目标库前缀**（如 `bak_`）。
* **Step 3**: 点击 **"🚀 开始预览与同步"**。


4. **冲突处理**：
* 如果目标库已存在，系统会智能弹窗询问：[⏭️ 跳过] 还是 [🗑️ 删除并覆盖]。



---

## ⚙️ 技术栈 (Tech Stack)

* **Frontend**: 原生 HTML5 / CSS3 (Flexbox & Grid) / Vanilla JS (无框架依赖，极致轻量)。
* **Backend**: Node.js + Express。
* **Core**: `child_process` spawn pipe stream。
* **Storage**: Browser LocalStorage (Config) + FileSystem (Logs)。

---

## 🤝 贡献 (Contributing)

欢迎提交 Issue 和 Pull Request！如果你有更好的想法，比如增加定时任务、Docker 部署支持等，请随时告诉我们。

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

---

## 📄 开源协议 (License)

本项目遵循 [MIT License](https://www.google.com/search?q=LICENSE) 协议。