VSCode远程开发深度解析：使用SSH连接你的云服务器

需通过SSH连接远程云服务器以在VSCode中编辑调试代码，操作包括：一、安装Remote-SSH扩展并重启；二、配置~/.ssh/config主机信息；三、用命令面板连接主机；四、配置密钥免密登录；五、排查超时与端口错误。

如果您希望在本地 VSCode 编辑器中直接编辑、调试和运行部署在远程云服务器上的代码，则需通过 SSH 协议建立稳定安全的连接通道。以下是实现该目标的详细操作路径：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装 Remote-SSH 扩展

Remote-SSH 是 VSCode 官方提供的核心扩展，用于启用远程开发能力，它负责管理 SSH 连接、远程服务器端代理进程及文件同步逻辑。

1、打开 VSCode，点击左侧活动栏最下方的扩展图标（四个方块组成的图标）。

2、在扩展搜索框中输入 Remote-SSH。

3、在搜索结果中找到由 Microsoft 发布的 Remote - SSH 扩展，点击“安装”按钮。

4、安装完成后，重启 VSCode 以确保扩展完全加载。

二、配置 SSH 主机连接信息

VSCode 依赖本地 ~/.ssh/config 文件或内置连接面板生成可识别的主机条目，该配置定义了目标服务器地址、端口、用户身份及密钥路径等关键参数。

1、在终端中执行 mkdir -p ~/.ssh 确保 SSH 配置目录存在。

2、使用命令 nano ~/.ssh/config 打开配置文件。

3、写入如下格式内容（请替换为实际值）：

Host my-cloud-server

  HostName 123.45.67.89

  User ubuntu

  Port 22

  IdentityFile ~/.ssh/id_rsa_cloud

4、保存并退出编辑器，执行 chmod 600 ~/.ssh/config 设置安全权限。

三、通过命令面板触发远程连接

VSCode 提供图形化入口快速调用远程会话，避免手动输入连接字符串，同时支持自动检测已配置主机。

Word Docx 1

创建、检查和编辑 Microsoft Word 文档及 DOCX 文件，支持样式、编号、修订记录、表格、分节符及兼容性检查等功能。

下载

1、按下 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Windows/Linux）打开命令面板。

2、输入 Remote-SSH: Connect to Host... 并回车。

3、从下拉列表中选择已配置的主机名 my-cloud-server。

4、首次连接时，VSCode 将自动在远程服务器上部署 server 启动脚本，并提示输入密码或确认密钥指纹。

四、使用 SSH 密钥免密登录（替代密码验证）

为提升连接安全性与自动化效率，应禁用密码登录，仅允许基于公钥的身份认证。此方式要求本地私钥与远程服务器 authorized_keys 文件严格匹配。

1、在本地终端运行 ssh-keygen -t ed25519 -C "your_email@example.com" 生成新密钥对。

2、执行 ssh-copy-id -i ~/.ssh/id_ed25519.pub ubuntu@123.45.67.89 将公钥上传至服务器。

3、登录服务器后，检查 ~/.ssh/authorized_keys 是否包含对应公钥行。

4、编辑服务器端 /etc/ssh/sshd_config，确认以下两行未被注释且值为 yes：

PubkeyAuthentication yes

PasswordAuthentication no

5、执行 sudo systemctl restart sshd 重载 SSH 服务配置。

五、处理连接超时与端口被拒错误

网络策略、防火墙规则或 SSH 服务状态异常常导致连接中断或拒绝，需分层排查链路各环节是否就绪。

1、在本地终端运行 ssh -T -p 22 ubuntu@123.45.67.89 测试基础连通性。

2、若返回 Connection refused，登录服务器控制台，执行 sudo systemctl status ssh 检查服务是否运行。

3、若返回 Connection timed out，检查云服务商安全组是否放行 TCP 端口 22。

4、在服务器上运行 sudo ufw status verbose 查看防火墙规则，必要时添加 sudo ufw allow OpenSSH。