# pgsql-portable-win-builder

**Repository Path**: hyx-work/pgsql-portable-win-builder

## Basic Information

- **Project Name**: pgsql-portable-win-builder
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-04
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PostgreSQL 绿色便携版构建工具 (Windows)

自动将 PostgreSQL 二进制包 + 扩展打包为**解压即用**的绿色便携版。

## 功能特性

- 一键构建，解压即用，无需安装
- 预初始化数据库，首次启动即可连接
- 集成常用扩展（按需配置）
- 支持手动管理与 Windows 服务两种运行模式
- 所有脚本使用相对路径，可复制到任意目录

## 包含组件

| 组件 | 说明 | 构建时可选 |
|------|------|-----------|
| **PostgreSQL** | 核心数据库（Windows x64 binaries） | 必需 |
| **PostGIS** | 地理空间数据扩展 | 可选 |
| **TimescaleDB** | 时序数据库扩展 | 可选 |
| **pgvector** | 向量搜索扩展（AI/LLM embedding） | 可选 |

## 从源码构建

### 准备

将源码包放入 `pgsql_<版本>_src/` 目录，例如：

```
pgsql_<版本>_src/
├── postgresql-<版本>-windows-x64-binaries.zip   (必需)
├── postgis-bundle-pg<版本>-<版本号>x64.zip      (可选)
└── timescaledb-postgresql-<版本>-windows-amd64.zip (可选)

pgvector/
└── vector.v0.8.6-pg<版本>.zip                   (可选)
```

### 构建

运行对应的构建脚本：

```
build_17.bat        → 输出 pgsql_17.zip
build_18.bat        → 输出 pgsql_18.zip (示例)
```

### 自定义配置

编辑构建脚本顶部变量：

```batch
set "PG_VER=17"
set "PG_PORT=5417"
set "PG_DIR=pgsql_%PG_VER%"
set "SRC_DIR=pgsql_%PG_VER%_src"
set "PG_ZIP=%SRC_DIR%\postgresql-17.11-3-windows-x64-binaries.zip"
set "TSC_ZIP=%SRC_DIR%\timescaledb-postgresql-%PG_VER%-windows-amd64.zip"
set "TSC_VER=2.29.2"
set "POSTGIS_ZIP=%SRC_DIR%\postgis-bundle-pg%PG_VER%-3.6.2x64.zip"
set "POSTGIS_VER=3.6.2"
set "PGVECTOR_ZIP=%SRC_DIR%\vector.v0.8.6-pg%PG_VER%.zip"
set "PGVECTOR_VER=0.8.6"
```

## 构建流程

1. 解压 PostgreSQL 二进制包
2. 解压并合并 TimescaleDB / PostGIS / pgvector
3. 初始化数据库（initdb + 端口 + 认证配置）
4. 启用扩展（CREATE EXTENSION）
5. 生成管理脚本 + 连接信息
6. 打包为 zip（含注释）

## 管理脚本

构建后自动生成以下脚本，放入 zip 包中：

### 手动管理
- `start.bat` — 启动数据库
- `stop.bat` — 停止数据库
- `connect.bat` — 打开 psql 命令行
- `cleanup.bat` — 清理残留锁文件和日志

### Windows 服务管理（需管理员权限）
- `pgsql_install.bat` — 注册为 Windows 服务
- `pgsql_start.bat` — 启动服务
- `pgsql_stop.bat` — 停止服务
- `pgsql_unistall.bat` — 注销服务

---

## PostgreSQL 17 构建配置

### 连接信息

| 项目 | 默认值 |
|------|--------|
| 地址 | localhost |
| 端口 | 5417 |
| 用户 | postgres |
| 密码 | 构建时自动生成，见 `password.txt` |
| 数据库 | postgres |

### 下载地址

| 组件 | 下载链接 |
|------|----------|
| PostgreSQL 17.11 | https://sbp.enterprisedb.com/getfile.jsp?fileid=1260491 |
| PostGIS 3.6.2 | https://download.osgeo.org/postgis/windows/pg17/postgis-bundle-pg17-3.6.2x64.zip |
| TimescaleDB 2.29.2 | https://github.com/timescale/timescaledb/releases/download/2.29.2/timescaledb-postgresql-17-windows-amd64.zip |
| pgvector 0.8.6 | https://github.com/andreiramani/pgvector_pgsql_windows/releases/download/0.8.6_17/vector.v0.8.6-pg17.zip |

### 更多版本参考

- PostgreSQL: https://www.enterprisedb.com/download-postgresql-binaries
- PostGIS: https://download.osgeo.org/postgis/windows/pg17/
- TimescaleDB: https://github.com/timescale/timescaledb/releases
- pgvector: https://github.com/andreiramani/pgvector_pgsql_windows/releases

## 许可证

GPL-3.0 — 见 [LICENSE](LICENSE)