使用 VSCode 通过 Remote-SSH 连接远程服务器详细教程

Ne0inhk

— 8 min read
使用 VSCode 通过 Remote-SSH 连接远程服务器详细教程

使用 VSCode 通过 Remote-SSH 连接远程服务器详细教程

在日常开发中，许多开发者需要远程连接服务器进行代码编辑和调试。Visual Studio Code（VSCode）提供了一个非常强大的扩展——Remote-SSH，它允许我们通过 SSH 协议直接连接远程服务器，在本地编辑服务器上的代码，极大提高了开发效率。本文将详细讲解如何使用 VSCode 连接远程服务器，涵盖从插件安装到连接服务器的整个流程。

一、前提条件

1. 本地环境准备

在开始之前，确保你的本地环境满足以下条件：

  1. Visual Studio Code 已安装，版本最好是最新稳定版，确保可以支持最新的 Remote-SSH 功能。
  2. SSH 客户端 已正确安装并配置：
    • Linux 和 Mac 系统自带 OpenSSH 客户端，一般不需要额外安装。

Windows 用户需要通过 PowerShell 或 Windows 设置中启用 OpenSSH，或者使用 Git Bash 或 WSL 提供的 SSH 客户端。可以通过如下命令确认 SSH 是否可用：

ssh -V

如果未安装，可以通过 Windows 的 可选功能 中启用或使用 choco 安装：

choco install openssh

2. 远程服务器准备

确保你拥有以下远程服务器的信息：

  1. SSH 访问权限：
    • 远程服务器支持 SSH 协议。
    • 你有服务器的 IP 地址、用户名 和 密码，或 SSH 密钥。
  2. 防火墙配置：
    • 确保服务器的 SSH 端口（通常为 22）对你的本地 IP 开放。如果使用自定义端口，需要知道该端口号。
  3. 服务器配置：

Linux 系统的服务器通常默认支持 SSH，但一些轻量级发行版可能需要提前安装并启用 OpenSSH 服务器：

sudoaptinstall openssh-server # Debian/Ubuntu 系列sudo systemctl enablesshsudo systemctl start ssh

二、步骤详解

1. 安装 Remote-SSH 插件

打开 VSCode，点击左侧活动栏最下方的 扩展 (Extensions) 图标，或者按 Ctrl+Shift+X 快捷键调出扩展商店。在搜索栏中输入 “Remote - SSH”，并点击 安装 来安装该扩展。安装完成后，VSCode 的左下角会出现一个绿色的远程连接按钮，表明插件安装成功。

2. 启动 Remote-SSH 连接

插件安装完成后，点击 左下角的绿色图标，这将打开 Remote-SSH 的操作菜单。

打开Remote-SSH

在弹出的菜单中，选择 Connect to Host，即 “连接到主机”。

选择Connect to Host

3. 添加新的 SSH 主机

点击 Add New SSH Host，也就是 “添加新的 SSH 主机” 选项，准备配置你要连接的远程服务器。

选择Add New SSH Host

4. 输入 SSH 连接命令

接下来，VSCode 会要求你输入远程服务器的 SSH 命令。格式如下：

ssh 用户名@服务器IP地址

例如，如果服务器的 IP 地址是 192.168.0.1，用户名是 user，你需要输入的命令是：

ssh [email protected]

如果服务器使用的是自定义端口（如 2200），你需要指定端口：

ssh [email protected] -p 2200
输入SSH命令

5. 选择 SSH 配置文件位置

输入 SSH 命令后，VSCode 会提示你选择存放 SSH 主机配置信息的文件位置。建议选择默认的 SSH 配置文件，通常是 ~/.ssh/config。

选择默认SSH配置文件

如果你之前没有配置过，可以直接选择该文件。它会自动生成配置项，方便后续连接。

配置文件 ~/.ssh/config 的示例如下：

Host myserver HostName 192.168.0.1 User user Port 2200# 如果不是默认端口，则手动添加该行
  • Host 字段是一个别名，方便你后续通过 ssh myserver 连接到该服务器。
  • HostName 表示远程服务器的 IP 地址或域名。
  • User 是登录的用户名。

6. 连接远程主机

添加 SSH 主机后，VSCode 会提示你返回 Remote-SSH 菜单，选择刚刚添加的主机进行连接。点击主机名称后，VSCode 将自动打开一个新窗口并尝试连接到远程服务器。

选择Connect连接远程服务器

7. 选择远程操作系统

连接服务器后，VSCode 会询问远程服务器的操作系统类型。根据服务器的操作系统（通常是 Linux），选择对应的选项。

选择远程系统类型

8. 输入 SSH 密码

如果是首次连接该服务器，系统会要求你输入 SSH 密码（或者在使用密钥的情况下，可能需要输入密钥的密码）。输入密码后，按回车即可。

输入SSH密码

9. 连接成功

当连接成功后，VSCode 左下角会显示远程服务器的名称，表示已经成功连接上远程服务器。

显示服务器名称

三、常见问题及解决方案

1. SSH 连接失败或超时

  • 可能原因：
    • 防火墙阻止了 SSH 端口（默认 22）的访问。
    • SSH 服务未在服务器上启动。
    • 使用了错误的 IP 地址或用户名。
  • 解决方案：
    • 确认 SSH 账号信息是否正确，确保公钥和私钥对匹配。

确保服务器上运行了 SSH 服务：

sudo systemctl status ssh

检查服务器的 SSH 端口是否开放，可以使用以下命令测试：

telnet 192.168.0.1 22

2. 密钥认证失败

  • 可能原因：密钥权限不正确，或公钥未正确添加到远程服务器的 ~/.ssh/authorized_keys 文件中。
  • 解决方案：
    • 确保公钥正确地添加到了远程服务器的 ~/.ssh/authorized_keys 中，并且权限设置为 600。

确保私钥文件的权限为 600：

chmod600 ~/.ssh/id_rsa

3. 远程文件过大导致操作缓慢

  • 可能原因：如果你在编辑非常大的文件，或者远程服务器网络带宽较低，操作可能会变慢。
  • 解决方案：在 VSCode 中，可以设置 文件大小警告阈值，并使用压缩文件传输等方式优化性能。还可以使用 rsync 等工具手动同步大文件。

四、提高远程开发效率的技巧

  1. 使用 VSCode 终端：在连接远程服务器后，你可以直接使用 VSCode 的集成终端运行服务器上的命令，避免频繁切换窗口。
  2. 远程调试：VSCode 支持通过 Remote-SSH 进行远程调试，你可以直接在远程服务器上调试应用程序，尤其是 Node.js、Python、Java 等语言的开发。
  3. Git 版本控制：你可以直接在 VSCode 中使用 Git 进行版本控制，所有操作都会在远程服务器上执行，这使得你可以在远程环境中直接提交代码。
  4. 同步设置：VSCode 提供了设置同步功能，可以在本地和远程服务器之间保持一致的开发配置，从而提高工作效率。

通过以上详细的配置和使用步骤，你可以顺利地通过 VSCode 的 Remote-SSH 插件连接到远程服务器，并在本地进行高效的远程开发。希望这篇教程能帮助你解决在实际开发中遇到的各种问题，提升工作效率。

Read more

Python从0到100（九十九）：基于空间注意力Spatial Attention Neural Network的网络设计与实现

Python从0到100（九十九）：基于空间注意力Spatial Attention Neural Network的网络设计与实现

前言：零基础学Python：Python从0到100最新最全教程。 想做这件事情很久了，这次我更新了自己所写过的所有博客，汇集成了Python从0到100，共一百节课，帮助大家一个月时间里从零基础到学习Python基础语法、Python爬虫、Web开发、 计算机视觉、机器学习、神经网络以及人工智能相关知识，成为学业升学和工作就业的先行者！ 【优惠信息】 • 新专栏订阅前500名享9.9元优惠 • 订阅量破500后价格上涨至19.9元 • 订阅本专栏可免费加入粉丝福利群，享受： - 所有问题解答 -专属福利领取 欢迎大家订阅专栏：零基础学Python：Python从0到100最新最全教程！ 本文目录： * 一、SANN的理论基础与创新点 * 1. 传统卷积神经网络在时序数据处理中的局限性 * 2. SANN的核心创新 * 3. 技术优势分析 * 二、SANN架构设计详解 * 1. 整体架构概览 * 2. SpatialAttentionModule：空间注意力模块详解 * 2.1 通道维度特征聚合 * 2.2 注意力权重计

By Ne0inhk

Python缠论分析完整指南：如何实现自动化买卖点识别与策略优化

Python缠论分析完整指南：如何实现自动化买卖点识别与策略优化 【免费下载链接】chan.py开放式的缠论python实现框架，支持形态学/动力学买卖点分析计算，多级别K线联立，区间套策略，可视化绘图，多种数据接入，策略开发，交易系统对接； 项目地址: https://gitcode.com/gh_mirrors/ch/chan.py 还在为复杂的缠论计算而头疼吗？面对传统技术分析工具的局限性，Python缠论分析框架为你提供了一套完整的解决方案。这个开源工具能够自动化处理笔、线段、中枢等核心缠论元素，支持多级别K线联立分析和实时动态更新，让你的交易决策更加科学精准。 为什么传统缠论分析难以落地？ 手工计算的三大瓶颈：从分形识别到线段划分，再到中枢标注，整个过程耗时耗力；多时间级别的同步分析几乎不可能手动完成；信号动态变化难以持续跟踪。 程序化缠论的优势：🚀 自动化完成复杂计算、📈 多级别同步验证、🔄 实时信号更新，真正实现了缠论理论的工程化应用。 通过多级别联立分析，你可以清晰地看到日线级别和30分钟级别的趋势线如何相互印证，这正是缠论"区间套"理论的程序化

By Ne0inhk

【启发式算法】RRT*算法详细介绍（Python）

RRT* 算法原理 RRT*（Rapidly-exploring Random Tree Star）是RRT算法的优化版本，通过渐进最优的方式改进路径质量。核心思想是在扩展树的过程中重新选择父节点和重布线，以降低路径成本。 * 采样：在配置空间中随机采样点。 * 最近邻搜索：找到树上距离采样点最近的节点。 * 扩展：从最近节点向采样点方向扩展新节点。 * 父节点优化：在新节点附近半径内寻找成本更低的父节点。 * 重布线：优化附近节点的父节点以降低整体路径成本。 Python 实现步骤 初始化环境 定义二维空间、起点、终点和障碍物： import numpy as np import matplotlib.pyplot as plt class RRTStar: def __init__(self, start, goal, obstacles, bounds, max_iter=1000, step_size=

By Ne0inhk
【JAVA资料，C#资料，人工智能资料，Python资料】全网最全编程学习文档合集，从入门到全栈，保姆级整理！

【JAVA资料，C#资料，人工智能资料，Python资料】全网最全编程学习文档合集，从入门到全栈，保姆级整理！

文章目录 * 前言 * 一、编程学习前的准备 * 1.1 明确学习目标 * 1.2 评估自身基础 * 二、编程语言的选择 * 2.1 热门编程语言介绍 * 2.2 如何根据目标选择语言 * 三、编程基础学习 * 3.1 变量与数据类型 * 3.2 控制结构 * 3.3 函数 * 四、面向对象编程（OOP） * 4.1 OOP 基础概念 * 4.2 OOP 在实际项目中的应用 * 五、数据库基础 * 5.1 关系型数据库 * 5.2 非关系型数据库 * 六、Web

By Ne0inhk