一、mac m1 安装 minikube
在 macOS 上安装 Minikube 的步骤如下,适用于基于 Intel 或 Apple Silicon(M1/M2/M3)芯片的机器。
✅ 1. 前提条件
brew install kubectl
✅ 2. 安装 Minikube
使用 Homebrew 安装:
brew install minikube
安装完成后,验证版本:
minikube version
✅ 3. 安装驱动程序(推荐 HyperKit 或 Docker)
Minikube 运行需要虚拟化驱动,推荐两种:
选项 A: 使用 Docker(推荐)
如果你已安装 Docker Desktop,可以直接使用它:
minikube start --driver=docker
如果未安装 Docker Desktop,可以通过 Homebrew 安装:
brew install --cask docker
open /Applications/Docker.app
选项 B: 使用 HyperKit(更轻量)
brew install hyperkit
brew install --cask minikube
minikube start --driver=hyperkit
注:首次运行 HyperKit 驱动时可能需要额外权限或安装 helper。
✅ 4. 启动 Minikube
示例命令(默认使用 docker 驱动):
minikube start --driver=docker
你可以指定资源:
minikube start --driver=docker --cpus=4 --memory=6g
✅ 5. 验证集群状态
kubectl get nodes
应看到状态为 Ready 的节点。
✅ 6. 常用命令
minikube stop # 停止集群
minikube delete # 删除集群
minikube dashboard # 启动 Web UI 仪表盘
minikube status # 查看状态
minikube ssh # 登录虚拟机内部
🧠 补充:Apple Silicon 用户注意
Minikube 和 Docker 均支持 Apple Silicon,但镜像可能需使用 ARM 架构(或设置镜像策略)
启动失败可添加调试参数:
minikube start --driver=docker --container-runtime=containerd --output=go
如果你有安装失败、网络问题、镜像拉取慢的问题,我可以帮你配置国内镜像源或者使用 Aliyun 镜像加速,随时说一声。需要我继续帮你搭一个 demo 应用跑在 Minikube 上吗?
二、mac M1 系统上运行 amd64 二进制文件报错
(base) changyou@192 ~ % minikube start --driver=docker --container-runtime=containerd --output=go
╭────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ │
│ 你正在尝试在 M1 系统上运行 amd64 二进制文件。 │
│ 请考虑改用 darwin/arm64 二进制文件。 │
│ 下载地址:https://github.com/kubernetes/minikube/releases/download/v1.36.0/minikube-darwin-arm64 │
│ │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────╯
😄 Darwin 15.5 上的 minikube v1.36.0
✨ 根据用户配置使用 docker 驱动程序
💣 因 PROVIDER_DOCKER_INCORRECT_ARCH 错误而退出:Cannot use amd64 minikube binary to start minikube cluster with Docker driver on arm64 machine
💡 建议:Download and use arm64 version of the minikube binary
📘 文档:https://minikube.sigs.k8s.io/docs/start/
解解方法:
下载minikube-darwin-arm64,这是适用于 macOS M 系列(ARM 架构)的 Minikube 可执行文件。下面是手动安装到系统的标准流程:
✅ 安装步骤(终端操作)
1️⃣ 赋予执行权限
假设你下载的文件在 Downloads 目录:
chmod +x ~/Downloads/minikube-darwin-arm64
2️⃣ 移动到系统路径(安装)
sudo mv ~/Downloads/minikube-darwin-arm64 /usr/local/bin/minikube
/usr/local/bin 是 macOS 下的系统可执行路径,放进去后全局可用。
✅ 验证安装
minikube version
应该输出类似:
minikube version: v1.36.0
commit: ...
🧠 补充建议(可选)
🔁 如果之前通过 brew 安装过 x86_64 版本,请先卸载
brew uninstall minikube
然后再执行上述手动安装流程,避免路径冲突。
✅ 后续:启动 Minikube
确保 Docker Desktop 已经启动(并解决了 docker CLI 的路径问题),然后你可以启动:
minikube start --driver=docker
也可以指定资源或容器运行时:
minikube start --driver=docker --container-runtime=containerd --cpus=4 --memory=6g