Ubuntu 22.04 安装 PostgreSQL 全流程（含踩坑 + 优化 + 远程连接）
ubuntu, postgresql, database, devops
适用于：个人开发 / 小型服务 / 云服务器部署 环境：Ubuntu 22.04 + PostgreSQL
📌 一、为什么选择 PostgreSQL？
PostgreSQL 是一个企业级开源关系型数据库，相比 MySQL：
- 更强的 SQL 标准支持
- 更适合复杂查询 / 分析
- JSON / GIS / 扩展能力强
- 数据一致性更严谨
👉 适合场景：
- Web 后端（Django / Node / Go）
- 数据分析系统
- 日志 / 监控存储
- 小型 SaaS 项目
🛠️ 二、安装 PostgreSQL
1. 更新系统
sudo apt update && sudo apt upgrade -y
2. 安装 PostgreSQL
sudo apt install postgresql postgresql-contrib -y
✅ 三、验证安装
sudo systemctl status postgresql
👉 正常状态：
active (running)
⚠️ 四、重要认知（新手必踩坑）
❗ sudo 要的不是数据库密码！
执行：
sudo systemctl restart postgresql
提示输入密码时：
👉 输入的是 Linux 系统用户密码 ❌ 不是 PostgreSQL 的密码
❗ postgres 默认没有密码
默认登录方式是：
sudo -u postgres psql
原因：
👉 使用的是 peer 认证（系统用户信任）
🧑💻 五、进入数据库
sudo -i -u postgres
psql
退出：
\q
🏗️ 六、创建数据库 & 用户（推荐）
-- 创建用户
CREATE USER myuser WITH PASSWORD 'mypassword';
-- 创建数据库
CREATE DATABASE mydb OWNER myuser;
-- 授权
GRANT ALL PRIVILEGES ON DATABASE mydb TO myuser;
🔐 七、修改认证方式（关键）
默认是 peer（本地免密），需要改成密码登录。
编辑配置：
sudo nano /etc/postgresql/14/main/pg_hba.conf
找到：
local all all peer
改为：
local all all md5
🌐 八、开启远程访问（服务器必做）
1. 修改监听地址
sudo nano /etc/postgresql/14/main/postgresql.conf
修改：
listen_addresses = '*'
2. 配置访问规则
sudo nano /etc/postgresql/14/main/pg_hba.conf
新增：
host all all 0.0.0.0/0 md5
3. 重启服务
sudo systemctl restart postgresql
4. 开放端口
sudo ufw allow 5432/tcp
🧪 九、连接测试
本地：
psql -U myuser -d mydb -h localhost
远程：
psql -U myuser -d mydb -h 服务器IP
💡 十、1核1G服务器优化（实战重点）
👉 小内存机器必须优化，否则容易卡死
推荐配置
编辑：
sudo nano /etc/postgresql/14/main/postgresql.conf
修改：
max_connections = 20
shared_buffers = 128MB
work_mem = 2MB
maintenance_work_mem = 32MB
effective_cache_size = 512MB
开启 swap（强烈建议）
sudo fallocate -l 1G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
持久化：
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
🚨 十一、常见问题（踩坑合集）
❌ 1. 连接失败（Connection refused）
排查：
ss -lntp | grep 5432
检查：
- listen_addresses
- 防火墙
- 服务是否启动
❌ 2. 密码不生效
👉 90% 原因：
pg_hba.conf还是 peer- 忘记重启服务
❌ 3. sudo 要密码但不知道
👉 解决：
whoami
确认当前用户，然后使用该用户密码。
❌ 4. 服务器卡死 / OOM
👉 原因：
- 连接数太多
- 内存配置过大
- 没有 swap
感谢读到这里
日志还会继续，欢迎常来。
返回首页