最新 Odoo 配置文件(conf)详细解释
以下是对最新 Odoo 配置文件 odoo.conf 中各个设置的详细说明,有助于用户进行 Odoo 系统的配置。
通用配置
配置项 | 说明 |
---|---|
addons_path | Odoo 查找 addons 模块的路径,可以配置多个路径,路径之间用逗号分隔。例如:/home/odoo/odoo-18/odoo/addons,/home/odoo/odoo-18/addons,/home/odoo/odoo-18/custom。Odoo 会按照指定的顺序在这些路径中查找模块。 |
admin_passwd | 数据库管理密码,用于执行创建、还原和备份数据库等重要操作。建议设置一个强密码以保障系统安全。 |
data_dir | 数据目录,用于存放 session 数据、附件、缓存文件等。确保该目录有足够的磁盘空间和合适的读写权限。例如:/home/odoo/.local/share/Odoo。 |
csv_internal_sep | CSV 文件的内部分隔符,默认使用逗号 ,。在导入或导出 CSV 文件时,Odoo 会根据此分隔符来解析数据。 |
数据库相关配置
配置项 | 说明 |
---|---|
db_host | 数据库主机名。设置为 False 表示使用默认值,通常是本地主机 localhost。如果数据库位于其他服务器上,需要指定该服务器的 IP 地址或域名。 |
db_port | 数据库端口号。设置为 False 表示使用默认端口,例如 PostgreSQL 的默认端口是 5432。 |
db_user | 数据库用户名。用于连接数据库的用户账号。设置为 False 时,可能需要通过其他方式进行身份验证。 |
db_password | 数据库用户密码。与 db_user 对应的密码,用于安全地连接数据库。 |
db_maxconn | 数据库的最大连接数,默认值为 64。根据系统的负载和数据库性能,可以适当调整该值。 |
db_name | 指定要预加载的数据库,多个数据库名之间用逗号分隔。例如 odoo-test,Odoo 会优先加载指定的数据库。 |
db_template | 创建新数据库时使用的数据库模板,默认是 template0。模板数据库包含了新数据库的初始结构和设置。 |
dbfilter | 过滤要显示的供选择数据库名称。例如 odoo-stage-*,只有符合该模式的数据库才会在选择列表中显示。 |
邮件配置
配置项 | 说明 |
---|---|
email_from | 用于发送邮件的邮箱地址。设置为 False 时,可能需要在系统中另行配置发件人地址。 |
smtp_server | SMTP 服务器名,默认是 localhost。如果使用外部邮件服务器,需要指定该服务器的地址。 |
smtp_port | SMTP 端口号,默认是 25。不同的 SMTP 服务器可能使用不同的端口,例如 SSL 连接通常使用 465 端口。 |
smtp_ssl | SMTP 服务器是否支持 SSL 协议。设置为 True 时,使用 SSL 加密连接发送邮件。 |
smtp_user | 发送邮件的 SMTP 用户名。用于登录 SMTP 服务器进行身份验证。 |
smtp_password | 发送邮件的 SMTP 用户密码。与 smtp_user 对应的密码。 |
without_demo | 指定哪些模块不加载 demo 数据,设置为 all 表示所有模块都不加载演示数据。 |
Odoo CPU 内存配置
配置项 | 说明 |
---|---|
limit_memory_hard | 一个处理器允许使用的最大物理内存,Odoo 默认值为 2684354560 字节(即 2GB)。可以根据服务器的内存情况进行调整。 |
limit_memory_soft | 一个处理器允许使用的最大虚拟内存。当达到该限制时,Odoo 可能会尝试释放一些内存。 |
limit_request | 一个处理器接受的最大请求数,默认值为 8192。该值影响系统处理并发请求的能力。 |
limit_time_cpu | 一个请求最多占用多少处理器时间,单位为秒,默认值是 60 秒。超过该时间的请求可能会被中断。 |
limit_time_real | 一个请求允许的最长实时时间,单位为秒,默认值是 240 秒。用于限制请求的总执行时间。 |
Odoo 日志配置
配置项 | 说明 |
---|---|
list_db | 是否允许显示数据库列表。设置为 True 时,用户可以在登录界面看到可用的数据库列表。 |
log_db | 是否将日志写入数据库的 ir_logging 表。设置为 True 时,日志信息会存储在数据库中。 |
log_handler | 设置模块的日志级别,可以是一组 module:log_level 对,默认值是 :INFO,表示所有模块的默认日志级别为 INFO。例如 sale:DEBUG 表示销售模块的日志级别为 DEBUG。 |
log_level | 日志的级别,可选值有 debug_rpc_answer、debug_rpc、debug、debug_sql、info、warn、error、critical。设置为 warning 时,只记录警告及以上级别的日志。 |
logfile | 指定用来存储日志的文件路径,例如 /var/log/odoo/odoo-server.log。确保该文件所在目录有足够的磁盘空间和合适的读写权限。 |
logrotate | 是否按天存放日志。设置为 True 时,日志文件会按天进行轮转,便于管理和查看。 |
其它配置
配置项 | 说明 |
---|---|
longpolling_port | 长连接池使用的端口号。当设置了此值后,系统以 gevent 模式运行在指定的端口下,例如 8072。 |
max_cron_threads | 处理当前计划任务的最大线程数,默认值为 2。根据系统的负载和计划任务的数量,可以适当调整该值。 |
osv_memory_age_limit | 强制保存在 virtual osv_memory 表中的记录的最长时间,单位为小时,默认值是 1.0 小时。超过该时间的记录会被清理。 |
osv_memory_count_limit | 强制一个 virtual osv_memory 表的最大记录数。设置为 False 表示不限制记录数。 |
pg_path | 数据库可执行文件的路径,设置为 None 时,Odoo 会尝试自动查找。如果数据库可执行文件不在系统的默认路径中,需要指定该路径。 |
pidfile | 存储服务器进程 ID 的文件名。设置为 None 时,不保存进程 ID 文件。 |
proxy_mode | 是否使用反向代理模式。设置为 True 时,Odoo 会处理反向代理传递的请求。 |
reportgz | 是否压缩报表。设置为 True 时,生成的报表会进行压缩,以减少存储空间和传输时间。 |
secure_cert_file | 指定用于 SSL 连接的证书文件,例如 server.cert。在使用 HTTPS 协议时需要配置该文件。 |
secure_pkey_file | 指定用于 SSL 连接的主密钥文件,例如 server.pkey。与 secure_cert_file 配合使用,确保 SSL 连接的安全性。 |
server_wide_modules | server 范围的模块,以逗号分隔,例如 base,web。这些模块会在服务器启动时加载。 |
syslog | 是否把日志发送给系统日志服务器。设置为 True 时,Odoo 的日志信息会发送到系统日志服务器进行集中管理。 |
test_commit | 是否提交 YAML 或 XML 测试造成的数据库更改。设置为 True 时,测试过程中的数据库更改会被提交。 |
test_enable | 是否允许 YAML 和单元测试。设置为 True 时,可以运行 YAML 和单元测试。 |
test_file | YML 测试文件的路径。设置为 False 时,不指定测试文件。 |
test_report_directory | 报表的范例的存放位置。设置为 False 时,不指定存放位置。 |
timezone | 为系统提供一个参照的时区。设置为 False 时,使用系统默认时区。 |
translate_modules | 哪些模块可翻译,默认为 ['all'],表示所有模块都可以进行翻译。 |
unaccent | 是否使用数据库的 unaccent 功能。设置为 True 时,在查询时会忽略重音符号。 |
without_demo | 在安装时哪些模块不加载演示数据。设置为 False 表示加载演示数据。 |
workers | 要使用的处理器数量。设置为 None 时,Odoo 会根据系统的 CPU 核心数自动调整。 |
XML-RPC 相关配置
配置项 | 说明 |
---|---|
xmlrpc | 是否允许使用 XML-RPC 协议(即是否启用 http 服务),默认为 True。设置为 False 时,禁止使用 XML-RPC 协议。 |
xmlrpc_interface | 指定使用 XML-RPC 协议的 IP 地址,为空时表示绑定到现有 IP。例如可以指定为特定的 IP 地址,限制只有该 IP 可以访问 XML-RPC 服务。 |
xmlrpc_port | XML-RPC 协议使用的 TCP 端口,默认是 8069。可以根据需要修改该端口号。 |
xmlrpcs | 是否允许使用 XML-RPC 安全协议,默认为 True。设置为 False 时,禁止使用 XML-RPC 安全协议。 |
xmlrpcs_interface | 指定使用 XML-RPC 安全协议的 IP 地址,为空时表示绑定到现有 IP。与 xmlrpc_interface 类似。 |
xmlrpcs_port | XML-RPC 安全协议使用的 TCP 端口,默认是 8071。同样可以根据需要修改该端口号。 |