登录

minikube

kubernetesApache-2.0活跃维护

在本地一键拉起单节点 Kubernetes 集群，方便开发调试和 CI 环境验证，不用连远程集群。

Run Kubernetes locally

v1.39.0发布于 2026-09-02 21:09 UTC32,232star +4 / 7 天5,386fork同步于 2026-11-10 17:21 UTC
本地集群Kubernetes容器编排开发环境单节点
对比 GitHub 官网clustercncfcontainersgokubernetes

怎么上手

由 README 提炼，执行前请确认
原文 
minikube start
minikube dashboard
硬件要求按 README 说明

README 未说明具体 CPU/内存/显存要求；支持 macOS、Linux、Windows，并支持 NVIDIA 与 AMD GPU 用于机器学习场景。

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

在 macOS、Linux、Windows 上本地跑一个完整 Kubernetes 集群，方便开发调试

在本地一键拉起单节点 Kubernetes 集群，方便开发调试和 CI 环境验证，不用连远程集群。

核心能力

  • 用 minikube start 一键拉起本地单节点集群
  • 用 minikube tunnel 暴露 LoadBalancer 类型服务
  • 用 minikube service 访问 NodePort 服务
  • 用 minikube start -p <name> 创建多集群
  • 支持 NVIDIA 与 AMD GPU 用于机器学习

容易踩的坑

安装步骤 README 只给了官网 Getting Started 链接，需按官方文档选择对应平台安装方式；首次启动需拉取 Kubernetes 镜像，网络受限时容易失败；在 GitHub Codespace 中需先启动 Codespace 再执行 minikube start。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v1.39.0
全部 release
  1. v1.39.0最新正式版2026-09-02 · 2026-09-02 21:09 UTC

    📣😀 Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! 💃🎉

    Release Notes

    Version 1.39.0 - 2026-09-01

    Highlights

    • Add support for Kubernetes v1.36 and v1.37 (default: v1.37.0)
    • Default container runtime is now containerd
    • Add Traefik Helm-based ingress addon
    • VirtualBox driver now supports Apple Silicon (VirtualBox 7.1+)

    Features

    • Add support for Kubernetes v1.36 and v1.37 (default: v1.37.0) (#23567, #23596)
    • Add Traefik Helm-based addon (#23225)
    • Add Helm to minikube ISO (#23420)
    • Upgrade default guest Helm client to Helm 4 (#23383)
    • Add configurable DNS servers for VM drivers (#23069)
    • Add --mdns flag to enable mDNS on every VM start (#22964, #23208)
    • drivers: Use deterministic MAC addresses (#23172)
    • vfkit: Auto-select vmnet-shared network when available (#23040)
    • virtualbox: Support darwin/arm64 with VirtualBox 7.1+ (#22861)
    • ISO: Add systemd-coredump for crash stack traces (#23064)
    • ISO: Enable kernel nftables (CONFIG_NF_TABLES) for knftables consumers (#23518)
    • ISO: Enable securityfs for Calico 3.32.2 (#23592)
    • ISO: Include openvswitch kernel module for aarch64 (#23151)
    • ISO: Enable CONFIG_TASK_IO_ACCOUNTING and related kernel options (#23271)
    • infra: Download preloads from GitHub as default and GCS as failover (#23087)

    Performance

    • drivers: Start VM drivers in parallel (#23112)
    • Add --vmnet-offloading start flag for krunkit driver (#22962)
    • ssh: Prefer AES-GCM ciphers for external SSH client (#23125)
    • ssh: Avoid unneeded sleep when waiting for SSH server (#23001)

    Bug fixes

    • addons: Fix Helm verification failure inside guest VMs (#23253, #23329)
    • Fix kubectl exec with cri-dockerd on Kubernetes v1.36+ by disabling ExtendWebSocketsToKubelet (#22921)
    • Fix --extra-config=etcd.* producing invalid kubeadm config (#23051)
    • Fix logic for multi-node CNI warning. (#22779)
    • Fix SSHRunner ExitCode always returning 0 for SSH commands (#23364)
    • Fix usage string for minikube node commands. (#22775)
    • kvm: Check libvirt group membership before running virsh (#23369)
    • Fix preserve tag for registry refs with a port (#23228)
    • Use buffered channels to prevent goroutine leak on status timeout (#23215)
    • Fix warning against virtualb
  2. v1.38.12026-02-19 · 2026-02-19 19:41 UTC
    查看更新说明

    📣😀 Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! 💃🎉

    Release Notes

    Version 1.38.1 - 2026-02-19

    Feature

    • Add Support for Kubernetes version v1.35.1 (#22665)

    Bug fixes

    • Fix lock file regression by appending UID to the lock driectory (#22623)
    • Fix regression cross-arch execution by masking systemd-binfmt (#22621)
    • Fix: PowerShell curl alias on Windows to check resgistry.k8s.io connectivity (#22659)

    Addons

    • Addon cloud-spanner: Update cloud-spanner-emulator/emulator image from 1.5.47 to 1.5.49 (#22637)
    • Addon Headlamp: Update Headlamp image from v0.39.0 to v0.40.0 (#22640)
    • Addon ingress: Update ingress-nginx/controller image from v1.14.1 to v1.14.2 (#22595)
    • Addon ingress: Update ingress-nginx/controller image from v1.14.2 to v1.14.3 (#22638)
    • Addon inspektor-gadget: Update inspektor-gadget image from v0.48.0 to v0.48.1 (#22592)
    • Addon inspektor-gadget: Update inspektor-gadget image from v0.48.1 to v0.49.1 (#22634)
    • Addon metrics-server: Update metrics-server/metrics-server image from v0.8.0 to v0.8.1 (#22596)
    • Addon nvidia-device-plugin: Update nvidia/k8s-device-plugin image from v0.18.1 to v0.18.2 (#22531)
    • Addon registry: Update registry image from 3.0.0 to 3.0.0 (#22593)
    • Addon Volcano: Update volcano images from v1.13.1 to v1.14.0 (#22597)
    • Addon Volcano: Update volcano images from v1.14.0 to v1.14.1 (#22663)
    • Addon yakd: Update manusa/yakd image from 0.0.7 to 0.0.8 (#22639)
    • HA (multi-control plane): Update kube-vip from v1.0.3 to v1.0.4 (#22598)

    CNI

    • CNI: Update cilium from v1.18.6 to v1.19.0 (#22636)
    • CNI: Update flannel from v0.27.4 to v0.28.1 (#22635)
    • CNI: Update kindnetd from v20251212-v0.29.0-alpha-105-g20ccfc88 to v20260131-0806d083 (#22594)
    • CNI: Update kindnetd from v20260131-0806d083 to v20260213-ea8e5717 (#22661) For a more detailed changelog, including changes occurring in pre-release versions, see CHANGELOG.md.

    Thank you to our contributors for this release!

    • Bob Sira
    • Mateusz Łoskot
    • Medya Ghazizadeh
    • minikube-bot
    • Rachel Rice

    Thank you to our PR reviewers for this release!

    • nirs (8 comments)
    • wt (5 comments)
    • medyagh (2 comments)
    • mloskot (2 comments)

    Thank you to our triage members for this release!

    • nirs (8 comments)
    • sleonov (5 comments)
    • afbjorklund (4 comments)
    • medyagh (4 comments)
    • saschpe (3 comments)

    Check out our contributions leaderboard for this release!

    Installation

    See Getting Started

    Binary Checksums

    darwin-amd64: db11dffba835609988e4e98c3a91a38653ce66ddfa8ea3aaea92d87c54a0a348 darwin-arm64: `f9b0c70bb7daf38c6

  3. v1.38.02026-01-29 · 2026-01-29 07:22 UTC
    查看更新说明

    📣😀 Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! 💃🎉

    Release Notes

    Version 1.38.0 - 2026-01-28

    Higlights

    • No Sudo required for vfkit/krunkit on macOS 26+ (requires latest vmnet-helper)
    • No Sudo required to run AI Playground on Macos GPUs using minikube
    • vfkit: Add Rosetta support for deploying amd64 images on Apple silicon (#22140)

    Features

    • Add support for Kubernetes v1.35.0 (#21650)(#22015)(#22119)(#22328)
    • VM Drivers: add support for NVMe-oF/TCP block devices (#22464)
    • VM Drivers: Enable BTF debug symbols to support eBPF tooling in iso (#21800)
    • Add option to download preloads from github instead of GCS through --preload-source (#22221)
    • Vfkit/Krunkit drivers: add ability to Run vmnet-helper as unprivileged user on macOS 26+ (#22501)
    • add option to add helm-based addons (#21847)
    • preload: download from github when gcs not available (#21605)

    Warnings & Deprecations

    • UI: Add a warning on changing default runtime to "containerd" in the next version (v1.39.0) (#22508)
    • hyperkit: remove driver builds & warn users to switch (#21946)
    • Remove minikube support for 32-bit architectures (#22401)

    Improvements

    • UI: colorful based on status (profile list, addons list) (#22418)
    • Skip caching binaries when --no-kubernetes is set (#21139)
    • improve retry logs to print less duplicate lines (#22232)
    • improve ssh runner copying cert files (#21923)
    • vmnet: Skip validation in download-only mode (#21635)
    • Improve windows cert in kubeconfig: normalize generated cert paths to forward slashes (#21845)
    • Add cgroup v2 freezer check for API server status (#22249)
    • Set FailCgroupV1 kubelet option for kubenetes 1.35+ if cgroup v1 (#22319)
    • containerd: retry on transient EOF errors for image load (#22310)
    • cri: increase default 2s timeout for crictl commands (#22214)
    • crio: verify images are deleted after "image rm" (#22243)
    • docker runtime: Use CRI for ListImages function (#22263)
    • image save: Add retry logic for local image in case of EOF (#22072)
    • HA (multi-control plane): Update kube-vip from v1.0.0 to v1.0.3 (#21699)(#21960)(#22258)

    Drivers

    • drivers: Introduce WaitForSSHAccess and fix macos smoke tests (#22179)
    • hyperkit driver: Fix file descriptor leaks in status (#22524)
    • kvm: fix minikube on Fedora/RHEL with SELinux (#21550)
    • kvm: remove dependency on external driver (#21625)
    • Mark the legacy parallels driver as deprecated (#22379)
    • none driver: Fix "stop" with containerd runtime (#22275)
    • Update minikube-machine drivers (#22369)
    • verify aux drivers installed correctly and exit nicely if not (#21576)
    • vfkit: Add Rosetta support for deploying amd64 images on Apple silicon (#22140)
    • VM: Enable cgroup v2 by using "systemd cgroup driver" for Kubernetes… (#22320)

    Bug fixes

    • KIC Drivers: fix docker driver with crio runtime: install dbus (#21724)
    • fix: correctly detect nested VMs on macOS and remove timeout multiplier (#22277)
    • fix: Increase timeout for containerd image list (#22558)
    • fix: kubevirt addon by removing curl dependency (#22557)
    • fix: return non-zero exit code when status unavailable (#22494)
    • crio: fix ingress by enabling hostNetwork and ClusterFirstWithHostNet (#22239)
    • crio: fix preload overwriting user images (#22246)
    • Fix Podman mount on macOS by adding host.containers.internal support (#22451)
    • Fix the cri-dockerd version upgrade script (#22358)
    • fix kubelet config option FailCgroupV1 to failCgroupV1 (#22325)
    • addon registry-creds: Fix segfault without config file (#21786)

    UI

    • Add support for Kurdish language through LANGUAGE=ku (#22512)
    • Add support for Ukrainian language through LANGUAGE=uk (#21624)
    • Improve french translation (#21559)(#21849)(#22155)(#22386)(#
  4. v1.37.02025-09-09 · 2025-09-09 21:54 UTC
    查看更新说明

    📣😀 Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! 💃🎉

    Release Notes

    Version 1.37.0 - 2025-09-09

    Highlight

    Run AI workloads on Macbook's GPU in Kubernetes using the new krunkit driver. Get started with our AI Playground tutorial

    Features

    • Add Support for Kubernetes v1.34.0 (#21439)
    • Add krunkit driver supporting GPU acceleration on macOS (#20826) Tutorial
    • add short hand -m for --memory (#20854)
    • Add support to docker runtime for OCI access to NVIDIA GPUs (#20959)
    • Add --disable-coredns-log flag to suppress coredns logs (#20992)
    • new addon: kubetail (#20345)
    • drivers: Add support for Virtiofs mounts for vfkit and krunkit (#21149)

    Improvements

    • Improve ingress-dns addon for ipv4 and windows v0.0.4 (#21449)
    • iso: Disable grub timeout speeding up vm start by 5 seconds (#20895)
    • improve docker service reliability, update docker systemd files (#21174)
    • Don't require both --mount for using --mount-string and remove default mount-string (#21250)
    • Update oldest supported Kubernetes versions (#21490)
    • license cmd: don't fail if output dir doesn't exist & download from github assets first (#21206)
    • remove deprecated proxy-refresh-interval v2 etcd flag (#21278)
    • vmnet: Support offloading for krunkit (#20831)
    • Don't call startKicServiceTunnel for non-kic drivers (#20863)
    • krunkit: Disable offloading for faster networking (#21341)
    • HA (multi-control plane): Update kube-vip from v0.9.1 to v1.0.0 (#20999)(#21228)

    Depreciation

    • Deprecate HyperKit driver with warning (#21024)

    Bug fixes

    • fix dirty commit version (#21062)
    • Fix minikube image load on windows (#20529) (#20921)
    • Fix mount to same folder causing Input/output error (#21077)
    • fix: YAML file escape error problem affecting addons (#20904)
    • iso: Fix minikube stop with vfkit and krunkit drivers (#21089)
    • iso: Fix console for vfkit/krunkit (#20832)

    Addons

    • Addon nvidia-device-plugin: Update nvidia/k8s-device-plugin image from v0.17.2 to v0.17.3 (#21225)
    • Addon cloud-spanner: Update cloud-spanner-emulator/emulator image from 1.5.34 to 1.5.41 (#20976)(#21040)(#21243)(#21287)(#21359)(#21512)
    • Addon Headlamp: Update Headlamp image from v0.28.0 to v0.34.0 (#21238)(#21508)
    • Addon ingress: Update ingress-nginx/controller image from v1.12.2 to v1.13.2 (#20909)(#21232)(#21353)(#21458)
    • Addon inspektor-gadget: Update inspektor-gadget image from v0.40.0 to v0.44.1 (#20873)(#21038)(#21240)(#21462)(#21510)(#21358)
    • Addon kong: Update kong image from 3.9.0 to 3.9.1 (#20966)(#21503)
    • Addon kong: Update kong/kubernetes-ingress-controller image from 3.4.5 to 3.5.1 (#20908)(#20969)(#21034)(#21282)
    • Addon kubevirt: Update bitnami/kubectl image from 1.33.1 to 1.33.4 (#20911)(#20939)(#21235)(#21283)(#21414)
    • Addon metrics-server: Update metrics-server/metrics-server image from v0.7.2 to v0.8.0 (#21033)
    • Addon registry: Update registry image from 3.0.0 to 3.0.0 (#21242)
    • Addon Volcano: Update volcano images from v1.11.2 to v1.12.2 (#20868)(#21351)
    • Addon kubetail: update version 0.13.3 (#21244)

    CNI versions

    • CNI: Update calico from v3.30.0 to v3.30.3 (#20871)(#20971)(#21416)
    • CNI: Update cilium from v1.17.4 to v1.18.1 (#20968)(#21226)(#21349)
    • CNI: Update flannel from v0.26.7 to v0.27.0 (#20907)(#21230)(#21504)

    Base image versions

    • iso: Update to longterm kernel to 6.6.95 (#20995)
    • iso: Enable VirtioFS for x86_64 and aarch64 (#21147)
    • iso: Improve build and clean up configuration (#20991)
    • Kicbase/ISO: Update cni-plugins from v1.7.1 to v1.8.0 (#21517)
    • Kicbase/ISO: Update crun from 1.19 to 1.23.1 (#21198)(#21330)
    • Kicbase/ISO: Update docker from 28.0.4 to 28.4.0 (#21053)(#21248)(#21488)
  5. v1.36.02025-05-22 · 2025-05-22 18:26 UTC
    查看更新说明

    📣😀 Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! 💃🎉

    Release Notes

    Version 1.36.0 - 2025-05-22

    Features

    • Support Kubernetes version v1.33.1 #20784
    • New flag "-f" to allow passing a config file for addon configure command. #20255
    • vfkit: bump to Preferred driver on macOs #20808
    • vfkit: new network option "--network vment-shared' for vfkit driver #20501

    Bug Fixes:

    • fix bootpd check on macOS >= 15 #20400
    • fix bug in parsing proxies with dashes #20648
    • fix waiting for all pods having specified labels to be Ready #20315
    • fix: incorrect finalImg affecting downloading kic form github assets #20316
    • fix: reference missing files in schema (Closes #20752) #20761 Improvements:
    • Additional checks for 9p support #20288
    • vfkit: Graceful shutdown on stop #20504
    • vfkit: More robust state management #20506
    • vfkit vmnet: support running without sudoers configuration #20719
    • Revert "fix --wait's failure to work on coredns pods" #20313

    Languages:

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    minikube

    Actions Status GoReport Widget GitHub All Releases Latest Release Try minikube in the browser (needs github login)

    minikube implements a local Kubernetes cluster on macOS, Linux, and Windows. minikube's primary goals are to be the best tool for local Kubernetes application development and to support all Kubernetes features that fit.

    Features

    minikube runs the latest stable release of Kubernetes, with support for standard Kubernetes features like:

    As well as developer-friendly features:

    For more information, see the official minikube website

    Installation

    See the Getting Started Guide

    :mega: Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! :dancers:

    GitHub Codespace

    You can run minikube in a GitHub Codespace by clicking here: Open in GitHub Codespaces

    This will launch a Github Codespace. You can then run minikube start and minikube dashboard - You can then open Minikube Dashboard by clicking the link displayed in the terminal.

    You can also run Minikube in a Dev Container locally using your favorite IDE, for more information see Dev Containers https://code.visualstudio.com/docs/devcontainers/containers

    Documentation

    See https://minikube.sigs.k8s.io/docs/

    More Examples

    See minikube in action in the controls handbook

    Governance

    Kubernetes project is governed by a framework of principles, values, policies and processes to help our community and constituents towards our shared goals.

    The Kubernetes Community is the launching point for learning about how we organize ourselves.

    The Kubernetes Steering community repo is used by the Kubernetes Steering Committee, which oversees governance of the Kubernetes project.

    Community

    minikube is a Kubernetes #sig-cluster-lifecycle project.

    Join our community meetings:

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    kubernetes
    kubernetes·Go

    生产级的容器编排与调度平台，用来自动化部署、扩缩容和管理跨主机的容器化应用。

    容器编排+4容器 / Kubernetes
    128976+9645kv1.37.22026-11-10 17:04 UTC
    uptime-kuma
    louislam·JavaScript

    自托管的网站与服务可用性监控面板，支持 HTTP、TCP、Ping 等多种探活方式，通过实时图表和告警通知掌握服务宕机情况。

    可用性监控+4容器 / Kubernetes
    93454+1198.7k2.5.92026-11-10 04:49 UTC
    mall
    macrozheng·Java

    基于 Spring Boot + MyBatis 的完整电商系统，含前台商城和后台管理，覆盖商品、订单、会员、促销等模块，用 Docker 容器化部署。

    电商系统+4容器 / Kubernetes
    85031+1930kv1.0.32026-09-15 02:34 UTC
    moby
    moby·Go

    构建容器化系统的开源协作项目，提供可拼装的组件，用来搭建和定制自己的容器平台，也是 Docker 的上游基础。

    容器引擎+3容器 / Kubernetes
    72363+1019kdocker-v29.9.32026-11-10 16:48 UTC