# Docker Machine

### 简介

Docker Machine 是一种可以让您在虚拟主机上安装 Docker 的工具，并可以使用 docker-machine 命令来管理主机。

Docker Machine 也可以集中管理所有的 docker 主机，比如快速的给 100 台服务器安装上 docker。

![](/files/fOO968XpAlPcUEJ0TkEh)

Docker Machine 管理的虚拟主机可以是机上的，也可以是云供应商，如阿里云，腾讯云，AWS，或 DigitalOcean。

使用 docker-machine 命令，您可以启动，检查，停止和重新启动托管主机，也可以升级 Docker 客户端和守护程序，以及配置 Docker 客户端与您的主机进行通信。

![](/files/Vj66ln5VV8CJDYAtbDrc)

***

## 安装

安装 Docker Machine 之前你需要先安装 Docker。

Docker Machine 可以在多种平台上安装使用，包括 Linux 、MacOS 以及 windows。

### Linux 安装命令

```shell
$ base=https://github.com/docker/machine/releases/download/v0.16.0 &&
  curl -L $base/docker-machine-$(uname -s)-$(uname -m) >/tmp/docker-machine &&
  sudo mv /tmp/docker-machine /usr/local/bin/docker-machine &&
  chmod +x /usr/local/bin/docker-machine
```

### macOS 安装命令

```shell
$ base=https://github.com/docker/machine/releases/download/v0.16.0 &&
  curl -L $base/docker-machine-$(uname -s)-$(uname -m) >/usr/local/bin/docker-machine &&
  chmod +x /usr/local/bin/docker-machine
```

### Windows 安装命令

如果你是 Windows 平台，可以使用 [Git BASH](https://git-for-windows.github.io/)，并输入以下命令：

```shell
$ base=https://github.com/docker/machine/releases/download/v0.16.0 &&
  mkdir -p "$HOME/bin" &&
  curl -L $base/docker-machine-Windows-x86_64.exe > "$HOME/bin/docker-machine.exe" &&
  chmod +x "$HOME/bin/docker-machine.exe"
```

查看是否安装成功：

```shell
docker-machine version
docker-machine version 0.16.0, build 9371605
```

**注意：** 各版本更新日志里面也有安装说明：<https://github.com/docker/machine/releases>

***

## 使用

本章通过 virtualbox 来介绍 docker-machine 的使用方法。其他云服务商操作与此基本一致。具体可以参考每家服务商的指导文档。

### 1、列出可用的机器

可以看到目前只有这里默认的 default 虚拟机。

```shell
docker-machine ls
```

![](/files/lMtJ6Y0uyxddORf7eps3)

### 2、创建机器

创建一台名为 test 的机器。

```shell
docker-machine create --driver virtualbox test
```

* **--driver**：指定用来创建机器的驱动类型，这里是 virtualbox。

![](/files/dUSPnqJfS6KoJRoXtr7h)

### 3、查看机器的 ip

```shell
docker-machine ip test
```

![](/files/sRdrCBc7KH8vb5flGjib)

### 4、停止机器

```shell
docker-machine stop test
```

![](/files/vorIP46jooTp5feaAeMt)

### 5、启动机器

```shell
docker-machine start test
```

![](/files/OnVKMNRYzA7O9sOMHbdI)

### 6、进入机器

```shell
docker-machine ssh test
```

![](/files/e7YuG4lcWz0463Mj98ei)

### docker-machine 命令参数说明

* **docker-machine active**：查看当前激活状态的 Docker 主机。

```shell
docker-machine ls

NAME      ACTIVE   DRIVER         STATE     URL
dev       -        virtualbox     Running   tcp://192.168.99.103:2376
staging   *        digitalocean   Running   tcp://203.0.113.81:2376

$ echo $DOCKER_HOST
tcp://203.0.113.81:2376

$ docker-machine active
staging
```

* **config**：查看当前激活状态 Docker 主机的连接信息。
* **create**：创建 Docker 主机
* **env**：显示连接到某个主机需要的环境变量
* **inspect**： 以 json 格式输出指定Docker的详细信息
* **ip**： 获取指定 Docker 主机的地址
* **kill**： 直接杀死指定的 Docker 主机
* **ls**： 列出所有的管理主机
* **provision**： 重新配置指定主机
* **regenerate-certs**： 为某个主机重新生成 TLS 信息
* **restart**： 重启指定的主机
* **rm**： 删除某台 Docker 主机，对应的虚拟机也会被删除
* **ssh**： 通过 SSH 连接到主机上，执行命令
* **scp**： 在 Docker 主机之间以及 Docker 主机和本地主机之间通过 scp 远程复制数据
* **mount**： 使用 SSHFS 从计算机装载或卸载目录
* **start**： 启动一个指定的 Docker 主机，如果对象是个虚拟机，该虚拟机将被启动
* **status**： 获取指定 Docker 主机的状态(包括：Running、Paused、Saved、Stopped、Stopping、Starting、Error)等
* **stop**： 停止一个指定的 Docker 主机
* **upgrade**： 将一个指定主机的 Docker 版本更新为最新
* **url**： 获取指定 Docker 主机的监听 URL
* **version**： 显示 Docker Machine 的版本或者主机 Docker 版本
* **help**： 显示帮助信息


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tuonioooo-notebook.gitbook.io/docker/usage/docker-machine.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.