VSCode Remote SSH：跳板机中转访问远程服务器与Docker指南

作者：rousong2025.10.13 16:26浏览量：68

简介：本文详细介绍了如何利用VSCode Remote SSH功能，通过跳板机间接连接远程服务器或服务器内的Docker容器，解决复杂网络环境下的开发难题，提升远程开发效率。

VSCode Remote SSH实现本地机借助跳板机连接远程服务器（或服务器中的docker）

在当今分布式开发与云计算盛行的时代，开发者经常需要面对复杂的网络环境，尤其是在需要访问内网或受安全策略限制的远程服务器时。直接连接往往不可行，这时借助跳板机（Bastion Host或Jump Server）成为了一种常见的解决方案。而VSCode作为一款强大的代码编辑器，其Remote SSH扩展更是为远程开发提供了极大便利。本文将详细阐述如何利用VSCode Remote SSH功能，通过跳板机间接连接远程服务器，甚至进一步访问服务器内的Docker容器，为开发者提供一套高效、安全的远程开发方案。

一、理解跳板机的作用与配置

跳板机的作用

跳板机作为安全访问内网资源的中间层，主要作用包括：

  • 安全隔离：将外部网络与内部网络隔离，减少直接暴露的风险。
  • 访问控制：通过跳板机可以实施更细粒度的访问控制策略。
  • 审计与日志：记录所有通过跳板机的访问行为，便于安全审计。

跳板机的配置

配置跳板机通常涉及以下几个方面：

  1. 安装SSH服务：确保跳板机上安装并运行了SSH服务。
  2. 用户管理：为需要访问的开发者创建用户账户，并配置相应的权限。
  3. 防火墙规则：设置防火墙规则，仅允许来自特定IP或网络的SSH连接。
  4. 密钥认证：推荐使用SSH密钥对进行认证，提高安全性。

二、VSCode Remote SSH基础

安装与配置

  1. 安装VSCode：从官网下载并安装最新版本的VSCode。
  2. 安装Remote SSH扩展：在VSCode的扩展市场中搜索并安装“Remote - SSH”。
  3. 配置SSH客户端：确保本地机已安装SSH客户端（如OpenSSH），并配置好SSH配置文件（~/.ssh/config）。

基本使用

  1. 打开命令面板：在VSCode中按F1或Ctrl+Shift+P打开命令面板。
  2. 选择Remote-SSH: Connect to Host…：从列表中选择或输入要连接的远程主机信息。
  3. 输入密码或使用密钥：根据配置，输入密码或使用SSH密钥进行认证。

三、通过跳板机连接远程服务器

配置SSH跳转

为了通过跳板机连接远程服务器，我们需要在SSH配置文件中设置代理跳转。编辑~/.ssh/config文件，添加如下配置：

  1. Host jumpbox
  2.   HostName <跳板机IP或域名>
  3.   User <跳板机用户名>
  4.   IdentityFile <跳板机私钥路径>
  6. Host target-server
  7.   HostName <目标服务器IP或域名>
  8.   User <目标服务器用户名>
  9.   ProxyJump jumpbox
  10.   IdentityFile <目标服务器私钥路径>

在VSCode中使用

配置完成后，在VSCode的Remote SSH连接列表中，选择或输入target-server作为主机名，VSCode将自动通过跳板机进行连接。

四、访问服务器中的Docker容器

Docker容器内的SSH服务

要在Docker容器内使用SSH服务，首先需要在Dockerfile中安装并配置SSH服务。以下是一个简单的示例：

  1. FROM ubuntu:latest
  3. RUN apt-get update && \
  4.     apt-get install -y openssh-server && \
  5.     mkdir /var/run/sshd && \
  6.     echo 'root:password' | chpasswd && \
  7.     sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/' /etc/ssh/sshd_config && \
  8.     sed -i 's/#PasswordAuthentication yes/PasswordAuthentication yes/' /etc/ssh/sshd_config && \
  9.     echo "export VISIBLE=now" >> /etc/profile
  11. EXPOSE 22
  12. CMD ["/usr/sbin/sshd", "-D"]

注意：示例中使用了简单的密码认证，实际应用中应使用更安全的密钥认证方式。

构建并运行Docker容器

  1. docker build -t ssh-server .
  2. docker run -d -p 2222:22 --name my-ssh-server ssh-server

这里将容器的22端口映射到宿主机的2222端口。

通过跳板机连接Docker容器

由于Docker容器运行在服务器上，我们可以通过修改之前的SSH配置，将目标主机设置为服务器，然后在VSCode中连接到服务器后，使用SSH命令进一步连接到容器的端口（如ssh root@localhost -p 2222）。但更优雅的方式是直接在SSH配置中设置端口转发：

  1. Host docker-container
  2.   HostName <服务器IP或域名>
  3.   User <服务器用户名>
  4.   ProxyJump jumpbox
  5.   Port 2222  # 假设容器SSH端口映射到宿主机的2222
  6.   IdentityFile <服务器私钥路径>
  7.   # 如果需要，可以添加额外的配置，如LocalForward等

然而，由于Docker容器的IP和端口是动态的（除非使用固定IP或主机网络模式），更实用的方法是在连接到服务器后，通过VSCode的终端手动执行SSH命令进入容器，或者使用Docker扩展直接管理容器。

五、优化与安全建议

使用SSH配置别名

为简化连接过程，可以在SSH配置文件中为复杂连接设置别名，如上文所示。

密钥管理

使用SSH密钥对进行认证，避免密码传输的安全风险。同时，妥善保管私钥，设置合适的文件权限。

跳板机审计

定期审计跳板机的访问日志，及时发现并处理异常访问行为。

多因素认证

考虑在跳板机上实施多因素认证（MFA），进一步提高安全性。

使用VSCode的Remote - Containers扩展

对于Docker容器内的开发，VSCode的Remote - Containers扩展提供了更直接和集成的开发体验。它允许你直接在容器内打开一个VSCode窗口，无需手动SSH连接。

六、结论

通过VSCode Remote SSH功能结合跳板机，开发者可以轻松应对复杂网络环境下的远程开发需求。无论是直接连接远程服务器，还是进一步访问服务器内的Docker容器，VSCode都提供了强大而灵活的支持。结合合理的安全配置和优化建议，这一方案不仅能够提升开发效率，还能确保开发环境的安全性。希望本文能为广大开发者提供有价值的参考和启发。

最热文章