vscode ssh远程服务器使用
时间: 2025-05-10 14:34:31 浏览: 31
### 配置与使用 VSCode SSH 远程服务器
#### 一、安装必要的扩展
为了支持通过 SSH 协议连接到远程服务器,需先在 Visual Studio Code 中安装 **Remote - SSH** 扩展。此扩展由 Microsoft 提供,能够帮助开发者轻松建立与远程服务器的安全连接[^1]。
#### 二、生成 SSH 密钥对
在本地计算机上执行以下命令以生成 RSA 类型的 SSH 密钥对:
```bash
ssh-keygen -t rsa
```
默认情况下,该命令会将密钥存储在 `~/.ssh` 文件夹下,其中私钥保存为 `id_rsa`,而公钥则命名为 `id_rsa.pub`[^3]。
#### 三、配置远程服务器授权
要实现免密码登录功能,需要将生成好的公钥内容追加至目标服务器用户的 `.ssh/authorized_keys` 文件里。以下是具体的操作方式之一——利用 `ssh-copy-id` 工具完成传输过程:
```bash
ssh-copy-id user@remote_host
```
或者手动复制粘贴也可以达到相同效果:
```bash
cat ~/.ssh/id_rsa.pub | ssh user@remote_host "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"
```
#### 四、创建 VSCode 的 SSH 配置文件
编辑或新建位于用户目录下的隐藏文件 `.ssh/config` ,添加如下条目定义目标主机的信息:
```plaintext
Host myserver
HostName remote_host_ip_or_domain_name
User your_username_on_remote_server
IdentityFile ~/.ssh/id_rsa
```
这样做的好处是可以简化后续调用流程,并增强可读性和管理效率[^2]。
#### 五、启动远程开发环境
回到 VSCode 主界面,在左侧活动栏找到并点击代表“远程资源”的图标按钮;接着从弹出菜单选项中选取 “Connect to Host...”,再选择之前设定过的别名(此处即 'myserver')。等待片刻之后便能加载对应的工作区了。
#### 六、排查常见错误
当遭遇诸如 `"Permission denied (publickey)"` 此类提示时,请核查以下几个方面:
- 确认公钥已被正确定位放置于远端机器中的 authorized_keys 列表项之中;
- 查看是否有其他安全策略阻止访问尝试,例如 SELinux 或 AppArmor 设置;
- 如果仍然失败,则考虑重启 sshd 守护进程以及调整 selinux 模式暂时设为 permissive 来测试连通状况。
---
阅读全文
相关推荐



















