---
title: Odoo 安装与数据库配置运维指南
description: 面向企业 IT 运维，梳理 Odoo 的 deb 包与源码两种安装路径、PostgreSQL 数据库配置要点、验证方法与回退建议。所有环境参数以占位符表示，涉及破坏性操作前请先备份并在测试环境验证。
url: "https://www.lanever.com/docs/odoo-%e5%ae%89%e8%a3%85%e4%b8%8e%e6%95%b0%e6%8d%ae%e5%ba%93%e9%85%8d%e7%bd%ae%e8%bf%90%e7%bb%b4%e6%8c%87%e5%8d%97/"
updated: "2026-10-12"
category: Odoo
---

# Odoo 安装与数据库配置运维指南

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

## 适用场景

本文适用于在企业内网服务器上部署 Odoo 的运维人员。常见需求包括：快速搭建标准化实例、需要自定义模块目录、需要将服务纳入系统级守护。若仅需标准功能且不希望过多人工干预，可优先考虑发行版软件包方式；若需跟进特定代码分支或深度定制，则考虑源码方式。具体版本支持范围请查阅对应版本的官方文档。

## 准备与风险

- 确认操作系统版本、Python 运行环境与 PostgreSQL 版本满足目标 Odoo 版本要求，以官方文档为准。
- 准备独立测试环境，避免直接在生产服务器上首次安装。
- 安装前对现有数据库与配置文件做完整备份，记录当前服务状态。
- 涉及删除、覆盖、权限变更等破坏性操作前，务必确认已具备可回退的备份。
- 源码方式依赖外部代码仓库与第三方依赖包，网络受限时可能需手动处理依赖，耗时较长。

## 处理步骤

### 方式一：软件包安装

1. 在软件源配置文件中追加 Odoo 官方源条目，源地址以实际发布地址为准，此处以 `[软件源地址]` 表示。
2. 更新软件包索引。若出现签名校验失败，需导入对应公钥后再重试，公钥文件以 `[公钥文件路径]` 表示。
3. 执行安装命令：`sudo apt-get install odoo`。
4. 确认安装路径与附加模块目录。不同发行版与版本路径不同，请以实际安装结果为准，常见形式为 `[安装目录]` 与 `[附加模块目录]`。
5. 编辑主配置文件 `[配置文件路径]`，重点关注以下项：
   - `addons_path`：多个模块目录以逗号分隔。建议自研模块单独存放，不与系统模块混放。
   - `admin_passwd`：数据库管理口令，使用强口令并限制文件权限。
   - `db_user`：连接数据库所用账号。
6. 通过系统服务命令启动、停止或重启：`sudo service odoo start|stop|restart`。

### 方式二：源码安装

1. 使用版本控制工具拉取目标分支代码到 `[代码目录]`。
2. 进入代码目录执行依赖安装：`sudo python setup.py install`。若依赖下载失败，需按报错逐个手动安装。
3. 启动服务，指定数据库账号与模块路径：`./openerp-server -r [数据库账号] --addons-path='[附加模块目录]'`。也可通过 `-c` 指定配置文件。
4. 可将启动命令封装为脚本，减少重复输入。
5. 生产环境建议使用进程守护工具托管服务，保证异常退出后自动拉起。

### 数据库配置

1. Odoo 依赖 PostgreSQL。若启动日志提示缺少数据库用户，需以数据库超级用户身份创建：`create user [数据库账号] with superuser;`。生产环境建议按最小权限原则调整授权范围。
2. 若数据库无法被非本机访问，检查 `postgresql.conf` 中 `listen_addresses` 是否被注释，按需放开监听地址后重启数据库服务。
3. 若远程连接提示认证失败，检查 `pg_hba.conf`，按来源网段分别配置认证方式（如 `peer`、`md5`、`trust`）。生产环境不建议对宽网段使用 `trust`。

## 验证方法

- 查看服务状态与日志，确认无启动报错。
- 浏览器访问服务地址，确认登录页正常加载。
- 使用管理员账号登录，检查模块列表与自研模块是否被正确加载。
- 在数据库侧确认目标账号可连接，并核对监听端口与认证规则生效。

## 回退建议

- 软件包方式：卸载对应软件包，恢复原配置文件与数据库备份。
- 源码方式：停止服务，切回原代码分支或提交，重新安装依赖后启动。
- 数据库变更：使用备份进行恢复，恢复前先停止应用服务，避免写入冲突。
- 回退操作同样具有破坏性，执行前再次确认备份可用。

## 常见问题

- 软件源更新报签名错误：多为公钥未导入，导入后重试。
- 源码安装依赖装不上：网络受限或依赖版本冲突，按报错逐个处理。
- 启动日志提示缺少数据库用户：按上文创建账号并核对权限。
- 远程连不上数据库：依次排查监听地址、认证规则与防火墙策略。
- 自研模块不生效：检查 `addons_path` 是否包含其所在目录，以及目录权限是否正确。

> 提示：不同 Odoo 版本在目录结构、配置项名称与依赖要求上存在差异，实施前请查阅对应版本的官方文档，并在测试环境完成验证后再推广到生产环境。
