VSCode Remote-SSH 配置

安装 VSCode 的 Remote-SSH 扩展,通过 SSH 连接到远程服务器进行开发。配置步骤如下:

  1. 在 VSCode 中安装 Remote-SSH 扩展
  2. 按 F1 打开命令面板,输入 "Remote-SSH: Add New SSH Host"
  3. 输入 SSH 连接命令,格式为 username@hostname -p port
  4. 选择配置文件保存位置(通常为 ~/.ssh/config
  5. 连接时会提示输入密码或使用密钥认证

典型 SSH 配置文件示例:

Host dev-server
    HostName 192.168.1.100
    User devuser
    Port 22
    IdentityFile ~/.ssh/id_rsa

CPolar 内网穿透设置

CPolar 创建安全隧道将本地开发环境暴露到公网:

  1. CPolar 官网 下载并安装对应版本
  2. 注册账号获取认证 token
  3. 配置需要穿透的服务,例如 SSH 服务:
    cpolar tcp 22
    

  4. 获取公网地址,格式为 tcp://x.cpolar.cn:xxxxx

开发环境协同配置

结合两者实现多地访问开发环境:

本地开发机通过 VSCode Remote-SSH 连接内网服务器,异地设备通过 CPolar 生成的公网地址连接同一服务器。保持 .vscode/settings.json 配置同步:

{
    "remote.SSH.remotePlatform": {
        "dev-server": "linux"
    },
    "remote.SSH.defaultExtensions": [
        "ms-vscode.cpptools",
        "ms-python.python"
    ]
}

安全强化措施

  1. 使用 SSH 密钥替代密码认证
  2. 限制 CPolar 访问 IP 范围
  3. 定期更新 SSH 端口和 CPolar 认证 token
  4. 在服务器启用防火墙,仅开放必要端口
  5. 使用 fail2ban 防止暴力破解

性能优化建议

  1. 在 VSCode 设置中启用 remote.SSH.lockfilesInTmp 减少网络传输
  2. 配置 Compression yes 加速 SSH 连接
  3. 使用 ControlMaster 复用 SSH 连接
  4. 对 CPolar 连接启用加密选项
  5. 在内存充足的服务器上启用 UseLoginShell 提升响应速度

典型问题排查

连接失败时检查步骤:

  1. 验证本地到服务器的基本 SSH 连接
  2. 确认 CPolar 进程正常运行
  3. 检查服务器防火墙设置
  4. 查看 VSCode 输出面板的 Remote-SSH 日志
  5. 测试更换网络环境(如切换 4G/WiFi)

网络延迟较高时可尝试:

  1. 在 VSCode 设置中调整 remote.SSH.useLocalServer
  2. 更换 CPolar 服务器区域
  3. 禁用不需要的 VSCode 扩展
  4. 使用 mosh 替代原生 SSH 连接(需额外配置)
Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐