在 Linux / Raspberry Pi OS 上安装 Docker

本指南说明如何在 Linux 上安装 Docker，包括 Raspberry Pi OS，以运行 Turn Off PC 的远程 Wake-on-LAN 服务。

Linux 和 Raspberry Pi OS 的安装过程和命令完全相同。

支持的系统

本指南适用于：

• Ubuntu
• Debian
• Linux Mint
• Raspberry Pi OS
• 其他基于 Debian 的 Linux 发行版

适用于：

• 服务器
• 台式电脑
• 迷你电脑
• Raspberry Pi（推荐用于常开使用）

此设置的作用

完成本指南后：

• Docker Engine 将被安装
• Docker 将作为系统服务运行
• 系统将准备好运行容器
• 可以部署远程 Wake-on-LAN 服务

前提条件

在继续之前，请确保：

• 您正在运行支持的 Linux 发行版
• 您拥有管理员 (root) 权限
• 系统有互联网访问
• 系统已连接到本地网络

步骤 1：安装 Docker

Docker 提供官方安装脚本。

运行以下命令：

curl -fsSL https://get.docker.com | sh

此命令：

• 检测您的 Linux 发行版
• 安装 Docker Engine
• 安装所需的依赖项
• 配置 Docker 服务

这在 Linux 和 Raspberry Pi OS 上都适用。

步骤 2：启用并启动 Docker

确保 Docker 在启动时自动运行：

sudo systemctl enable docker
sudo systemctl start docker

验证 Docker 正在运行：

sudo systemctl status docker

服务应为 active (running)。

步骤 3：允许不使用 sudo 运行 Docker（建议）

默认情况下，Docker 需要 sudo。

要允许您的用户不使用 sudo 运行 Docker 命令：

sudo usermod -aG docker $USER

然后注销并重新登录以使更改生效。

步骤 4：验证 Docker 安装

运行以下命令：

docker version

您应该看到：

• Client 版本
• Server 版本

使用简单容器测试 Docker：

docker run hello-world

如果容器成功运行，Docker 已正确安装。

常见问题

Docker 命令未找到

• 注销并重新登录
• 确保 Docker 已正确安装

运行 Docker 时权限被拒绝

• 确保您的用户在 docker 组中
• 运行 usermod 后重启或重新登录

Docker 服务未运行

• 手动启动服务：

sudo systemctl start docker

• 如有需要，检查日志：

journalctl -u docker