Docker 环境搭建¶

Docker 适用于所有 Kickpi 主板，系统默认未预装，需按对应系统版本操作。

系统	默认安装	说明
Ubuntu 24.04	否	需手动安装 Docker CE
Debian 12	否	需手动安装 Docker CE
Debian 11	否	需手动安装 `docker.io`

Ubuntu 24.04¶

1. 防火墙配置

$ sudo apt install iptables
$ sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
$ sudo update-alternatives --set ip6tables /usr/sbin/iptables-legacy

2. 检查 iptables 是否配置成功

$ iptables --version
iptables v1.8.10 (legacy)

3. 添加 Docker 官方 GPG 密钥和 APT 源

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

国内可以使用清华 TUNA源：

$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o  /usr/share/keyrings/docker-ce.gpg
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-ce.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu $(lsb_release -sc) stable" | sudo tee /etc/apt/sources.list.d/docker.list

4. 更新源

$ sudo apt update

5. 安装 docker

$ sudo apt install docker-ce docker-ce-cli containerd.io

6. 添加配置文件

$ sudo vim /etc/docker/daemon.json
{
  "iptables": false
}

7. 启动服务

$ sudo systemctl start docker

出现问题通过以下命令进行 debug 调试

$ sudo dockerd --debug

8. 运行测试

$ sudo docker run hello-world
$ sudo docker run -it debian bash

Debian 12¶

1. 防火墙配置

$ sudo apt install iptables
$ sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
$ sudo update-alternatives --set ip6tables /usr/sbin/iptables-legacy

2. 检查 iptables 是否配置成功

$ iptables --version
iptables v1.8.10 (legacy)

3. 添加 Docker GPG 公钥和 apt 源

curl -sSL https://download.docker.com/linux/debian/gpg | gpg --dearmor > /usr/share/keyrings/docker-ce.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-ce.gpg] https://download.docker.com/linux/debian $(lsb_release -sc) stable" > /etc/apt/sources.list.d/docker.list

4. 国内可以使用清华 TUNA源：

curl -sS https://download.docker.com/linux/debian/gpg | gpg --dearmor > /usr/share/keyrings/docker-ce.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-ce.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/debian $(lsb_release -sc) stable" > /etc/apt/sources.list.d/docker.list

5. 更新源

$ sudo apt update

6. 安装 docker

$ sudo apt install docker-ce docker-ce-cli containerd.io

7. 添加配置文件

$ sudo vim /etc/docker/daemon.json
{
  "iptables": false
}

8. 启动服务

$ sudo systemctl start docker

出现问题通过以下命令进行 debug 调试

$ sudo dockerd --debug

9. 运行测试

$ sudo docker run hello-world
$ sudo docker run -it debian bash

Debian 11¶

安装 Docker.io

$ sudo apt update
$ sudo apt install docker.io

配置防火墙

$ sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
$ sudo update-alternatives --set ip6tables /usr/sbin/iptables-legacy

检测 docker 服务，启动运行

$ sudo systemctl status docker
$ sudo systemctl start docker

Docker 运行测试

$ sudo docker run hello-world
$ docker run -it ubuntu bash