# 安装与环境搭建

URL: https://caijiao.org/postgresql/basic/introduction/install
Source: docs/postgresql/basic/introduction/install.md
Description: 指导用户在不同操作系统中安装 PostgreSQL，并完成常用客户端工具与基础环境的配置。

## 安装方式概览

PostgreSQL 支持多平台安装，包括 Windows、macOS、Linux，并可通过源码编译或包管理器进行安装。

### 常见安装方式

- **Linux（APT / YUM / DNF）**
- **macOS（Homebrew）**
- **Windows 安装向导**
- **源码编译（适合定制需求）**
- **Docker 容器部署**

## 各平台安装示例

### Linux（Debian/Ubuntu）

```bash
sudo apt update
sudo apt install postgresql postgresql-contrib
````

### Linux（CentOS/Red Hat）

```bash
sudo dnf install postgresql-server
sudo postgresql-setup --initdb
sudo systemctl enable --now postgresql
```

### macOS（Homebrew）

```bash
brew install postgresql
brew services start postgresql
```

### Windows

* 下载地址：[https://www.postgresql.org/download/windows/](https://www.postgresql.org/download/windows/)
* 使用图形安装向导，默认安装包含 pgAdmin 工具

### Docker 安装

```bash
docker run --name pg -e POSTGRES_PASSWORD=123456 -p 5432:5432 -d postgres
```

## 客户端工具推荐

* `psql`：命令行客户端，功能强大
* `pgAdmin`：图形化界面，适合初学者和管理人员
* `DBeaver` / `TablePlus`：通用数据库管理工具，跨平台支持

## 初始化配置

* 设置数据库密码与监听端口
* 修改 `postgresql.conf` 和 `pg_hba.conf`
* 创建用户与数据库
* 配置防火墙或网络访问策略

## 小提示

* 使用 LTS 版本 PostgreSQL 保证稳定性
* 建议安装 contrib 模块，包含扩展功能如 `uuid-ossp`, `pg_stat_statements` 等