Docker + Minikube 安装

🐳 Ubuntu 22.04：Docker + Minikube 国内环境安装 (2026)

环境： Ubuntu 22.04 (amd64)
目标： Docker 驱动运行 Minikube

---

🧩 为啥写这个？

在 Ubuntu 上从零到跑通 Minikube 并不难，但“国内网络”+“权限问题”+“驱动冲突”这三座大山能让新手折腾一下午。

---

第一步：安装 Docker —— 绕过官方源

1. 清理残留与冲突

如果 sudo apt update 报错 Conflicting values set for option Signed-By，说明你之前的源定义重复了：

sudo rm -f /etc/apt/sources.list.d/docker.sources
sudo rm -f /etc/apt/sources.list.d/docker.list

2. 使用阿里云镜像源安装

官方 download.docker.com 经常超时，换成阿里源是标准操作：

# 安装基础依赖
sudo apt update && sudo apt install -y ca-certificates curl gnupg lsb-release

# 添加阿里云 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL [https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg](https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg) | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 写入阿里云软件源
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] [https://mirrors.aliyun.com/docker-ce/linux/ubuntu](https://mirrors.aliyun.com/docker-ce/linux/ubuntu) $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list

# 安装 Docker 引擎
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

---

第二步：免 sudo 权限配置

为了避免每次敲 sudo docker，将当前用户加入 docker 组：

sudo usermod -aG docker $USER

# 【关键】立即刷新权限，无需重登
newgrp docker 

验证：输入 docker run hello-world，看到 "Hello from Docker!" 即可。

---

第三步：安装 Minikube 并启动

1. 下载二进制文件

curl -LO [https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64](https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64)
sudo install minikube-linux-amd64 /usr/local/bin/minikube

2. 启动集群（避坑重点）

如果之前用过其他驱动，先清理：minikube delete。

使用 Docker 驱动 并指定 国内镜像仓库（否则拉不到 K8s 核心镜像）：

minikube start --driver=docker \
  --image-repository=[registry.cn-hangzhou.aliyuncs.com/google_containers](https://registry.cn-hangzhou.aliyuncs.com/google_containers)

---

📝 避坑要点总结

环节	常见报错/现象	解决核心
APT 更新	Conflicting values set for...	删掉 /etc/apt/sources.list.d/ 下多余的 docker 文件
Docker 安装	找不到 docker-ce 或超时	必须换国内源（阿里/清华/中科大）
Minikube 启动	permission denied 连不上 sock	运行 newgrp docker 或重新登录 SSH
K8s 镜像	进度条卡死在 Pulling base image	增加 --image-repository=... 参数

---

🚀 常用运维命令

• 查看状态：minikube status
• 进入节点：minikube ssh
• 图形化面板：minikube dashboard
• 查看 Pod：kubectl get pods -A

---

🎁 附：全自动安装脚本 (setup.sh)

你可以将以下内容保存为 setup.sh，运行 bash setup.sh 即可。

Bash

#!/bin/bash
set -e

echo "🚀 开始安装 Docker (Aliyun Source)..."
sudo apt update && sudo apt install -y ca-certificates curl gnupg lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL [https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg](https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg) | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] [https://mirrors.aliyun.com/docker-ce/linux/ubuntu](https://mirrors.aliyun.com/docker-ce/linux/ubuntu) $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io

echo "🔑 配置 Docker 权限..."
sudo usermod -aG docker $USER

echo "☸️ 安装 Minikube..."
curl -LO [https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64](https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64)
sudo install minikube-linux-amd64 /usr/local/bin/minikube

echo ""
echo "✅ 安装完成！请执行以下命令启动集群："
echo "   newgrp docker"
echo "   minikube start --driver=docker --image-repository=[registry.cn-hangzhou.aliyuncs.com/google_containers](https://registry.cn-hangzhou.aliyuncs.com/google_containers)"