Docker 是目前最流行的容器化平台,能把应用和依赖打包成镜像,实现"一次构建,到处运行"。本文以 Ubuntu 22.04/24.04 为例,介绍如何从零安装 Docker 并跑起第一个容器,内容同样适用于 Debian 11/12。
1. 环境要求
- Ubuntu 22.04 / 24.04 或 Debian 11 / 12(64 位)
- 普通用户具备 sudo 权限
- 内核版本不低于 3.10
先确认系统没有残留旧版本:
sudo apt remove docker docker-engine docker.io containerd runc
历史遗留的 /etc/docker 配置目录不影响新版本安装,可以保留。
2. 安装 Docker Engine(官方源方式)
Ubuntu 自带的 docker.io 版本较旧,推荐使用 Docker 官方源安装最新稳定版。
2.1 安装依赖并配置 apt 源
sudo apt update
sudo apt install -y ca-certificates curl gnupg
# 添加 Docker 官方 GPG 密钥
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# 添加软件源
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Debian 用户把上面的 URL 换成
https://download.docker.com/linux/debian即可。
2.2 安装 Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
2.3 验证安装
docker --version
sudo docker run --rm hello-world
看到 “Hello from Docker!” 说明安装成功。
3. 配置免 sudo 使用与镜像加速
3.1 将当前用户加入 docker 组
默认只有 root 能操作 Docker,普通用户每次都要加 sudo。把自己加入 docker 组即可免 sudo:
sudo usermod -aG docker $USER
执行后退出终端重新登录(或运行 newgrp docker)才会生效。之后可以:
docker ps
注意:加入 docker 组相当于获得了 root 权限,请只给可信用户添加。
3.2 配置镜像加速
国内拉取 Docker Hub 经常超时,可编辑 /etc/docker/daemon.json 配置加速器:
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json > /dev/null <<'EOF'
{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://hub-mirror.c.163.com"
],
"log-driver": "json-file",
"log-opts": {
"max-size": "100m",
"max-file": "3"
}
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
log-opts 限制容器日志大小,避免长期运行把磁盘写满。
4. 常用命令速查
| 命令 | 说明 |
|---|---|
docker ps |
查看运行中的容器 |
docker ps -a |
查看所有容器(含已停止) |
docker images |
查看本地镜像 |
docker logs -f 容器名 |
实时查看容器日志 |
docker exec -it 容器名 bash |
进入容器终端 |
docker stop 容器名 |
停止容器 |
docker rm 容器名 |
删除容器(需先停止) |
docker rmi 镜像名 |
删除本地镜像 |
docker system df |
查看镜像/容器占用空间 |
docker system prune -a |
清理无用的镜像、容器、缓存 |
5. 部署第一个容器:Nginx
用一条命令跑起一个 Nginx 站点:
docker run -d \
--name my-nginx \
--restart unless-stopped \
-p 8080:80 \
-v /data/nginx/html:/usr/share/nginx/html \
nginx:stable
参数说明:
-d:后台运行--restart unless-stopped:开机/崩溃自动重启(手动 stop 的除外)-p 8080:80:宿主机 8080 端口映射到容器 80 端口-v:把宿主机/data/nginx/html挂载为网站根目录
访问 http://服务器IP:8080 即可看到 Nginx 欢迎页,把 html 文件放进 /data/nginx/html 就能替换成自己的页面。
6. 使用 docker-compose 管理多容器
单个 docker run 写起来很长,服务一多就容易乱。推荐用 docker-compose.yml 统一管理。例如部署一个 WordPress:
mkdir -p /data/wordpress && cd /data/wordpress
# docker-compose.yml
services:
db:
image: mariadb:11
container_name: wordpress-db
restart: unless-stopped
environment:
MARIADB_ROOT_PASSWORD: RootPass123
MARIADB_DATABASE: wordpress
MARIADB_USER: wp
MARIADB_PASSWORD: WpPass123
volumes:
- ./db:/var/lib/mysql
wordpress:
image: wordpress:latest
container_name: wordpress
restart: unless-stopped
depends_on:
- db
ports:
- "8081:80"
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_USER: wp
WORDPRESS_DB_PASSWORD: WpPass123
WORDPRESS_DB_NAME: wordpress
volumes:
- ./html:/var/www/html
启动与管理:
docker compose up -d # 后台启动
docker compose logs -f # 查看日志
docker compose down # 停止并删除容器(数据卷保留)
docker compose pull # 更新镜像后重新 up -d 即可升级
Compose 文件里所有数据都落在当前目录的 db/ 和 html/ 文件夹,备份时直接打包这两个目录即可。
7. 安全与维护建议
- 不要图省事用
--privileged或映射 docker.sock,除非明确知道在做什么。 - 定期更新:
docker compose pull && docker compose up -d,容器不会自动升级镜像。 - 限制日志:按第 3.2 节配置 log-opts,防止日志吃满磁盘。
- 端口最小化:只映射必须的端口,能用宿主机 Nginx 反代就不要直接暴露容器端口。
- 敏感数据用 secret 或环境变量文件:把密码放到
.env文件并设置chmod 600,不要提交到 Git。
8. 卸载 Docker
sudo apt purge docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
sudo rm -rf /var/lib/docker /var/lib/containerd
/var/lib/docker 是镜像和容器数据目录,删除前务必确认没有需要保留的数据。
总结
通过官方源安装 Docker Engine 只需要几条命令,之后无论是单容器还是 docker-compose 编排,核心都是"镜像 + 数据卷 + 端口映射"三件套。把配置写成 compose 文件并纳入版本管理,迁移和备份都会轻松很多。