安装 Docker Engine 和 Docker Compose
在 Debian 或 Ubuntu 上从官方仓库安装 Docker Engine 和 Docker Compose:用户、日志、端口、更新、备份与最佳实践。
本页内容
本指南将向您介绍如何从 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{
"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:管理已发布的端口
如果服务器上运行着反向代理,请只在本地发布您的应用:
ports:
- "127.0.0.1:8080:80"您也可以通过在 /etc/docker/daemon.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.yamlservices:
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 --versionlive-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 updateCannot 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.jsondaemon.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 中的限制措施。