# Docker CLI 快速配置

URL: https://caijiao.org/docker/installation/cli
Source: docs/docker/installation/cli.md
Description: 本章节介绍如何在不同操作系统上快速配置 Docker CLI，包括环境变量设置、常用命令别名、命令补全以及连接远程 Docker 主机，让开发者能高效管理容器和镜像。

Docker CLI（命令行界面）是管理 Docker 容器、镜像和网络的核心工具。本节将讲解如何快速配置 CLI，使日常操作更高效。

## 1. 安装与验证

安装 Docker Desktop 或 Docker Engine 后，可在终端输入以下命令验证 CLI 是否可用：

```bash
docker --version
docker info
````

若返回 Docker 版本与信息，说明 CLI 已成功安装。

## 2. 配置环境变量（Linux / macOS / Windows WSL）

```bash
# 设置 DOCKER_HOST（连接远程 Docker 主机示例）
export DOCKER_HOST=tcp://192.168.0.100:2375
# 持久化到 ~/.bashrc 或 ~/.zshrc
echo 'export DOCKER_HOST=tcp://192.168.0.100:2375' >> ~/.bashrc
```

Windows PowerShell：

```powershell
$env:DOCKER_HOST="tcp://192.168.0.100:2375"
```

## 3. 命令别名与快捷方式

为了减少重复输入，可设置常用别名：

```bash
alias dps="docker ps"
alias di="docker images"
alias drun="docker run -it --rm"
```

添加到 shell 配置文件（如 `.bashrc` 或 `.zshrc`）即可长期生效。

## 4. 命令补全

启用命令补全提高效率：

```bash
# bash
source /usr/share/bash-completion/completions/docker

# zsh
autoload -U +X compinit && compinit
source <(docker completion zsh)
```

## 5. 连接远程 Docker 主机

通过 `DOCKER_HOST` 或 `docker context` 管理远程 Docker：

```bash
docker context create remote --docker "host=tcp://192.168.0.100:2375"
docker context use remote
docker ps
```

## 6. 常用 CLI 配置建议

* 使用 `docker config` 与 `docker secret` 管理敏感配置
* 配置镜像加速器提高拉取速度
* 使用 JSON 或 YAML 输出便于脚本解析：

```bash
docker ps --format "{{.ID}} {{.Names}}"
```

---

通过快速配置 Docker CLI，你可以更高效地管理本地和远程容器环境，为后续镜像构建、容器运行和自动化部署打下基础。