一、前言#

Docker 是一种容器化技术，它能把应用及其运行环境打包成一个轻量、可移植的镜像。镜像运行起来就是一个容器，容器之间互相隔离，部署和迁移都非常方便。

Docker Compose 则是 Docker 官方提供的编排工具，通过一个 docker-compose.yml 文件即可定义并启动多个相互依赖的容器，特别适合本地开发、测试和小型生产场景。

重要
本教程以 Ubuntu / Debian 系列发行版为例，其他 Linux 发行版或 Windows、macOS 可参考官方文档调整安装命令。

二、安装 Docker#

1. 通过 APT 安装#

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

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

8
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
9

10
sudo apt update
11
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

2. 启动并设置开机自启#

1
sudo systemctl enable --now docker
2
sudo systemctl status docker

3. 让非 root 用户也能使用 Docker#

1
sudo usermod -aG docker $USER
2
newgrp docker

提示
执行 newgrp docker 后当前终端即可生效，其他已打开的终端需要重新登录才能使用。

4. 验证安装#

1
docker --version
2
docker compose version

三、Docker 核心概念#

概念	说明
镜像（Image）	容器运行的只读模板，包含应用代码、依赖和运行环境
容器（Container）	镜像的运行实例，互相隔离，拥有独立的文件系统、网络和进程空间
Dockerfile	定义如何构建镜像的文本文件
数据卷（Volume）	持久化容器数据的机制，数据保存在宿主机上，容器删除后仍然存在
网络（Network）	容器之间通信的虚拟网络，同一网络内的容器可以通过服务名互相访问

四、Docker 常用命令#

1. 镜像管理#

1
docker pull ubuntu:22.04
2
docker images
3
docker rmi ubuntu:22.04
4
docker build -t myapp:1.0 .

2. 容器生命周期#

1
docker run -d --name web -p 8080:80 nginx
2
docker ps
3
docker ps -a
4
docker stop web
5
docker start web
6
docker restart web
7
docker rm web
8
docker rm -f web

提示
docker run 常用参数说明：

-d：后台运行

--name：为容器指定名称

-p 宿主机端口:容器端口：端口映射

-v 宿主机路径:容器路径：挂载数据卷

-e KEY=VALUE：设置环境变量

--restart unless-stopped：自动重启策略

3. 进入容器与查看日志#

1
docker exec -it web bash
2
docker logs -f web
3
docker inspect web

4. 清理资源#

1
docker system prune
2
docker volume prune
3
docker image prune

注意
docker system prune 会删除停止的容器、未被使用的网络、 dangling 镜像等，执行前请确认没有需要保留的容器或数据。

五、Dockerfile 示例#

以一个简单的 Node.js 应用为例，项目目录结构如下：

1
my-node-app/
2
├── Dockerfile
3
├── .dockerignore
4
├── package.json
5
└── server.js

Dockerfile：

1
FROM node:20-alpine
2

3
WORKDIR /app
4

5
COPY package*.json ./
6
RUN npm ci --only=production
7

8
COPY . .
9

10
EXPOSE 3000
11

12
CMD ["node", "server.js"]

.dockerignore：

1
node_modules
2
npm-debug.log
3
.git
4
.env
5
Dockerfile
6
.dockerignore

构建并运行：

1
cd my-node-app
2
docker build -t my-node-app:1.0 .
3
docker run -d --name myapp -p 3000:3000 my-node-app:1.0

六、Docker Compose 简介#

Docker Compose 通过一个 YAML 文件描述多个容器之间的关系，例如依赖、网络、数据卷、环境变量等。只需要一条命令就可以启动或停止整个应用栈。

现代 Docker 已将 Compose 作为插件集成到 docker 命令中，命令格式为：

1
docker compose up -d

旧版的独立命令 docker-compose 目前仍可使用，但推荐统一使用 docker compose。

七、安装 Docker Compose 插件#

如果你按照前面的步骤安装了 docker-compose-plugin，则无需额外安装。否则可以单独安装：

1
sudo apt install docker-compose-plugin

验证：

1
docker compose version

八、docker-compose.yml 文件结构#

一份常用的 docker-compose.yml 文件主要包含以下字段：

1
services:
2
  web:
3
    image: nginx:latest
4
    container_name: web
5
    ports:
6
      - "8080:80"
7
    volumes:
8
      - ./html:/usr/share/nginx/html
9
    networks:
10
      - mynet
11
    depends_on:
12
      - db
13
    restart: unless-stopped
14

15
  db:
16
    image: postgres:16
17
    container_name: db
18
    environment:
19
      POSTGRES_USER: user
20
      POSTGRES_PASSWORD: password
21
      POSTGRES_DB: mydb
22
    volumes:
23
      - db_data:/var/lib/postgresql/data
24
    networks:
25
      - mynet
26

27
volumes:
28
  db_data:
29

30
networks:
31
  mynet:

提示

services 下定义每个容器

depends_on 只控制启动顺序，不保证服务已就绪

volumes 下声明命名卷，防止数据随容器删除而丢失

同一 networks 内的容器可以通过服务名互相访问

九、常用 Compose 命令#

1
docker compose up -d
2
docker compose down
3
docker compose ps
4
docker compose logs -f
5
docker compose exec web bash
6
docker compose restart
7
docker compose build
8
docker compose pull

注意
docker compose down 默认会删除容器和网络，但保留数据卷。如果需要一并删除卷，请使用 docker compose down -v。

十、完整示例：部署一个 Web 应用 + 数据库#

1. 项目结构#

1
demo-project/
2
├── docker-compose.yml
3
├── Dockerfile
4
├── .dockerignore
5
├── package.json
6
└── server.js

2. 应用代码#

server.js：

1
const express = require('express');
2
const { Pool } = require('pg');
3

4
const app = express();
5
const pool = new Pool({
6
  host: process.env.DB_HOST,
7
  user: process.env.DB_USER,
8
  password: process.env.DB_PASSWORD,
9
  database: process.env.DB_NAME,
10
  port: 5432,
11
});
12

13
app.get('/', async (req, res) => {
14
  const result = await pool.query('SELECT NOW()');
15
  res.json({ time: result.rows[0].now });
16
});
17

18
app.listen(3000, () => {
19
  console.log('Server is running on port 3000');
20
});

package.json：

1
{
2
  "name": "demo-project",
3
  "version": "1.0.0",
4
  "dependencies": {
5
    "express": "^4.18.0",
6
    "pg": "^8.11.0"
7
  },
8
  "scripts": {
9
    "start": "node server.js"
10
  }
11
}

3. Dockerfile#

1
FROM node:20-alpine
2
WORKDIR /app
3
COPY package*.json ./
4
RUN npm ci --only=production
5
COPY . .
6
EXPOSE 3000
7
CMD ["node", "server.js"]

4. docker-compose.yml#

1
services:
2
  web:
3
    build: .
4
    container_name: demo-web
5
    ports:
6
      - "3000:3000"
7
    environment:
8
      DB_HOST: db
9
      DB_USER: demo
10
      DB_PASSWORD: demopass
11
      DB_NAME: demo
12
    networks:
13
      - demonet
14
    depends_on:
15
      - db
16
    restart: unless-stopped
17

18
  db:
19
    image: postgres:16-alpine
20
    container_name: demo-db
21
    environment:
22
      POSTGRES_USER: demo
23
      POSTGRES_PASSWORD: demopass
24
      POSTGRES_DB: demo
25
    volumes:
26
      - db_data:/var/lib/postgresql/data
27
    networks:
28
      - demonet
29
    restart: unless-stopped
30

31
volumes:
32
  db_data:
33

34
networks:
35
  demonet:

5. 启动与验证#

1
cd demo-project
2
docker compose up -d
3
docker compose ps
4
docker compose logs -f
5
curl http://localhost:3000

停止并清理：

1
docker compose down

如果需要同时删除数据库卷，请执行：

1
docker compose down -v

十一、常见问题与注意事项#

1. 数据持久化#

容器本身是临时的，数据应通过 volumes 或绑定挂载保存到宿主机。数据库类服务强烈建议使用命名卷，避免 docker compose down 误删后数据丢失。

2. 端口冲突#

ports 中左侧是宿主机端口，右侧是容器端口。如果左侧端口已被占用，docker compose up 会失败，请更换为未被使用的端口。

3. 环境变量管理#

对于敏感信息，建议通过 .env 文件管理，而不是直接写在 docker-compose.yml 中。Compose 会自动读取同目录下的 .env 文件。

1
DB_PASSWORD=your_secret_password

1
environment:
2
  DB_PASSWORD: ${DB_PASSWORD}

4. 镜像清理#

长期开发会积累大量镜像，可以定期清理：

1
docker image prune -a

注意
docker image prune -a 会删除所有未被任何容器使用的镜像，请确认不再需要这些镜像后再执行。

5. 容器内时间#

容器默认使用 UTC 时间，如果需要同步宿主机时区，可以挂载：

1
volumes:
2
  - /etc/localtime:/etc/localtime:ro
3
  - /etc/timezone:/etc/timezone:ro

十二、总结#

Docker 让应用交付变得轻量和一致，Docker Compose 则让多容器应用的本地开发和部署变得简单。掌握镜像构建、容器生命周期、数据卷、网络和 Compose 编排后，就可以快速搭建稳定、可移植的服务环境。