OBProxy 参数说明

更新时间：2026-04-14 15:15:57

本页面为您介绍刷新 OBProxy 的参数说明。创建 OBProxy 集群时，可在 参数设置 中配置启动参数。

启动参数

创建 OBProxy 集群时，可参考如下说明配置启动参数。若未配置，系统将按照默认值创建 OBProxy。

参数名	默认值	取值范围	说明
app_name	dropship	-	Proxy 的应用服务名。
automatic_match_work_thread	true	true false	是否根据 CPU 核数自动创建工作线程。如果该选项为 true，上限为 work_thread_num。
block_thread_num	1	[1, 4]	OBProxy 阻塞型任务线程数，用于线程初始化。
bt_retry_times	-	-	已废弃，后续版本将删除该参数。
enable_cpu_topology	false	true false	是否开启 CPU 亲和，即是否把每个 worker 线程绑定到不同的 CPU 上。
enable_metadb_used	false	true false	OBProxy 运行时是否可访问 OCP 的 MetaDB。
enable_strict_kernel_release	false	true false	是否需要校验 OS kernel。取值范围： true：仅 5u/6u/7u 规格的 RedHat 操作系统支持校验。 false：不校验 OS kernel，但 Proxy 可能不稳定。
frequent_accept	true	true false	是否初始化 net accept 参数。
grpc_client_num	9	[9,16]	grpc 客户端数。
grpc_thread_num	8	[8,16]	grpc 线程数。
listen_port	2883	(1024, 65536)	OBProxy 的监听端口。
local_bound_ip	xxx.xxx.xxx.xxx	-	OBProxy 的本地 IP。
net_accept_threads	2	[0, 8]	执行 accept 的线程数。
prometheus_cost_ms_unit	false	true false	是否允许 prometheus 的成本单位为毫秒，默认为微秒。
prometheus_listen_port	2884	(1024, 65536)	OBProxy prometheus 监听端口。
proxy_id	0	[0,255]	OBProxy 的 ID，用于标识每个 OBProxy。当 proxy_service_mode 配置为 server 时，proxy_id 不可配置为 0。
proxy_service_mode	client	client server	OBProxy 的部署和服务模式。
skip_proxy_sys_private_check	true	true false	是否跳过 OBProxy 在私有网段的检查。
spool_thread_num	-	-	已废弃，后续版本将删除该参数。
stack_size	1 MB	[1 MB, 10 MB]	线程栈大小，用于创建线程。
task_thread_num	2	[1, 4]	OBProxy 任务线程数。
work_thread_num	128	[1, 128]	OBProxy 工作线程数。当 automatic_match_work_thread 为 true 时，表示最大工作线程数。