docker/remote 镜像文档

概述

docker/remote是一款用于安全访问远程Docker集群的镜像，包含服务器端和客户端组件。通过简单的令牌认证机制，实现本地客户端与远程Docker CE/EE集群的安全连接，支持在本地执行远程Docker命令，如查看容器、管理服务等操作。

核心功能

• 令牌认证机制：服务器端生成唯一访问令牌，客户端通过输入令牌完成身份验证，确保集群访问安全
• 跨网络通信：建立客户端与远程Docker集群的加密连接，支持双向数据传输
• 命令透传：客户端连接后可直接使用标准Docker命令（如docker ps、docker services）操作远程集群
• 轻量级部署：采用容器化部署方式，无需复杂配置，即开即用

使用场景

• 开发人员远程访问测试/生产环境的Docker集群
• 运维人员跨网络管理分布式Docker部署节点
• 需要临时授权第三方访问特定Docker集群的场景
• 避免直接暴露Docker daemon端口的安全加固需求

使用方法

服务器端配置（远程Docker集群）

在目标远程Docker CE/EE集群的主机上，运行服务器端容器以生成访问令牌：

bash
docker run -it --rm -e DOCKER_HOST docker/remote:server

参数说明：

• -e DOCKER_HOST：必填环境变量，指定远程Docker daemon的地址（如tcp://0.0.0.0:2375或unix:///var/run/docker.sock），用于服务器端连接本地Docker服务

运行后，服务器端将输出类似以下信息：

Setting things up... done!
Share this token with the person you want to give access to this cluster:
    3j8WYoa5PZxomhvBvDmaB

Incoming requests will appear below. To stop, just press Control+C.

-> GET /container/json
-> GET /services

记录输出的访问令牌（如示例中的3j8WYoa5PZxomhvBvDmaB），用于客户端连接。

客户端配置（本地机器）

在本地客户端机器上，运行客户端容器并输入服务器端提供的令牌：

bash
docker run -it --rm docker/remote:client

根据提示输入服务器端生成的令牌：

Please enter the token to connect to: 3j8WYoa5PZxomhvBvDmaB
Connecting... done!

连接成功后，即可在客户端终端执行远程Docker命令，例如：

bash
# 查看远程集群中的容器
docker ps

# 查看远程集群中的服务
docker services

构建镜像

如需自行构建镜像，可使用以下命令：

构建客户端镜像

构建docker/remote:client镜像：

bash
make client-image

构建服务器端镜像

构建docker/remote:server镜像：

bash
make server-image