配置

配置集群

基本配置

大多数 minikube 配置是通过命令行参数接口完成的。要查看 start 命令支持哪些参数,请运行

minikube start --help

持久化配置

minikube 允许用户使用 minikube config 命令持久化存储新的默认值,以便在所有配置文件中使用。这通过提供属性名称和属性值来实现。

例如,要持久配置 minikube 使用 hyperkit

minikube config set driver hyperkit

您可以使用以下命令获取可配置字段的完整列表

minikube config --help

要获取当前设置的配置属性列表

minikube config view

Kubernetes 配置

minikube 允许用户使用任意值配置 Kubernetes 组件。要使用此功能,您可以在 minikube start 命令上使用 --extra-config 标志。

此标志是可重复的,因此您可以多次传递它以设置多个选项。

选择 Kubernetes 版本

默认情况下,minikube 会安装 minikube 发布时可用的最新稳定版 Kubernetes。您可以使用 --kubernetes-version 标志选择不同的 Kubernetes 版本,例如

minikube start --kubernetes-version=v1.34.0

minikube 遵循 Kubernetes 版本和版本偏差支持策略,因此我们保证支持最新 3 个次要 Kubernetes 版本的最新构建版本。在可行的情况下,minikube 也旨在支持旧版本,以便用户可以模拟旧环境。

有关受支持版本的最新信息,请参阅 constants.go 中的 OldestKubernetesVersionNewestKubernetesVersion

启用功能门

Kubernetes alpha/实验性功能可以通过 minikube start 命令上的 --feature-gates 标志启用或禁用。它采用 key=value 形式的字符串,其中 key 是 component 名称,value 是其 status

minikube start --feature-gates=EphemeralContainers=true

修改 Kubernetes 默认值

kubeadm 引导程序可以通过 minikube start 命令上的 --extra-config 标志进行配置。它采用 component.key=value 形式的字符串,其中 component 是以下字符串之一

  • kubeadm
  • kubelet
  • apiserver
  • controller-manager
  • scheduler

key=value 是要配置的组件的 flag=value 对。例如,

minikube start --extra-config=apiserver.v=10 --extra-config=kubelet.max-pods=100

例如,要允许 Kubernetes 在不受支持的 Docker 版本上启动

minikube start --extra-config=kubeadm.ignore-preflight-errors=SystemVerification

运行时配置

minikube 中的默认容器运行时是 Docker

根据您选择的驱动程序等特定因素,可能会有首选容器运行时的建议,请参阅驱动程序页面了解详情。

您可以使用以下命令显式选择容器运行时

minikube start --container-runtime=docker

可用选项是

请参阅 https://kubernetes.ac.cn/docs/setup/production-environment/container-runtimes/

环境变量

minikube 支持使用环境变量而不是标志来设置 minikube config 中列出的每个值。这是通过传递带有 MINIKUBE_ 前缀的环境变量完成的。

例如,minikube start --iso-url="$ISO_URL" 标志也可以通过设置 MINIKUBE_ISO_URL="$ISO_URL" 环境变量来设置。

专属环境调整

某些功能只能通过 minikube 特定的环境变量访问,以下是这些功能的列表

  • MINIKUBE_HOME - (string) 设置 minikube 用于状态/配置的 .minikube 目录路径。如果将其指定为 /path/to/somewheresomewhere 不等于 .minikube,则最终的 MINIKUBE_HOME 将是 /path/to/somewhere/.minikube。如果未指定,则默认为 ~/.minikube。*请注意:这仅由 minikube 使用,不影响 kubectl 等 Kubernetes 工具的任何相关内容。*

  • MINIKUBE_IN_STYLE - (bool) 手动设置 minikube 中是否应显示表情符号和颜色。设置为 false 或 0 以禁用此功能,设置为 true 或 1 以强制启用此功能。

  • CHANGE_MINIKUBE_NONE_USER - (bool) 自动将 ~/.minikube 的所有权更改为 $SUDO_USER 的值

  • MINIKUBE_ENABLE_PROFILING - (int, 1 启用) 启用为 minikube 生成跟踪配置文件

  • MINIKUBE_SUPPRESS_DOCKER_PERFORMANCE - (bool) 在 Docker 缓慢时抑制 Docker 性能警告

示例:禁用表情符号

export MINIKUBE_IN_STYLE=false
minikube start
export MINIKUBE_IN_STYLE=false
minikube start
$env:MINIKUBE_IN_STYLE=false
minikube start

使环境变量持久化

要使导出的变量在重新启动后持久化

  • Linux 和 macOS:将这些声明添加到 ~/.bashrc 或 shell 环境变量存储位置。
  • Windows:将这些声明添加到 ~\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 或在 PowerShell 终端中运行以下命令
[Environment]::SetEnvironmentVariable("key", "value", [EnvironmentVariableTarget]::User)

上次修改时间:2026 年 1 月 17 日:docs: Clarify container runtime choice (3a9154f74)