vscode链接远程服务器
时间: 2025-06-12 15:50:46 浏览: 14
### 配置 VSCode 进行 SSH 远程连接
#### 准备工作
为了使 VSCode 能够通过 SSH 正常连接到远程服务器,需完成以下准备工作。确保本地计算机和目标服务器均已安装并启用了 SSH 服务[^1]。
#### 创建 SSH 密钥对
在本地计算机上执行 `ssh-keygen -t rsa` 命令生成一对公钥和私钥。默认情况下,这些密钥会存储在用户的 `.ssh` 文件夹下(路径通常是 `~/.ssh/` 或 Windows 下的 `C:\Users\<用户名>\.ssh\`)。此过程完成后,会在指定目录生成两个文件:`id_rsa` 和 `id_rsa.pub`[^2]。
#### 添加公钥至远程服务器
将生成的公钥内容追加到远程服务器上的 `~/.ssh/authorized_keys` 文件中。可以通过多种方式实现这一目的,例如使用 `scp` 工具或者手动复制粘贴。以下是利用 `cat` 和 `ssh` 的一种简单方法:
```bash
cat ~/.ssh/id_rsa.pub | ssh username@remote_host "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"
```
上述命令的作用是先读取本地公钥的内容并通过管道传递给远程主机,在那里它会被附加到授权密钥列表里[^3]。
#### 测试无密码登录功能
尝试再次建立与远程机器之间的 SSH 连接。如果一切正常的话,这次应该无需再输入任何密码即可顺利完成认证流程。
#### 安装 Remote - SSH 扩展
打开 Visual Studio Code 并访问其扩展市场页面寻找名为 “Remote – SSH” 的插件进行下载安装。这是官方提供的用于支持基于 Secure Shell 协议工作的必备组件之一。
#### 编辑配置文件
接着需要定义具体的链接参数信息。这一步骤涉及到编辑用户专属的 SSH Configurations 文档。对于大多数操作系统而言,默认位置应该是 `~/.ssh/config`; 对于部分特殊环境比如某些版本号较高的Windows系统来说,则可能是类似于 C:\Users\[YourUsername]\.ssh\config这样的地方。
在此文档内部添加如下样式的条目描述您的目标设备详情:
```plaintext
Host myserver
HostName your.server.ip.or.domain.name
User your_username_on_remote_server
Port 22 # 如果端口不是标准值则更改此处数值
```
保存修改后的配置之后回到 VSCODE 内部界面当中去触发实际的操作行为——即选择对应的选项卡从而激活新近设定好的 session 实例。
#### 解决可能存在的问题
当遇到诸如“Permission denied (publickey)”之类的报错提示时,请仔细核查以下几个方面的情况是否满足需求条件:
- 确认远端节点确实已经开启了相应的守护进程监听请求;
- 查看是否存在防火墙策略阻止外部访问进来;
- 双重确认之前上传上去的那个 public key 是否被妥善放置到了正确的位置并且具有恰当的安全属性设置等等。
---
阅读全文
相关推荐
















