中间件 - Wizard Doc

最后修改人	孙荣利
最后修改时间	2026-09-19 18:02:23
创建人	孙荣利
创建时间	2026-09-19 18:02:23

该文档由孙荣利创建于 2026-09-19 18:02:23 ，孙荣利在 2026-09-19 18:02:23 修改了该文档。

[TOCM]

## 一、简介

> ##### 一定注意数据库需要根据实际情况修改配置参数，否则轻则配置没有优化，重则使用过程中卡死

---

```text
PostgreSQL（常简称 Postgres）是一个功能强大的开源对象-关系型数据库管理系统。你可以把它理解为“开源数据库里的瑞士军刀”：既遵循 SQL 标准、支持 ACID 事务，又具备极强的可扩展性，能处理从简单 Web 应用到复杂地理空间、JSON、向量搜索等各种负载。
```

## 二、安装部署

### 1. 服务说明

| 项目 | 说明 |
|------|------|
| 镜像 | repo.358369.xyz/postgres:14-bullseye |
| 容器名 | postgresql14 |
| 端口 | 5432 |
| 数据目录 | /data/postgresql |
| 配置方式 | 外挂 postgresql.conf |

---

### 2. 目录准备

```shell
mkdir -p /data/postgresql
cd /data/postgresql
touch docker-compose.yml
touch postgresql.conf
```

---

### 3. 配置文件

#### 3.1 docker-compose.yml

```shell
cat > docker-compose.yml <<'EOF'
services:
  postgresql14:
    image: repo.358369.xyz/postgres:14-bullseye
    container_name: postgresql14
    shm_size: 2g
    environment:
      TZ: Asia/Shanghai
      POSTGRES_USER: postgres
      # 修改成真实密码
      POSTGRES_PASSWORD: your_password
    ports:
      - 5432:5432
    volumes:
      - ./data:/var/lib/postgresql/data
      - ./postgresql.conf:/etc/postgresql/postgresql.conf 
    command: ["postgres", "-c", "config_file=/etc/postgresql/postgresql.conf"]  
    restart: always
EOF
```

> 注：原脚本中配置文件以 `postgresql.yml` 文件名生成，但 docker-compose 挂载路径为 `./postgresql.conf`，两者需保持一致（生成文件名与挂载名二选一统一）。

#### 3.2 postgresql.conf

```shell
cat > postgresql.yml <<'EOF'

#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------

# - Connection Settings -

listen_addresses = '*'
                                        # comma-separated list of addresses;
                                        # defaults to 'localhost'; use '*' for all
                                        # (change requires restart)
#port = 5432                            # (change requires restart)
max_connections = 2000                   # (change requires restart)

shared_buffers = 128MB                  # min 128kB
                                        # (change requires restart)
                                        #   windows
                                        # (change requires restart)
dynamic_shared_memory_type = posix      # the default is the first option
                                        # supported by the operating system:
max_wal_size = 1GB
min_wal_size = 80MB

log_timezone = 'Asia/Shanghai'

datestyle = 'iso, mdy'
#intervalstyle = 'postgres'
timezone = 'Asia/Shanghai'

# These settings are initialized by initdb, but they can be changed.
lc_messages = 'en_US.utf8'                      # locale for system error message
                                        # strings
lc_monetary = 'en_US.utf8'                      # locale for monetary formatting
lc_numeric = 'en_US.utf8'                       # locale for number formatting
lc_time = 'en_US.utf8'                          # locale for time formatting

# default configuration for text search
default_text_search_config = 'pg_catalog.english'

# Add settings for extensions here
EOF
```

---

### 4. 启动服务

```shell
docker compose up -d
```

---

### 5. 验证

```shell
docker ps | grep postgresql14
```

**备注**

数据库访问地址：<服务器IP>
端口号: 5432
超级管理员账号 ： postgres
密码 ： your_password

初始库：postgres