Docker 安装与使用教程：从零部署第一个容器服务

背景

部署一个 Web 服务、数据库、监控面板或个人项目时，传统方式通常需要手动安装运行环境、配置依赖版本、管理后台进程。不同项目之间还容易产生端口、依赖库和运行环境冲突。

Docker 将应用及其依赖打包成可运行的容器。你可以把它理解为一种更轻量、可重复、可迁移的部署方式：

1
镜像（Image）      ：应用的只读模板
2
容器（Container）  ：由镜像启动的运行实例
3
数据卷（Volume）   ：独立于容器生命周期的持久化数据
4
网络（Network）    ：让多个容器能够互相访问
5
Compose            ：用一个 YAML 文件管理多个容器

本文以 Debian / Ubuntu 服务器为例，使用 Docker 官方 APT 仓库安装 Docker Engine，并通过 Nginx 和 Docker Compose 演示最常见的使用方式。

本文的命令适合开发机和个人服务器。生产环境还需要额外考虑域名、HTTPS、反向代理、备份、监控、防火墙和镜像更新策略。

步骤

1. 安装前检查系统信息

先确认当前系统、版本和 CPU 架构：

1
cat /etc/os-release
2
uname -m

常见架构说明：

1
x86_64：Intel / AMD 64 位服务器
2
aarch64：ARM 64 位服务器，例如部分云服务器、树莓派和 NAS

本文主要适用于 Debian 12 / 13，以及 Ubuntu 22.04 / 24.04 / 26.04 的 64 位系统。

如果系统之前安装过发行版自带的旧 Docker 包，建议先卸载可能冲突的组件：

1
sudo apt remove \
2
  docker.io docker-compose docker-compose-v2 docker-doc \
3
  podman-docker containerd runc

如果终端提示某些软件包没有安装，可以忽略。

注意：卸载软件包通常不会自动删除已有镜像、容器和数据卷。不要在已有生产 Docker 环境的服务器上直接执行清理操作。

2. 通过 Docker 官方仓库安装 Docker Engine

以下是 Debian 的安装方式。

先安装必要依赖，并添加 Docker 的 GPG 密钥：

1
sudo apt update
2
sudo apt install -y ca-certificates curl
3

4
sudo install -m 0755 -d /etc/apt/keyrings
5
sudo curl -fsSL https://download.docker.com/linux/debian/gpg \
6
  -o /etc/apt/keyrings/docker.asc
7
sudo chmod a+r /etc/apt/keyrings/docker.asc

添加 Docker 的 APT 软件源：

1
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
2
Types: deb
3
URIs: https://download.docker.com/linux/debian
4
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
5
Components: stable
6
Architectures: $(dpkg --print-architecture)
7
Signed-By: /etc/apt/keyrings/docker.asc
8
EOF

更新软件包索引并安装 Docker Engine、Buildx 和 Compose 插件：

1
sudo apt update
2
sudo apt install -y \
3
  docker-ce \
4
  docker-ce-cli \
5
  containerd.io \
6
  docker-buildx-plugin \
7
  docker-compose-plugin

Ubuntu 的步骤基本相同，区别是下载 GPG 密钥和软件源时将路径中的 debian 替换为 ubuntu：

1
https://download.docker.com/linux/ubuntu/gpg
2
https://download.docker.com/linux/ubuntu

安装完成后，确认 Docker 服务状态：

1
sudo systemctl status docker

若服务没有启动：

1
sudo systemctl start docker
2
sudo systemctl enable docker

验证安装：

1
sudo docker run hello-world

看到 Docker 输出欢迎信息，说明安装成功。

3. 配置当前用户使用 Docker

默认情况下，Docker 守护进程由 root 管理，因此需要在命令前加 sudo：

1
sudo docker ps

如果这是你自己的开发机或个人服务器，可以将当前用户加入 docker 用户组：

1
sudo groupadd docker
2
sudo usermod -aG docker $USER
3
newgrp docker

重新验证：

1
docker run hello-world

**安全提示：**加入 docker 组相当于授予该用户接近 root 的权限。对于多人共用的服务器，不要随意把普通账号加入此组；更严格的场景应评估 Docker Rootless Mode 或使用独立的受限部署账号。

4. 认识 Docker 的基础命令

查看 Docker 版本：

1
docker version
2
docker compose version

查看本地镜像：

1
docker images

查看正在运行的容器：

1
docker ps

查看全部容器，包括已退出的容器：

1
docker ps -a

Docker 的日常操作通常围绕下面这条流程：

1
拉取镜像 → 创建并运行容器 → 查看日志 → 进入容器排查 → 停止或删除容器

5. 运行第一个 Nginx 容器

先拉取 Nginx 镜像：

1
docker pull nginx:alpine

启动一个后台运行的 Nginx 容器：

1
docker run -d \
2
  --name nginx-web \
3
  --restart unless-stopped \
4
  -p 127.0.0.1:8080:80 \
5
  nginx:alpine

参数含义：

1
-d                     后台运行
2
--name nginx-web       指定容器名称
3
--restart unless-stopped
4
                       Docker 重启后自动恢复容器；手动停止后不自动启动
5
-p 127.0.0.1:8080:80   将宿主机本机的 8080 映射到容器的 80 端口
6
nginx:alpine           使用体积较小的 Nginx 镜像

在服务器上测试：

1
curl http://127.0.0.1:8080

如果需要让外部网络直接访问容器端口，可以写成：

1
docker run -d \
2
  --name nginx-web \
3
  --restart unless-stopped \
4
  -p 8080:80 \
5
  nginx:alpine

但这会把 8080 暴露到服务器网络。对于公网服务器，更推荐把应用只绑定到 127.0.0.1，再由 Caddy、Nginx 或 Traefik 统一处理 HTTPS 和外部访问。

6. 查看日志、进入容器和管理生命周期

实时查看容器日志：

1
docker logs -f nginx-web

查看容器详细信息：

1
docker inspect nginx-web

进入正在运行的容器：

1
docker exec -it nginx-web sh

停止容器：

1
docker stop nginx-web

启动已经停止的容器：

1
docker start nginx-web

重启容器：

1
docker restart nginx-web

删除容器：

1
docker rm -f nginx-web

删除容器只会删除容器本身，不一定会删除它挂载的数据卷。持久化数据应通过数据卷或宿主机目录管理，而不是只存放在容器内部。

7. 使用数据卷保存持久化数据

容器被删除后，写在容器内部的文件通常也会丢失。因此数据库、上传文件、配置文件等内容应使用数据卷保存。

创建一个名为 mysql-data 的数据卷：

1
docker volume create mysql-data

查看数据卷：

1
docker volume ls

以 MySQL 为例，将数据库数据保存到数据卷：

1
docker run -d \
2
  --name mysql8 \
3
  --restart unless-stopped \
4
  -e MYSQL_ROOT_PASSWORD='请替换为强密码' \
5
  -e MYSQL_DATABASE=appdb \
6
  -v mysql-data:/var/lib/mysql \
7
  mysql:8

这里的关键参数是：

1
-v mysql-data:/var/lib/mysql

左侧是宿主机上的 Docker 数据卷名称，右侧是容器内部 MySQL 保存数据的位置。即使容器被重新创建，只要继续挂载同一个数据卷，数据仍然存在。

查看数据卷详细信息：

1
docker volume inspect mysql-data

8. 使用 Docker Compose 管理多个服务

当一个项目包含 Web 服务、数据库、缓存、反向代理时，逐条输入 docker run 会很难维护。Docker Compose 可以用一个 compose.yaml 文件统一描述服务、端口、数据卷和网络。

创建项目目录：

1
mkdir -p ~/docker-demo
2
cd ~/docker-demo

创建 compose.yaml：

1
services:
2
  web:
3
    image: nginx:alpine
4
    container_name: demo-web
5
    restart: unless-stopped
6
    ports:
7
      - "127.0.0.1:8080:80"
8
    volumes:
9
      - ./html:/usr/share/nginx/html:ro
10

11
  redis:
12
    image: redis:7-alpine
13
    container_name: demo-redis
14
    restart: unless-stopped
15
    volumes:
16
      - redis-data:/data
17

18
volumes:
19
  redis-data:

创建测试页面：

1
mkdir -p html
2
cat > html/index.html <<'EOF'
3
<!doctype html>
4
<html lang="zh-CN">
5
  <head>
6
    <meta charset="utf-8">
7
    <title>Docker Compose Demo</title>
8
  </head>
9
  <body>
10
    <h1>Docker Compose 已正常运行</h1>
11
  </body>
12
</html>
13
EOF

启动全部服务：

1
docker compose up -d

查看 Compose 管理的服务状态：

1
docker compose ps

实时查看日志：

1
docker compose logs -f

停止并删除 Compose 创建的容器和网络：

1
docker compose down

如果需要连同 Compose 创建的命名数据卷一起删除：

1
docker compose down -v

docker compose down -v 会删除相关数据卷。数据库或业务数据存在时，执行前必须确认已经备份。

9. 构建自己的镜像

如果你的项目不是直接使用现成镜像，而是自己写的 FastAPI、Node.js 或 Go 服务，就需要用 Dockerfile 构建镜像。

下面是一个简单的 Python Web 服务示例。

创建 app.py：

1
from flask import Flask
2

3
app = Flask(__name__)
4

5
@app.get("/")
6
def index():
7
    return {"message": "Hello from Docker"}

创建 requirements.txt：

1
flask
2
gunicorn

创建 Dockerfile：

1
FROM python:3.12-slim
2

3
WORKDIR /app
4

5
COPY requirements.txt .
6
RUN pip install --no-cache-dir -r requirements.txt
7

8
COPY app.py .
9

10
EXPOSE 8000
11

12
CMD ["gunicorn", "-b", "0.0.0.0:8000", "app:app"]

构建镜像：

1
docker build -t my-flask-app:1.0 .

运行容器：

1
docker run -d \
2
  --name my-flask-app \
3
  --restart unless-stopped \
4
  -p 127.0.0.1:8000:8000 \
5
  my-flask-app:1.0

测试服务：

1
curl http://127.0.0.1:8000

10. 清理不再使用的 Docker 资源

Docker 长期使用后，未使用镜像、已退出容器、构建缓存可能会占用大量磁盘空间。

查看总体占用：

1
docker system df

删除已退出的容器：

1
docker container prune

删除未被使用的镜像：

1
docker image prune -a

删除未被使用的网络：

1
docker network prune

交互式清理常见无用资源：

1
docker system prune

更彻底的清理：

1
docker system prune -a

docker system prune -a 会删除所有未被运行中容器使用的镜像。执行前先使用 docker images 和 docker ps -a 检查，避免删掉后续仍要使用的镜像。

常见问题

1. 执行 docker 提示 permission denied

常见报错：

1
permission denied while trying to connect to the Docker daemon socket

先临时使用 sudo：

1
sudo docker ps

如果希望当前用户直接运行 Docker，确认已经完成用户组配置：

1
sudo usermod -aG docker $USER
2
newgrp docker

如果仍然不生效，退出当前 SSH 会话并重新登录，或者重启服务器后再试。

2. Docker 服务没有启动怎么办？

查看状态：

1
sudo systemctl status docker

启动服务：

1
sudo systemctl start docker

设置开机启动：

1
sudo systemctl enable docker

查看 Docker 服务日志：

1
sudo journalctl -u docker -n 100 --no-pager

3. 为什么映射端口后 UFW 规则没有按预期生效？

Docker 在发布容器端口时会操作 iptables 规则，部分情况下可能绕过 UFW 或 firewalld 的常规规则。

不要仅依赖“服务器已经安装 UFW”来判断容器端口是否安全。对于公网服务，建议：

1. 尽量使用 127.0.0.1:宿主机端口:容器端口，避免直接对公网暴露内部服务；
2. 统一通过反向代理提供 HTTPS；
3. 在云厂商安全组、防火墙和 Docker 网络层同时限制访问范围；
4. 定期使用 ss -lntp 或 docker ps 检查暴露端口。

4. 容器停止后，为什么服务不能自动恢复？

确认容器是否设置重启策略：

1
docker inspect -f '{{.HostConfig.RestartPolicy.Name}}' 容器名

推荐个人服务器中的长期服务使用：

1
--restart unless-stopped

对于 Docker Compose：

1
restart: unless-stopped

5. docker compose 和 docker-compose 有什么区别？

当前推荐使用：

1
docker compose

这是 Docker Compose v2 插件的调用方式。

旧教程中常见的：

1
docker-compose

通常是旧版独立程序。新项目建议统一使用 docker compose，避免混用。

6. Docker 能完全替代虚拟机吗？

不能完全替代。

Docker 容器共享宿主机内核，适合运行服务、开发环境和持续部署；虚拟机则拥有更完整的系统隔离，适合运行不同内核需求的系统、桌面环境或更强隔离需求的场景。

可以简单理解为：

1
Docker：更轻量、更快启动、适合应用部署
2
虚拟机：隔离更完整、适合运行完整操作系统

总结

Docker 的核心价值，是让应用部署从“手动配置一台机器”变成“用镜像和配置重复创建同样的运行环境”。

日常最常用的命令包括：

1
docker ps                         查看运行中的容器
2
docker ps -a                      查看全部容器
3
docker images                     查看镜像
4
docker logs -f 容器名             实时查看日志
5
docker exec -it 容器名 sh         进入容器
6
docker stop / start / restart     管理容器生命周期
7
docker compose up -d              启动多容器项目
8
docker compose logs -f            查看 Compose 项目日志
9
docker system df                  查看 Docker 磁盘占用

对于个人服务器，推荐形成下面的部署习惯：

1
Docker Compose 管理项目
2
数据卷保存数据库与业务数据
3
反向代理统一处理域名与 HTTPS
4
容器只绑定必要端口
5
定期备份数据卷与 Compose 配置
6
定期检查日志、磁盘占用和镜像更新

继续部署真实项目时，可以参考 Tmux 入门教程：让 SSH 断线和多任务终端不再中断 保持远程操作现场，也可以结合 Git 安装与使用教程：Linux 和 Windows 从零开始版本管理 管理 Compose 配置。Docker 版本、镜像和 Compose 语法建议以 Docker 官方文档 为准。