连接到远程 Docker 通过 SSH
我们建议使用 Visual Studio Code Remote - SSH 扩展来连接到运行 Docker 引擎的远程计算机。您可以将 Remote - SSH 和 Dev Containers 扩展一起使用。您可以查看开发容器文档中的步骤。
也可以使用 SSH 隧道直接连接到远程 Docker 引擎,您可以在下面阅读更多相关信息。
设置 SSH 隧道
-
使用 ssh-keygen 或类似工具获取并配置用于 SSH 身份验证的公钥/私钥对。Docker 不支持密码身份验证,并且基于
DOCKER_HOST
的配置也不可能进行密码身份验证。如果密钥对已设置,则可以使用它。 -
在本地系统上使用上面生成的私钥文件配置
ssh-agent
。-
Windows (OpenSSH): 最新版本的 Windows 10 默认包含 OpenSSH。Windows 服务
ssh-agent
默认处于禁用状态,需要重新启用并设置为自动启动。从管理员 PowerShell 提示符处,运行Set-Service ssh-agent -StartupType "Automatic"
和Start-Service ssh-agent
。然后,执行ssh-add <keyfile>
。 -
Windows (Pageant): 您可以使用 Pageant 代替 OpenSSH,在这种情况下,需要设置环境变量
SSH_AUTH_SOCK=pageant
。将其设置为用户或系统环境变量将是最简单的方法。 -
Linux: 默认情况下存在
ssh-agent
。执行ssh-add <keyfile>
。已测试 Ubuntu;您在其他发行版上可能会得到不同的结果。 -
macOS: 默认情况下存在
ssh-agent
,但ssh-add
不会在登录之间持久存在。执行ssh-add <keyfile>
。我们建议配置 VS Code 以在终端启动时通过 terminal.integrated.profiles.osxargs
值运行此命令,或以其他方式配置启动脚本。您也可以在每次登录时手动运行该命令。
-
-
使用
ssh-add -l
验证您的身份是否可用于代理。它应该列出一个或多个类似于2048 SHA256:abcdefghijk somethingsomething (RSA)
的身份。如果它未列出任何身份,您将无法连接。此外,它需要具有正确的身份。Docker CLI 工作并不意味着资源管理器窗口将工作。资源管理器窗口使用 dockerode(它又使用 ssh2),而 Docker CLI 使用ssh
命令,并受益于自动推断的配置。 -
创建一个指向运行 Docker 的远程计算机的 Docker 上下文。使用
ssh://username@host:port
作为 Docker 端点(将“host”替换为您的远程计算机名称或远程计算机 IP 地址)。从终端窗口发出以下命令docker context create my-remote-docker-machine --docker "host=ssh://username@host:port"
始终在 Docker 端点地址中包含用户名,即使它与本地用户名相同也是如此。如果省略端口,则默认为 22。
-
使用命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 发出 Docker Contexts: Use 命令以激活指向远程计算机的 Docker 上下文。此命令使 VS Code 和 Docker CLI 都使用远程计算机上下文。
如果您没有此命令,请确保安装 Docker 扩展。
-
建议将刷新率更改为比默认值更长的时间,使用
docker.explorerRefreshInterval
设置。通过 SSH 的连接速度较慢,并且可能会导致在前一次刷新完成之前尝试再次刷新。我们建议至少 3000 毫秒。
提示
-
Docker 端点字符串 (
ssh://username@host:port
) 中的 “host” 部分必须是全局可解析的 DNS 计算机名称或 IP 地址。Docker 扩展将无法使用在 SSH 配置文件中定义的主机别名。 -
确保远程计算机主机密钥已 在 known_hosts 文件中 记住。确保这一点的最简单方法是通过
ssh
客户端程序连接到计算机(从命令行运行ssh username@host:port
)。首次连接时,ssh
程序将显示主机密钥,并让您批准它,从而自动更新known_hosts
文件。 -
Windows 10 build 1909 及更早版本附带的 ssh-keygen 实用程序存在问题,这会阻止它与较新的 SSH 守护程序(例如,Ubuntu 20.04 LTS 及更高版本附带的守护程序)正常工作。解决方法是使用 ECDSA 类型密钥,而不是 RSA 类型密钥进行 SSH 连接。您可以使用以下命令生成 ECDSA SSH 密钥并将其添加到 SSH 代理
ssh-keygen -t ecdsa -b 521 ssh-add id_ecdsa
-
Windows 10 build 1909 及更早版本受到 一个问题的 影响,该问题阻止 SSH 在 Windows 操作系统更新后获取您的身份。解决方法是向系统配置添加一个虚拟服务条目。从管理 PowerShell 窗口运行以下命令
New-Service sshd -BinaryPathName "C:\Windows\System32\OpenSSH\ssh.exe"