---
title: PostgreSQL 与 Odoo 安装常见问题处理记录
description: 面向企业 IT 运维，梳理在 Linux 环境部署 PostgreSQL 与 Odoo 时的准备工作、依赖安装、数据库连接、远程访问与 SSH 长连接等常见问题，给出通用命令、验证方法与回退建议，参数统一使用占位符。
url: "https://www.lanever.com/docs/postgresql-%e4%b8%8e-odoo-%e5%ae%89%e8%a3%85%e5%b8%b8%e8%a7%81%e9%97%ae%e9%a2%98%e5%a4%84%e7%90%86%e8%ae%b0%e5%bd%95/"
updated: "2026-10-12"
category: Odoo
---

# PostgreSQL 与 Odoo 安装常见问题处理记录

> **参考来源与致谢**
>
>
>
> - **引用来源：**[记录PostgreSQL和ODOO安装的一些问题](http://www.fx114.net/qa-205-150330.aspx)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

本文面向企业 IT 运维人员，适用于在 Linux 服务器上从源码部署 Odoo 并搭配 PostgreSQL 的场景，尤其是首次安装、迁移环境或排查数据库连接异常时。文中命令为通用形式，具体版本差异请查阅对应版本官方文档。

## 准备与风险

- 确认服务器可联网，具备 `sudo` 权限，并预留足够磁盘空间。
- 操作前对现有数据库、配置文件与源码目录做备份，例如导出数据库、复制 `pg_hba.conf` 与 `postgresql.conf`。
- 生产环境变更前先在测试环境验证，避免直接修改线上配置。
- 涉及防火墙、监听地址、认证方式的调整会扩大访问面，需评估安全影响。
- 所有账号、密码、地址均以占位符表示，实际部署时按内部规范填写。

## 处理步骤

### 1. 系统与账号准备

创建专用运行账号，避免直接使用 root 运行服务。

```
sudo adduser [运行账号]
sudo usermod -aG sudo [运行账号]
sudo apt-get update
sudo apt-get install -y git
```

更新软件源可避免出现 `Unable to locate package` 一类报错。

### 2. 安装 PostgreSQL

按需指定版本，安装后为 Odoo 创建数据库超级用户。

```
sudo apt-get install -y postgresql
sudo su - postgres -c "createuser -s [数据库账号]"
```

验证用户是否创建成功：

```
sudo -u postgres psql
du
```

### 3. 安装 Odoo 依赖

先装系统工具包，再装 Python 依赖。注意命令换行符，避免复制时被截断。

```
sudo apt-get install -y wget git python-pip gdebi-core
sudo apt-get install -y python-dateutil python-psycopg2 python-lxml python-mako python-passlib python-requests python-pil
sudo pip install gdata psycogreen ofxparse XlsxWriter
sudo apt-get install -y node-clean-css node-less python-gevent
```

如需中文界面，可安装中文字体与输入法：

```
sudo apt-get install -y ttf-wqy-zenhei ttf-wqy-microhei
sudo apt-get install -y ibus-pinyin ibus-libpinyin
```

### 4. 获取源码并配置

```
mkdir -p ~/odoo-dev/custom/addons
cd ~/odoo-dev
git clone [源码仓库地址] --branch [分支] --single-branch odoo-server/
cp ~/odoo-dev/odoo-server/debian/odoo.conf ~/odoo-dev/odoo.conf
```

编辑配置文件，设置插件路径：

```
addons_path = /home/[运行账号]/odoo-dev/odoo-server/addons,/home/[运行账号]/odoo-dev/custom/addons
```

启动服务：

```
/home/[运行账号]/odoo-dev/odoo-server/odoo-bin -c /home/[运行账号]/odoo-dev/odoo.conf
```

### 5. 数据库远程访问配置

编辑 `pg_hba.conf`，按需添加访问规则，认证方式可选 `md5` 或 `trust`，生产环境不建议使用 `trust`。

```
host all all [客户端网段]/32 md5
```

编辑 `postgresql.conf`，调整监听地址：

```
listen_addresses = '*'
```

重启数据库服务：

```
sudo service postgresql restart
```

### 6. SSH 长连接

远程会话频繁断开时，可在 `/etc/ssh/sshd_config` 增加：

```
ClientAliveInterval 60
ClientAliveCountMax 3
```

同时检查 `TMOUT` 是否被设置为大于 0 的值。

## 验证方法

- 数据库用户：`sudo -u postgres psql` 后执行 `du` 查看账号。
- 端口监听：`netstat -tanp | grep 5432` 确认监听状态。
- 远程连通：使用 `telnet [服务器地址] 5432` 测试端口。
- Odoo 服务：浏览器访问 `[外部链接已移除]`，确认登录页正常。

## 回退建议

- 恢复修改前的 `pg_hba.conf` 与 `postgresql.conf`，重启数据库服务。
- 停止 Odoo 进程，回滚源码到上一可用提交。
- 如数据库结构已变更，使用备份进行恢复，避免数据不一致。

## 常见问题

- **无法定位软件包**：先执行 `apt-get update`。
- **Vim 保存只读文件**：可用 `:w !sudo tee %`，或先调整文件权限。
- **远程连接被拒**：检查 `pg_hba.conf`、`listen_addresses`、防火墙与端口监听。
- **密码修改**：登录后执行 `ALTER USER [账号] WITH PASSWORD '[新密码]';`，密码需符合内部策略。

> 不同发行版与 Odoo、PostgreSQL 版本在包名、路径、配置项上存在差异，请以对应版本官方文档为准。
