在轻量云服务器(如腾讯云轻量应用服务器、阿里云轻量服务器等)上部署 Docker 服务,使用 Debian 或 Ubuntu 系统是常见且推荐的方式。以下是详细的部署步骤:
✅ 前提条件
- 已有一台运行 Debian 或 Ubuntu 的轻量云服务器(例如:Ubuntu 20.04/22.04 或 Debian 11/12)
- 具备
sudo权限的用户 - 网络连接正常(能访问网络)
🛠️ 步骤一:更新系统包
# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y
🐳 步骤二:安装依赖工具
sudo apt install -y
ca-certificates
curl
gnupg
lsb-release
software-properties-common
🔐 步骤三:添加 Docker 官方 GPG 密钥
# 创建密钥存放目录
sudo mkdir -p /etc/apt/keyrings
# 下载并添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
⚠️ 注意:即使你使用的是 Debian,Docker 官方也建议使用 Ubuntu 的仓库,因为兼容性良好。
📦 步骤四:添加 Docker APT 仓库
echo
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu
$(lsb_release -cs) stable" |
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
💡 如果你的系统是 Debian 且
lsb_release -cs返回非 Ubuntu 发行版代号(如bookworm),你可以手动替换为相近的 Ubuntu 版本代号(如jammy),前提是架构兼容。
示例(Debian 12 使用 jammy 源):echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable" | sudo tee /etc/apt/sources.list.d/docker.list
🔄 步骤五:更新 APT 包索引并安装 Docker
sudo apt update
# 安装 Docker 引擎
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
这将安装:
docker-ce: Docker 社区版containerd.io: 容器运行时docker-compose-plugin: 支持docker compose命令(新版)
✅ 验证安装是否成功
sudo docker version
或运行测试容器:
sudo docker run hello-world
如果看到欢迎信息,说明安装成功。
👤 步骤六:(可选)配置非 root 用户使用 Docker
避免每次使用 sudo,可将当前用户加入 docker 组:
sudo usermod -aG docker $USER
然后 退出并重新登录(或重启 shell),使组权限生效。
验证:
docker version
应无需 sudo 即可运行。
🧰 步骤七:(可选)启用 Docker 开机自启
sudo systemctl enable docker
sudo systemctl start docker
🔒 安全建议(轻量云环境)
- 不要开放不必要的端口:Docker 默认监听
2375(非加密)有风险,除非需要远程 API。 - 定期更新系统和 Docker:
sudo apt update && sudo apt upgrade -y - 使用防火墙限制访问(如
ufw):sudo ufw allow OpenSSH sudo ufw enable
🌐 常见问题解决
❌ 报错:E: The repository 'https://download.docker.com/linux/ubuntu xxx Release' does not have a Release file
原因:$(lsb_release -cs) 返回的代号不被支持(如 Debian 的 bookworm)。
✅ 解决方法:手动指定一个受支持的 Ubuntu 代号(如 jammy):
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable" | sudo tee /etc/apt/sources.list.d/docker.list
然后重新执行 apt update。
🧩 可选:安装 Portainer(Docker 可视化管理界面)
docker run -d
-p 9000:9000
--name portainer
--restart=always
-v /var/run/docker.sock:/var/run/docker.sock
-v portainer_data:/data
portainer/portainer-ce
访问 http://<你的服务器IP>:9000 初始化即可。
✅ 总结
| 步骤 | 内容 |
|---|---|
| 1 | 更新系统 |
| 2 | 安装依赖 |
| 3 | 添加 GPG 密钥 |
| 4 | 添加 Docker 仓库 |
| 5 | 安装 Docker CE |
| 6 | 验证 + 非 root 用户配置 |
| 7 | 启用开机自启 |
✅ 至此,你已在 Debian/Ubuntu 轻量云服务器上成功部署了 Docker 服务!
如有更多需求(如部署 Nginx、MySQL、WordPress 等),可继续使用 docker run 或 docker-compose 快速搭建。
需要我提供 docker-compose.yml 示例吗?欢迎继续提问!
CLOUD云枢