Dockerctl

Dockerctl 是一个 Docker 服务管理工具，用于管理 Docker 守护进程的生命周期和配置。

NOTE

请使用 root 用户运行。

命令

dockerctl [command] [OPTIONS]

• start : 启动 Docker 服务
• stop : 停止 Docker 服务
• restart : 重启 Docker 服务
• status : 显示 Docker 服务状态
• show-config : 显示 Docker 服务配置
• completion : 生成指定 shell 的自动补全脚本
• help : 显示帮助信息

dockerctl start

启动 Docker 服务。

用法

dockerctl start

dockerctl stop

停止 Docker 服务。

用法

dockerctl stop

dockerctl status

显示 Docker 服务的当前运行状态。

示例

查看默认配置：

dockerctl status

示例输出：

● docker.service - Docker Application Container Engine
        Active: active (running) since 2024-12-02 04:40:33 Monday; 0 days ago
         Tasks: 116
        Memory: 0.00%
           CPU: 0.00%

dockerctl show-config

显示 Docker 服务的当前配置。

用法

dockerctl show-config [flags]

示例

查看默认配置：

dockerctl show-config

示例输出：

{
  "proxies": {}
}

dockerctl restart

重启 Docker 服务。通常在修改配置后使用此命令使更改生效。

用法

dockerctl restart

使用 dockerctl 管理配置

Docker 容器服务支持修改 docker 服务配置，添加 proxies 或 registry-mirrors 等。修改以下任意文件，均需要执行 dockerctl restart 使更改生效。

• /etc/docker/daemon.json。用法参考 Docker Daemon 官方文档、Docker Hub 官方文档。示例配置如下：

  {
      "proxies": {
      "http-proxy": "http://proxy.example.com:3128",
      "https-proxy": "https://proxy.example.com:3129",
      "no-proxy": "*.test.example.com,.example.org,127.0.0.0/8"
      },
      "registry-mirrors": ["https://<my-docker-mirror-host>"]
  }

• /tmp/docker-config/config.json（该文件在开发机重启后会复原，无法持久化保存修改）。用法参考 Docker CLI 官方文档。示例配置如下：

  {
  "proxies": {
    "default": {
      "httpProxy": "http://proxy.example.com:3128",
      "httpsProxy": "https://proxy.example.com:3129",
      "noProxy": "*.test.example.com,.example.org,127.0.0.0/8"
    }
  }
  }

WARNING

请务必注意两份配置文件 proxies 字段差异。

示例流程

1. 修改配置：

   mkdir -p /etc/docker
   # 修改 docker daemon 配置
   vim /etc/docker/daemon.json

2. 重启服务以应用更改：

   dockerctl restart

3. 验证配置是否生效：

   dockerctl show-config