VSCode 的 Docker 插件主要通过图形化界面简化镜像构建和本地运行，若需部署到远程服务器，需配合 SSH 上下文配置。配置完成后可实现界面内一键操作，但该方式适合开发调试阶段，不建议直接替代生产环境的 CI/CD 流水线。

命令速用版

如果你习惯使用命令行配合 VSCode，以下命令用于配置远程上下文，这是实现“远程一键部署”的前置条件：

# 查看当前 Docker 上下文
docker context ls

# 创建指向远程服务器的 SSH 上下文
docker context create ssh-remote `--docker` "host=ssh://user@ip-address"

# 切换到远程上下文
docker context use ssh-remote

在 VSCode 中配置完成后，右键点击 Dockerfile 或镜像即可看到构建和运行选项。

核心原理

VSCode 的 Docker 插件本身不是一个独立的部署引擎，它实际上是 Docker CLI 的图形化封装。当你点击“部署”或“运行”时，插件背后执行的是 docker build 和 docker run 命令。所谓的“一键部署到远程”，是通过 Docker Context 功能将本地 CLI 请求转发到远程服务器的 Docker Daemon。因此，网络连通性和 SSH 权限是核心依赖，插件只是降低了命令输入的复杂度。

分步处理

1. 安装插件：在 VSCode 扩展商店搜索 Docker，确认发布者为 Microsoft 后安装。

2. 准备配置文件：确保项目根目录有 Dockerfile 和 .dockerignore 文件，避免构建时上传无关文件。

3. 配置 SSH 免密与代理：确保本地 SSH 密钥已添加到远程服务器的 authorized_keys。为简化连接，建议在本地 ~/.ssh/config 中添加配置：

Host my-remote-server
    HostName 192.168.1.100
    User deploy
    IdentityFile ~/.ssh/id_rsa
    # 若密钥有 passphrase，确保 ssh-agent 已加载

4. 本地构建测试：在侧边栏 Docker 视图找到 IMAGES，右键点击 Dockerfile 选择 Build Image，标签建议包含版本号。

5. 配置远程连接：点击 VSCode 左侧活动栏 Docker 图标，在容器列表顶部找到上下文切换下拉框，添加 SSH 连接。若配置了 SSH Config，可直接选择主机别名。

6. 执行部署：切换上下文到远程服务器后，右键镜像选择 Run 或使用 Docker Compose 的 Up 命令。

怎么验证是否生效

1. 状态检查：在 VSCode 的 Docker 容器列表中，新部署的容器状态应显示为 Running。

2. 日志验证：右键点击容器选择 View Logs，确认应用启动日志无报错。

3. 网络连通：在终端执行 docker ps 确认端口映射是否正确，尝试 curl 本地映射端口验证服务响应：

curl -I http://localhost:8080

常见坑

1. SSH 权限与安全：远程服务器 SSH 配置禁止密码登录时，必须配置免密密钥。建议为密钥设置 passphrase 并通过 ssh-agent 管理，避免私钥泄露风险。

2. Docker 守护进程未启动：远程服务器必须安装 Docker Engine 且服务正在运行，插件无法自动安装服务端。

3. 网络隔离：如果服务器在内网，VSCode 所在机器必须能直接 SSH 通达，不支持通过跳板机自动代理（除非配置了 SSH Config ProxyCommand）。

4. 生产环境风险：插件操作缺乏回滚机制和审计日志，不建议直接用于生产环境更新。若必须使用，请创建专用的部署用户（非 root），仅赋予 Docker 组权限，遵循权限最小化原则。

参考来源

• Visual Studio Marketplace, Docker extension page, https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker
• Microsoft Learn, Develop containerized apps with Visual Studio Code, https://learn.microsoft.com/zh-cn/visualstudio/containers/overview