中文

应用程序

安装 Docker Engine 和 Docker Compose

在 Debian 或 Ubuntu 上从官方仓库安装 Docker Engine 和 Docker Compose:用户、日志、端口、更新、备份与最佳实践。

阅读约 5 分钟, 更新于 2026年11月18日

本页内容

本指南将向您介绍如何从 Docker 官方仓库安装 Docker Engine 和 Docker Compose 插件,以及如何为生产环境准备服务器:用户权限、日志轮转、端口暴露、更新与备份。

订购服务器

为托管您的容器,HostMyServers 提供多种方案:

前提条件

  • 运行 Debian 12/13 或 Ubuntu 22.04/24.04 的 64 位服务器
  • 使用 root 或 sudo 用户的 SSH 访问权限

端口: Docker 不需要任何传入端口。只开放您所发布应用的端口,并且切勿将 Docker API(2375 或 2376)暴露在互联网上:能访问它就等于控制了服务器。

步骤 1:移除冲突的软件包

发行版自带的 Docker 软件包可能与官方软件包冲突:

终端
sudo apt update
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null | cut -f1)

此命令不会删除 /var/lib/docker 中可能存在的镜像和数据卷。

步骤 2:添加官方仓库

这些命令同时适用于 Debian 和 Ubuntu,因为它们会从 /etc/os-release 读取系统信息:

终端
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/$ID/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

步骤 3:安装 Docker

终端
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker containerd

步骤 4:验证安装

终端
sudo systemctl status docker
docker --version
docker compose version
sudo docker run --rm hello-world

出现 Hello from Docker! 消息,表示引擎可以下载镜像并启动容器。

步骤 5:授权用户

若要不使用 sudo 运行 Docker,请将您的用户加入 docker 组,然后注销并重新登录:

终端
sudo usermod -aG docker $USER

然后验证:

终端
docker run --rm hello-world

步骤 6:配置日志和守护进程

默认情况下,json-file 驱动不限制日志大小,日志最终可能占满磁盘。请创建 /etc/docker/daemon.json:

终端
sudo nano /etc/docker/daemon.json
JSON
{
  "log-driver": "local",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "live-restore": true
}
选项 作用
log-driver: local 紧凑的日志格式,支持轮转
max-size, max-file 每个容器最多 3 个文件,每个 10 MB
live-restore 守护进程停止时,容器继续运行

验证该文件,然后重启 Docker。此次重启会中断正在运行的容器:最好在部署应用之前进行。

终端
sudo dockerd --validate --config-file=/etc/docker/daemon.json
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}} {{.LiveRestoreEnabled}}'

日志驱动只对新容器生效。请重新创建现有容器以使其生效,例如使用 docker compose up -d --force-recreate。

步骤 7:管理已发布的端口

如果服务器上运行着反向代理,请只在本地发布您的应用:

YAML
ports:
  - "127.0.0.1:8080:80"

您也可以通过在 /etc/docker/daemon.json 中添加以下键,将本地地址设为默认行为:

JSON
{
  "ip": "127.0.0.1",
  "default-network-opts": {
    "bridge": {
      "com.docker.network.bridge.host_binding_ipv4": "127.0.0.1"
    }
  }
}

将它们与步骤 6 的文件合并,验证后再重启 Docker。此后,面向公网的端口必须明确指定,例如 "0.0.0.0:443:443"。

步骤 8:启动第一个 Compose 项目

为项目创建一个目录:

终端
sudo mkdir -p /opt/myapp
sudo chown "$USER": /opt/myapp
cd /opt/myapp
nano compose.yaml
YAML
services:
  web:
    image: nginx:1.30-alpine
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - web-data:/usr/share/nginx/html
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1/"]
      interval: 30s
      timeout: 5s
      retries: 3

volumes:
  web-data:

启动并验证:

终端
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=20 web
curl -I http://127.0.0.1:8080

若要通过 HTTPS 发布此应用,请在其前面放置一个反向代理。您可以参考指南 安装 Nginx 和 PHP-FPM 以及 Let's Encrypt 指南。

常用命令

命令 说明
docker ps -a 列出容器
docker compose logs -f 持续查看项目日志
docker compose restart 重启服务
docker compose down 停止并删除容器,保留数据卷
docker system df 显示已用空间

更新

Docker Engine

终端
sudo apt update
sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version

live-restore 只覆盖修复性更新。对于主版本升级,请预留容器中断的时间,并查阅 Docker 的发行说明。

应用镜像

如果您在 compose.yaml 中固定了标签,请先修改标签,然后执行:

终端
cd /opt/myapp
docker compose pull
docker compose up -d
docker image prune

备份

至少应备份您的 Compose 文件、.env 文件和数据卷。数据卷位于 /var/lib/docker/volumes,但最好通过临时容器进行归档。数据卷的实际名称可通过 docker volume ls 获得:

终端
cd /opt/myapp
mkdir -p backups
docker compose stop web
docker run --rm -v myapp_web-data:/data:ro -v "$PWD/backups":/backup alpine:3 tar czf /backup/web-data.tar.gz -C /data .
docker compose start web

若要将归档还原到数据卷中:

终端
docker compose stop web
docker run --rm -v myapp_web-data:/data -v "$PWD/backups":/backup:ro alpine:3 tar xzf /backup/web-data.tar.gz -C /data
docker compose start web

对于数据库,建议使用数据库引擎自带的工具导出(mariadb-dump、pg_dump 等)。随后将备份复制到服务器之外。

生产环境最佳实践

  • 固定使用明确的镜像版本,而不是 latest
  • 为您的服务设置 restart: unless-stopped 和 healthcheck
  • 尽量少发布端口,条件允许时在反向代理后面仅在本地发布
  • 将机密信息保存在受保护的 .env 文件中(chmod 600 .env),不要放进 Git
  • 不要使用 privileged: true,没有必要时也不要挂载 /var/run/docker.sock
  • 用 docker system df 监控磁盘空间
  • 定期测试备份的还原

故障排除

/var/run/docker.sock 出现 permission denied

您的用户尚未被计入 docker 组。用 id 检查,然后重新通过 SSH 登录。

Conflicting values set for option Signed-By

Docker 仓库仍残留旧的配置,通常是 /etc/apt/sources.list.d/docker.list。检查其内容后,将其删除:

终端
sudo rm /etc/apt/sources.list.d/docker.list
sudo apt update

Cannot connect to the Docker daemon

终端
sudo systemctl status docker
sudo journalctl -u docker -n 50 --no-pager
sudo dockerd --validate --config-file=/etc/docker/daemon.json

daemon.json 中的语法错误会导致服务无法启动。

port is already allocated 或 address already in use

另一个容器或服务正在使用该端口。用 sudo ss -ltnp | grep ':8080 ' 和 docker ps 找出它,然后更改服务器端的端口。

no space left on device

终端
df -h
docker system df
docker image prune
docker builder prune

只有在确认相关数据卷中不再有有用数据之后,才使用 docker volume prune。

下载时出现 toomanyrequests

已达到 Docker Hub 的下载限制。请稍候,或使用 docker login 登录您的账户。

docker-compose: command not found

当前的插件需要带空格使用:docker compose。

尽管有 UFW,端口仍可访问

这是 Docker 发布端口的正常行为。请将端口发布到 127.0.0.1,或应用指南 配置 UFW 中的限制措施。

参考资料