k3d 安装一次讲清：Windows、Mac、Linux 三平台跑起本地 k3s 集群

k3d 安装一次讲清Windows、Mac、Linux 三平台跑起本地 k3s 集群【免费下载链接】k3dLittle helper to run CNCFs k3s in Docker项目地址: https://gitcode.com/gh_mirrors/k3/k3d做 k3d 安装只需要几分钟。k3d 是一个跑在 Docker 里的小助手它替你把轻量级 k3s 集群的每个节点都装进容器不用碰虚拟机也不用手动折腾网络。这篇带你从装好二进制开始到跑起第一个 k3s 本地集群中途容易卡住的地方也一并给了对策。动手前的 3 行检查 ✅先确认两件事省得装到一半报错你的 Docker 版本要 ≥ 20.10.5k3d v5 依赖较新的 runc旧版本建节点时容易失败。机器上至少留 2GB 空闲内存给集群用。用下面这条命令看一眼当前版本docker versionk3d 安装最快路径一条脚本走三平台 三种系统里想只记一种装法就记这个。项目自带的install.sh会自动识别操作系统Linux / Mac / Windows和 CPU 架构amd64 / arm64然后把二进制放进 PATH 能找到的地方Linux 默认落到/usr/local/bin会请求 sudoWindows 下在 Git Bash 里运行则自动放进~/bin。脚本依赖 curl 或 wget二选一即可。git clone https://gitcode.com/gh_mirrors/k3/k3d cd k3d bash install.shk3d Windows 安装步骤多数 Windows 用户走 Chocolatey 最省事一条命令完成下载和 PATH 配置choco install k3d其余方式一句话带过装过 Git for Windows 的话直接在 Git Bash 里跑上面的install.sh也行Scoop 用户执行scoop install k3d开了 WSL2 的话直接在 WSL 里按 Linux 的方式装。k3d Mac 怎么装Homebrew 一行搞定brew install k3d没装 Homebrew 也没关系MacPorts 的port install k3d或上面的安装脚本都能顶上。k3d Linux 安装脚本之外还有包管理器最快路径里的脚本在绝大多数发行版上直接可用。Arch 用户走 AURyay -S rancher-k3d-bin。想追最新代码或打私有补丁就 clone 仓库后执行make install-tools make build自行编译。装完立刻验证 先确认二进制能跑再直接拉一个单节点集群k3d version k3d cluster create my-cluster k3d cluster list看到版本号并且my-cluster状态是 running就算装通了。用完记得执行k3d cluster delete my-cluster回收容器资源。k3d 安装报错速查 ️现象终端提示k3d: command not found。解法安装目录没进 PATH新开一个终端或把/usr/local/binWindows 是~/bin加进 PATH。现象执行 docker 相关命令时报permission denied。解法把当前用户加入 docker 用户组然后重新登录生效。现象创建集群时报 runc 或 Docker 版本相关错误。解法把 Docker 升到 20.10.5 以上再试。下一步试试k3d node create给现有集群加节点体会一下多节点玩法。服务暴露、私有 registry 这类进阶配置去项目 docs 目录下的 usage 说明里翻比记文档更快。【免费下载链接】k3dLittle helper to run CNCFs k3s in Docker项目地址: https://gitcode.com/gh_mirrors/k3/k3d创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考