Runner 运行环境

硬件

设备推荐配置	部署对象
4 核 4G，30G 磁盘空间	自托管 Runner

CPU: 由于 Runner 会并发执行定时任务，所以 CPU 至少 2 核，推荐 4 核或以上。

内存: 由于 Runner 执行定时任务时会加载和生成大量数据，所以内存至少为 4GB，对于更大规模的团队数据需要 8GB 或者更高。

磁盘空间: 考虑到需要存储日志信息，建议至少提供 30GB 的磁盘空间。

运行参数

参数名	参数描述	示例值
TZ	配置 Runner 的执行时区，定时任务会根据配置的时区和时间运行，可以参考 TZ identifier 进行配置。	America/Los_Angeles

容器运行用户与 runAsNonRoot

从 Runner 2.2.5 版本开始，镜像内置非 root 用户 runner，固定 UID/GID 为 10001:10001，用于支持更安全的非 root 运行方式。

默认启动方式下，容器会先以 root 执行入口脚本，准备 /opt/runner 目录权限后，再降权为 runner 用户运行主进程。这可以兼容历史 volume 权限，避免日志、变量文件等运行时数据无法写入。

如果部署平台强制启用 runAsNonRoot，请将容器安全上下文配置为：

启用后，入口脚本无法再执行 mkdir 或 chown。因此，挂载到 /opt/runner 的 hostPath、PVC 或其他 volume 必须提前授予 UID/GID 10001 写权限。Runner 会在 /opt/runner/logs、/opt/runner/variables
等目录写入运行时数据，如果权限不足，可能导致任务执行失败或日志无法写入。

使用 hostPath 时，可以提前在宿主机执行：

如果没有强制要求启用 runAsNonRoot，建议保持默认启动方式。

网络环境

Runner 需要与服务端进行通信，运行 Runner 的服务器网络环境至少需要能访问到 Apifox 服务器和支持 Websocket 协议。

对于自动化测试的定时任务，请确保 Runner 的服务器网络环境能访问到所有请求的 URL，以便能够正常发起请求；运行完自动化测试后会上传测试报告，请确保服务器网络环境能访问阿里云域名。

对于导入数据的定时任务，需要确保运行 Runner 的服务器网络环境能访问到导入数据源的 URL。

硬件#

运行参数#

容器运行用户与 runAsNonRoot#

网络环境#

硬件

运行参数

容器运行用户与 runAsNonRoot

网络环境