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. 安全与维护建议

  1. 不要图省事用 --privileged 或映射 docker.sock,除非明确知道在做什么。
  2. 定期更新:docker compose pull && docker compose up -d,容器不会自动升级镜像。
  3. 限制日志:按第 3.2 节配置 log-opts,防止日志吃满磁盘。
  4. 端口最小化:只映射必须的端口,能用宿主机 Nginx 反代就不要直接暴露容器端口。
  5. 敏感数据用 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 文件并纳入版本管理,迁移和备份都会轻松很多。