在 Debian 系统(尤其是轻量级服务器如 VPS)上安装 Docker,推荐采用官方提供的 Docker CE(Community Edition)方案,既稳定又便于维护。以下是完整、简洁的安装步骤:
✅ 前提条件
- Debian 11/12(Bookworm/Bullseye)或更新版本
- root 权限或
sudo访问权限 - 网络连接正常
🔧 安装步骤
1. 更新系统并安装依赖
sudo apt update && sudo apt upgrade -y
sudo apt install -y ca-certificates curl gnupg lsb-release
2. 添加 Docker 官方 GPG 密钥与仓库
# 创建 keyrings 目录(Debian 12+ 推荐方式)
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg |
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 设置仓库源(自动适配当前发行版)
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg]
https://download.docker.com/linux/debian $(lsb_release -cs) stable" |
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
💡 若使用旧版 Debian(如 Buster),可将
$(lsb_release -cs)替换为bullseye或buster。
3. 安装 Docker Engine、CLI 和 Containerd
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
4. 验证安装
# 检查服务状态
sudo systemctl status docker
# 运行测试容器(需联网拉取镜像)
sudo docker run hello-world
✅ 若看到欢迎信息,说明安装成功。
🚀 可选优化(轻量服务器推荐)
▶ 非 root 用户运行 Docker(避免频繁用 sudo)
sudo usermod -aG docker $USER
# 生效新组:退出重新登录,或执行
newgrp docker
▶ 启用 Docker Compose(已包含在插件中)
docker compose version # 注意是 `compose` 而非 `docker-compose`
▶ 调整资源限制(可选)
编辑 /etc/docker/daemon.json:
{
"storage-driver": "overlay2",
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
},
"data-root": "/var/lib/docker"
}
然后重启:
sudo systemctl restart docker
⚠️ 注意事项
- 轻量服务器建议禁用 swap(Docker 默认要求无 swap):
sudo swapoff -a sudo sed -i '/ swap / s/^(.*)$/#1/' /etc/fstab - 防火墙:确保 2375(不安全)或仅通过 SSH 隧道访问;生产环境不要开放 Docker API。
- 定期更新:
sudo apt update && sudo apt upgrade docker-ce*
需要我提供自动化脚本(含错误处理)或针对特定场景(如 Kubernetes + Docker、Portainer 部署)的配置示例吗?
PHPWP博客