🎯 课程主题

在已部署好的 Ubuntu 24.04 云服务器上安装 PostgreSQL 数据库，创建数据库和用户，并完成连通性测试——为后续使用 PostgresSaver 作为 LangGraph Checkpointer 后端做准备。

📝 核心知识点

1. 安装 PostgreSQL

# 安装 PostgreSQL
sudo apt update
sudo apt install postgresql postgresql-contrib -y

2. 关键信息速查

项目值
默认监听端口5432
Linux 发行版Ubuntu Server 24.04
安装后服务状态自动启动（active）

3. 完整操作步骤一览

步骤操作命令 / 说明
Step 1安装 PostgreSQLsudo apt install postgresql postgresql-contrib -y
Step 2验证安装psql --version
Step 3查看服务状态sudo systemctl status postgresql
Step 4查看监听端口`sudo netstat -tlnp
Step 5创建用户在 psql 命令行中执行 CREATE USER langchauser WITH PASSWORD 'ABCD1234';
Step 6创建数据库CREATE DATABASE langchaindb OWNER langchauser;
Step 7用户授权GRANT ALL PRIVILEGES ON DATABASE langchaindb TO langchauser;
Step 8查看数据库列表\l
Step 9退出 psql\q
Step 10连通性测试psql -h localhost -U langchauser -d langchaindb

4. PostgreSQL vs MySQL 常用命令对比

操作PostgreSQL (psql)MySQL
列出所有数据库\lSHOW DATABASES;
连接数据库\c dbnameUSE dbname;
列出所有表\dtSHOW TABLES;
退出客户端\qEXIT; 或 \q

🏗️ 架构与工作流

完整安装与验证流程

┌─────────────────────────────────┐
│ 1. sudo apt install postgresql   │  安装 PostgreSQL
│    postgresql-contrib -y         │
└───────────────┬─────────────────┘
                ▼
┌─────────────────────────────────┐
│ 2. psql --version               │  验证版本（如 16.x）
└───────────────┬─────────────────┘
                ▼
┌─────────────────────────────────┐
│ 3. systemctl status postgresql  │  确认服务 running (active)
└───────────────┬─────────────────┘
                ▼
┌─────────────────────────────────┐
│ 4. netstat -tlnp | grep 5432    │  确认端口 5432 监听中
└───────────────┬─────────────────┘
                ▼
┌─────────────────────────────────┐
│ 5. sudo -u postgres psql        │  进入客户端
│    CREATE USER langchauser       │  创建用户
│    WITH PASSWORD 'ABCD1234';     │
│    CREATE DATABASE langchaindb   │  创建数据库
│    OWNER langchauser;            │
│    GRANT ALL PRIVILEGES          │  授权
│    ON DATABASE langchaindb       │
│    TO langchauser;               │
└───────────────┬─────────────────┘
                ▼
┌─────────────────────────────────┐
│ 6. psql -h localhost            │  连通性测试
│    -U langchauser                │
│    -d langchaindb                │
└─────────────────────────────────┘

数据库与用户的对应关系

┌──────────────────────────────────┐
│         PostgreSQL Instance       │
│                                    │
│  ┌─────────────────────────────┐  │
│  │ Database: langchaindb        │  │
│  │ Owner: langchauser           │  │
│  │ Privileges: ALL              │  │
│  └─────────────────────────────┘  │
│                                    │
│  User: langchauser                 │
│  Password: ABCD1234                │
└──────────────────────────────────┘

后续 LangChain 连接配置预览

# 后续 LangGraph PostgresSaver 将使用此连接信息
DB_URI = "postgresql://langchauser:ABCD1234@localhost:5432/langchaindb"
# 或使用公网 IP（需安全组开放 5432 端口）:
# DB_URI = "postgresql://langchauser:ABCD1234@<公网IP>:5432/langchaindb"

💻 代码实战

Step 1: 安装 PostgreSQL

sudo apt update
sudo apt install postgresql postgresql-contrib -y
# 等待下载安装完成...

Step 2: 验证版本

psql --version
# 输出示例: psql (PostgreSQL) 16.x (Ubuntu 16.x-...)

Step 3: 查看服务状态

sudo systemctl status postgresql
# 输出示例:
# Active: active (exited) since ...
# 表示 PostgreSQL 已启动并对外提供服务

Step 4: 查看监听端口

sudo ss -tlnp | grep 5432
# 或
sudo netstat -tlnp | grep postgres
# 输出示例:
# LISTEN  0  244  127.0.0.1:5432  ...   ← 默认监听 localhost
# （如需远程访问，需修改 postgresql.conf 中的 listen_addresses）

Step 5: 创建用户和数据库

# 以 postgres 系统用户身份进入 psql 客户端
sudo -u postgres psql

-- 此时终端前缀变为 postgres=#

-- 创建用户
CREATE USER langchauser WITH PASSWORD 'ABCD1234';

-- 创建数据库，指定 owner
CREATE DATABASE langchaindb OWNER langchauser;

-- 授权
GRANT ALL PRIVILEGES ON DATABASE langchaindb TO langchauser;

-- 查看数据库列表
\l
-- 输出示例:
--   Name       |    Owner     | Encoding | ...
--  langchaindb | langchauser  | UTF8     | ...

-- 退出
\q

Step 6: 连通性测试

# 使用新创建的用户连接数据库
psql -h localhost -U langchauser -d langchaindb
# 输入密码: ABCD1234

# 若成功进入 psql 命令行（前缀变为 langchaindb=>），则连通性正常
# 输入 \q 退出

本地远程连接（可选）

# 如果需要在本地电脑连接云服务器的 PostgreSQL:
psql -h <云服务器公网IP> -p 5432 -U langchauser -d langchaindb
# 前提：腾讯云安全组已开放 TCP 5432 端口
#       postgresql.conf 中 listen_addresses = '*'
#       pg_hba.conf 中添加远程访问规则

⚠️ 常见问题与避坑指南

问题原因解决方案
sudo: apt: command not found非 Ubuntu/Debian 系统改用对应的包管理器（yum/dnf）
服务状态不是 active安装后未自动启动sudo systemctl start postgresql
psql: connection refusedPostgreSQL 未启动或端口不对检查 systemctl status postgresql + 端口监听
远程连不上 5432安全组未开放 / pg 配置限制① 安全组添加 TCP 5432 入站规则；② 修改 postgresql.conf 的 listen_addresses；③ 修改 pg_hba.conf 认证规则
\l 命令无输出在 SQL 模式下而非 psql 元命令模式下psql 中直接输入 \l 回车（末尾不加分号）
忘记用户名或密码-以 sudo -u postgres psql 进入后可用 ALTER USER langchauser PASSWORD '新密码'; 重置

💡 个人总结与延伸

  1. 本节是 LangChain 持久化方案的关键前置步骤——后续 PostgresSaver 和 Store 都将依赖 PostgreSQL。
  2. PostgreSQL 安装后默认只监听 localhost (127.0.0.1)，若需本地远程连接，必须修改 postgresql.conf 和 pg_hba.conf 两个配置文件。
  3. 记录好数据库连接 URI 格式：postgresql://user:password@host:5432/dbname，后续 LangChain 配置会直接使用。
  4. \l、\dt、\q 等 psql 元命令是 PostgreSQL 特有的交互方式，与 MySQL 的 SQL 风格不同，注意区分。
  5. 下一步就是将 PostgresSaver 接入 LangGraph StateGraph，实现基于 PostgreSQL 的持久化短期记忆。
最近更新:
Contributors: yangwenguang