【VSCode】Remote-SSH拓展（远程编程）

VSCode 中使用 SSH 进行远程编程。

1. 安装必要扩展

首先需要安装 Remote - SSH 扩展：

· 打开 VSCode
· 进入扩展市场 (Ctrl+Shift+X)
· 搜索 “Remote - SSH”
· 安装 Microsoft 官方发布的扩展

2. 配置 SSH 连接

方法一：通过命令面板

1. 按 F1 或 Ctrl+Shift+P
2. 输入 “Remote-SSH: Connect to Host”
3. 选择 “Add New SSH Host”
4. 输入 SSH 连接命令：ssh username@hostname -p port

方法二：编辑配置文件

编辑 ~/.ssh/config 文件（Linux/Mac）或 C:\Users\用户名.ssh\config（Windows）：

Host myserver
    HostName your-server.com
    User username
    Port 22
    IdentityFile ~/.ssh/id_rsa

3. 连接远程服务器

4. 按 F1 → “Remote-SSH: Connect to Host”

5. 选择配置好的主机

6. 首次连接会安装 VS Code Server

7. 输入密码（如果使用密钥认证则不需要）

8. 基本使用

打开远程文件夹

· 连接成功后，使用 File → Open Folder 打开远程目录
· 可以像本地一样编辑文件

终端操作

· 在远程环境中，终端直接连接到远程服务器的 shell
· 可以直接运行服务器上的命令

5. 高级功能

端口转发

// 在 settings.json 中配置
{
    "remote.SSH.remotePlatform": {
        "myserver": "linux"
    },
    "remote.SSH.enableDynamicForwarding": true
}

扩展管理

· 部分扩展需要在远程重新安装
· 设置可以同步或分别配置

6. 常见问题解决

连接超时

Host myserver
    HostName your-server.com
    User username
    ServerAliveInterval 60

权限问题

# 在服务器上确保用户有相应权限
chmod 700 ~/.vscode-server

7. 实用技巧

8. 多主机管理：配置多个 SSH host 方便切换

9. 设置同步：使用 Settings Sync 保持配置一致

10. 远程调试：直接在远程环境中调试代码

11. 集成终端：多个终端会话管理

12. 安全建议

· 使用 SSH 密钥认证而非密码
· 定期更新 SSH 密钥
· 限制服务器访问权限
· 使用防火墙限制访问 IP