---
title: "数据库部署"
description: "使用 Docker Compose 部署 PostgreSQL 和 Redis"
canonical_url: "https://mhaibaraai.cn/docs/guides/deployment/database"
---
# 数据库部署

> 使用 Docker Compose 部署 PostgreSQL 和 Redis

> [!NOTE]
> 
> 本指南使用 Docker Compose v2+ 部署 PostgreSQL 和 Redis，并通过 SSH 隧道实现安全的远程连接。

## 项目结构

```sh [sh]
mkdir -p ~/database
cd ~/database
touch docker-compose.yml
```

## 编写 Compose 文件

> [!WARNING]
> 
> 端口绑定 
> 
> 127.0.0.1
> 
>  仅允许本地访问，这是推荐的安全配置。远程连接请使用 SSH 隧道。

```yaml [~/database/docker-compose.yml]
services:
  postgres:
    image: postgres:16-alpine
    container_name: postgres
    restart: always
    ports:
      - "127.0.0.1:5432:5432"
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: your_postgres_password
      POSTGRES_DB: app
      TZ: Asia/Shanghai
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    container_name: redis
    restart: always
    ports:
      - "127.0.0.1:6379:6379"
    command: redis-server --requirepass your_redis_password
    volumes:
      - redis_data:/var/lib/redis/data

volumes:
  postgres_data:
  redis_data:
```

## 启动服务

```sh [sh]
cd ~/database
docker compose up -d
```

## 验证安装

```sh [sh]
# 检查容器状态
docker ps

# 测试 PostgreSQL
docker exec -it postgres psql -U postgres -c "SELECT version();"

# 测试 Redis
docker exec -it redis redis-cli -a 'your_redis_password' ping
```

PostgreSQL 成功时显示版本信息，Redis 成功时返回 `PONG`。

## 远程连接数据库

> [!WARNING]
> 
> 不建议将数据库端口直接暴露到公网。强烈推荐通过 SSH 隧道连接。

### 为什么使用 SSH 隧道

<table>
<thead>
  <tr>
    <th>
      方案
    </th>
    
    <th>
      安全性
    </th>
    
    <th>
      适用场景
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      直接暴露端口
    </td>
    
    <td>
      ❌ 低
    </td>
    
    <td>
      仅测试环境
    </td>
  </tr>
  
  <tr>
    <td>
      IP 白名单
    </td>
    
    <td>
      ⚠️ 中
    </td>
    
    <td>
      固定 IP 用户
    </td>
  </tr>
  
  <tr>
    <td>
      SSH 隧道
    </td>
    
    <td>
      ✅ 高
    </td>
    
    <td>
      动态 IP 用户（推荐）
    </td>
  </tr>
</tbody>
</table>

### Navicat 配置 PostgreSQL

### 新建连接

打开 Navicat，点击 **连接** → **PostgreSQL**

### 配置常规选项卡

<table>
<thead>
  <tr>
    <th>
      参数
    </th>
    
    <th>
      值
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      主机
    </td>
    
    <td>
      <code>
        127.0.0.1
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      端口
    </td>
    
    <td>
      <code>
        5432
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      初始数据库
    </td>
    
    <td>
      <code>
        app
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      用户名
    </td>
    
    <td>
      <code>
        postgres
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      密码
    </td>
    
    <td>
      <code>
        your_postgres_password
      </code>
    </td>
  </tr>
</tbody>
</table>

### 配置 SSH 选项卡

勾选 **使用 SSH 通道**：

<table>
<thead>
  <tr>
    <th>
      参数
    </th>
    
    <th>
      值
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      主机
    </td>
    
    <td>
      服务器公网 IP
    </td>
  </tr>
  
  <tr>
    <td>
      端口
    </td>
    
    <td>
      <code>
        22
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      用户名
    </td>
    
    <td>
      <code>
        ubuntu
      </code>
      
      （或 <code>
        root
      </code>
      
      ）
    </td>
  </tr>
  
  <tr>
    <td>
      验证方法
    </td>
    
    <td>
      密码 或 公钥
    </td>
  </tr>
</tbody>
</table>

### 测试连接

点击 **连接测试**，成功后保存连接。

> [!NOTE]
> 
> Redis 配置类似，端口为 
> 
> 6379
> 
> ，密码为 
> 
> your_redis_password
> 
> 。

## PostgreSQL 管理

### 常用命令

```sh [sh]
# 进入 psql
docker exec -it postgres psql -U postgres

# 执行 SQL 文件
docker exec -i postgres psql -U postgres -d app < script.sql

# 查看数据库大小
docker exec -it postgres psql -U postgres -c \
  "SELECT pg_database.datname, pg_size_pretty(pg_database_size(pg_database.datname)) FROM pg_database;"
```

### psql 内部命令

```sql [psql]
\l              -- 列出所有数据库
\c dbname       -- 切换数据库
\dt             -- 列出当前数据库的表
\d tablename    -- 查看表结构
\du             -- 列出所有用户
\dx             -- 列出已安装扩展
\q              -- 退出
```

### 备份与恢复

```sh [sh]
# 备份数据库
docker exec -it postgres pg_dump -U postgres -d app > backup.sql

# 压缩备份
docker exec -it postgres pg_dump -U postgres -d app | gzip > backup.sql.gz

# 恢复数据库
cat backup.sql | docker exec -i postgres psql -U postgres -d app

# 从压缩文件恢复
gunzip -c backup.sql.gz | docker exec -i postgres psql -U postgres -d app
```

### 添加 PostGIS 扩展

如需处理地理数据，修改镜像并激活扩展：

```yaml [docker-compose.yml]
services:
  postgres:
    image: postgis/postgis:16-3.4-alpine
    # ... 其余配置保持不变
```

```sh [sh]
# 重启服务
docker compose down
docker compose up -d

# 激活扩展
docker exec -it postgres psql -U postgres -d app -c "CREATE EXTENSION postgis;"
```

## Redis 管理

### 常用命令

```sh [sh]
# 进入 Redis CLI
docker exec -it redis redis-cli -a 'your_redis_password'
```

### redis-cli 内部命令

```redis [redis-cli]
# 基本操作
SET key "value"           # 设置键值
GET key                   # 获取值
DEL key                   # 删除键
EXPIRE key 60             # 设置过期时间（秒）

# 查看信息
KEYS *                    # 查看所有键（生产环境慎用）
DBSIZE                    # 当前数据库键数量
INFO                      # 服务器信息
INFO memory               # 内存使用信息

# 数据库操作
FLUSHDB                   # 清空当前数据库

# 退出
QUIT
```

### 数据持久化

Redis 默认使用 RDB 快照。如需 AOF 持久化，创建自定义配置：

```sh [sh]
mkdir -p ~/database/redis-conf
```

```conf [~/database/redis-conf/redis.conf]
# 启用 AOF 持久化
appendonly yes
appendfsync everysec

# RDB 配置
save 900 1
save 300 10
save 60 10000

# 内存限制
maxmemory 256mb
maxmemory-policy allkeys-lru
```

更新 `docker-compose.yml`：

```yaml [docker-compose.yml]
services:
  redis:
    image: redis:7-alpine
    container_name: redis
    restart: always
    ports:
      - "127.0.0.1:6379:6379"
    command: redis-server /usr/local/etc/redis/redis.conf --requirepass your_redis_password
    volumes:
      - redis_data:/data
      - ./redis-conf/redis.conf:/usr/local/etc/redis/redis.conf:ro
```

## 常用 Docker 命令

```sh [sh]
# 查看容器状态
docker ps

# 查看日志
docker logs postgres --tail 50
docker logs redis --tail 50

# 重启服务
cd ~/database
docker compose restart

# 停止服务
docker compose down

# 停止并删除数据卷（危险：会丢失数据）
docker compose down -v
```

## 安全建议

1. **使用强密码**：建议使用 `openssl rand -base64 16` 生成
2. **仅本地监听**：端口绑定 `127.0.0.1` 而非 `0.0.0.0`
3. **SSH 隧道连接**：避免直接暴露数据库端口
4. **定期备份**：配置自动备份脚本
5. **及时更新**：定期更新 Docker 镜像修复安全漏洞

```sh [sh]
# 更新镜像
docker compose pull
docker compose up -d
```


## Sitemap

See the full [sitemap](https://mhaibaraai.cn/sitemap.md) for all pages.