---
title: Odoo 服务默认端口 8069 的修改方法
description: "面向企业 IT 运维，介绍 Odoo 服务默认 XML-RPC 端口 8069 的几种调整方式，包括启动参数、配置文件、源码默认值与端口重定向，并给出准备、验证、回退与常见问题要点。"
url: "https://www.lanever.com/docs/odoo-%e6%9c%8d%e5%8a%a1%e9%bb%98%e8%ae%a4%e7%ab%af%e5%8f%a3-8069-%e7%9a%84%e4%bf%ae%e6%94%b9%e6%96%b9%e6%b3%95/"
updated: "2026-10-12"
category: Odoo
---

# Odoo 服务默认端口 8069 的修改方法

> **参考来源与致谢**
>
>
>
> - **引用来源：**[修改Odoo(OpenERP) Server的默认端口8069_Odoo,OpenERP中文网](http://www.3e3c.com/erp/odoo/129.html)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

Odoo 服务默认监听 TCP 8069 端口，用于 XML-RPC 协议通信。当出现端口冲突、需要与既有反向代理或防火墙策略对齐、或在同一主机上并行运行多个实例时，运维人员可能需要调整该端口。本文适用于自建部署的 Odoo 服务，操作前请确认所用版本与部署方式，具体参数名称与行为以对应版本官方文档为准。

## 准备与风险

- 确认当前 Odoo 版本、启动方式（系统服务、脚本或容器）以及配置文件路径。
- 记录现有端口与访问入口，通知相关使用方，选择低峰时段操作。
- 修改前备份配置文件与相关启动脚本，例如复制为带时间戳的副本。
- 在测试环境先行验证，确认客户端、集成接口与反向代理均能适配新端口。
- 端口变更会影响所有依赖该端口的调用方，需同步更新防火墙、代理与监控配置。

> 涉及服务重启或系统重启的操作具有中断风险，请务必先完成备份并在测试环境验证，确认回退路径后再在生产环境执行。

## 处理步骤

### 方法一：启动时通过命令行参数指定

在启动命令中显式传入端口参数，适合临时验证或脚本化启动。示例：

```
./odoo-bin --config=[配置文件路径] --xmlrpc-port=[新端口]
```

不同版本的可执行文件名可能不同，请以实际部署为准。

### 方法二：在配置文件中指定

编辑 Odoo 配置文件，加入或修改端口项，适合作为长期生效的配置方式：

```
xmlrpc_port = [新端口]
```

保存后重启服务使配置生效。若同时存在命令行参数，需确认优先级关系，避免配置被覆盖。

### 方法三：修改源码中的默认值

在源码 tools 目录下的 config 模块中，可找到端口选项的默认定义，形如：

```
group.add_option("--xmlrpc-port", dest="xmlrpc_port", my_default=8069,
 help="specify the TCP port for the XML-RPC protocol", type="int")
```

将默认值改为目标端口即可。此方式会随代码升级被覆盖，不建议作为长期方案，仅适合特定打包或定制场景。

### 方法四：端口重定向（Linux 环境）

通过本机防火墙规则将外部端口流量转发到 Odoo 实际监听端口，适合希望保持对外端口不变的场景。示例规则：

```
iptables -t nat -A PREROUTING -p tcp --dport [外部端口] -j REDIRECT --to-port [Odoo端口]
```

可将规则写入开机自启脚本以保证重启后仍生效。规则持久化方式因发行版而异，请参考对应系统文档。

## 验证方法

- 检查服务监听状态，确认新端口处于监听：`ss -lntp` 或 `netstat -lntp`。
- 从本机与远端分别测试连通性，确认访问入口可达。
- 登录 Web 界面并触发一次常规业务操作，确认接口调用正常。
- 查看服务日志，确认无端口绑定失败或连接被拒绝的记录。

## 回退建议

- 恢复备份的配置文件或启动脚本，重启服务。
- 若使用重定向规则，删除对应规则并重新加载防火墙配置。
- 确认回退后原端口可正常访问，再通知相关使用方。

## 常见问题

- 修改后无法访问：多为防火墙或安全组未放行新端口，或反向代理仍指向旧端口。
- 配置未生效：检查是否存在命令行参数覆盖、配置文件路径错误或服务未真正重启。
- 升级后端口恢复默认：源码修改方式会被覆盖，建议改用配置文件方式。
- 多实例端口冲突：为每个实例分配独立端口，并分别配置对应访问入口。
