参考来源与致谢
- 引用来源:Odoo 的安装-IT大道
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
本文适用于在企业内网服务器上部署 Odoo 的运维人员。常见需求包括:快速搭建标准化实例、需要自定义模块目录、需要将服务纳入系统级守护。若仅需标准功能且不希望过多人工干预,可优先考虑发行版软件包方式;若需跟进特定代码分支或深度定制,则考虑源码方式。具体版本支持范围请查阅对应版本的官方文档。
准备与风险 #
- 确认操作系统版本、Python 运行环境与 PostgreSQL 版本满足目标 Odoo 版本要求,以官方文档为准。
- 准备独立测试环境,避免直接在生产服务器上首次安装。
- 安装前对现有数据库与配置文件做完整备份,记录当前服务状态。
- 涉及删除、覆盖、权限变更等破坏性操作前,务必确认已具备可回退的备份。
- 源码方式依赖外部代码仓库与第三方依赖包,网络受限时可能需手动处理依赖,耗时较长。
处理步骤 #
方式一:软件包安装 #
- 在软件源配置文件中追加 Odoo 官方源条目,源地址以实际发布地址为准,此处以
[软件源地址]表示。 - 更新软件包索引。若出现签名校验失败,需导入对应公钥后再重试,公钥文件以
[公钥文件路径]表示。 - 执行安装命令:
sudo apt-get install odoo。 - 确认安装路径与附加模块目录。不同发行版与版本路径不同,请以实际安装结果为准,常见形式为
[安装目录]与[附加模块目录]。 - 编辑主配置文件
[配置文件路径],重点关注以下项:addons_path:多个模块目录以逗号分隔。建议自研模块单独存放,不与系统模块混放。admin_passwd:数据库管理口令,使用强口令并限制文件权限。db_user:连接数据库所用账号。
- 通过系统服务命令启动、停止或重启:
sudo service odoo start|stop|restart。
方式二:源码安装 #
- 使用版本控制工具拉取目标分支代码到
[代码目录]。 - 进入代码目录执行依赖安装:
sudo python setup.py install。若依赖下载失败,需按报错逐个手动安装。 - 启动服务,指定数据库账号与模块路径:
./openerp-server -r [数据库账号] --addons-path='[附加模块目录]'。也可通过-c指定配置文件。 - 可将启动命令封装为脚本,减少重复输入。
- 生产环境建议使用进程守护工具托管服务,保证异常退出后自动拉起。
数据库配置 #
- Odoo 依赖 PostgreSQL。若启动日志提示缺少数据库用户,需以数据库超级用户身份创建:
create user [数据库账号] with superuser;。生产环境建议按最小权限原则调整授权范围。 - 若数据库无法被非本机访问,检查
postgresql.conf中listen_addresses是否被注释,按需放开监听地址后重启数据库服务。 - 若远程连接提示认证失败,检查
pg_hba.conf,按来源网段分别配置认证方式(如peer、md5、trust)。生产环境不建议对宽网段使用trust。
验证方法 #
- 查看服务状态与日志,确认无启动报错。
- 浏览器访问服务地址,确认登录页正常加载。
- 使用管理员账号登录,检查模块列表与自研模块是否被正确加载。
- 在数据库侧确认目标账号可连接,并核对监听端口与认证规则生效。
回退建议 #
- 软件包方式:卸载对应软件包,恢复原配置文件与数据库备份。
- 源码方式:停止服务,切回原代码分支或提交,重新安装依赖后启动。
- 数据库变更:使用备份进行恢复,恢复前先停止应用服务,避免写入冲突。
- 回退操作同样具有破坏性,执行前再次确认备份可用。
常见问题 #
- 软件源更新报签名错误:多为公钥未导入,导入后重试。
- 源码安装依赖装不上:网络受限或依赖版本冲突,按报错逐个处理。
- 启动日志提示缺少数据库用户:按上文创建账号并核对权限。
- 远程连不上数据库:依次排查监听地址、认证规则与防火墙策略。
- 自研模块不生效:检查
addons_path是否包含其所在目录,以及目录权限是否正确。
提示:不同 Odoo 版本在目录结构、配置项名称与依赖要求上存在差异,实施前请查阅对应版本的官方文档,并在测试环境完成验证后再推广到生产环境。
