上一篇
VScode使用SSH远程连接Ubuntu：超详细教程
VScode使用SSH远程连接Ubuntu：超详细教程
从零开始，小白也能轻松上手
欢迎阅读本教程！如果你是一名开发者，想要在本地VScode中远程连接Ubuntu系统进行开发，那么你来对地方了。本教程将详细讲解如何使用SSH协议实现VScode远程连接Ubuntu，步骤超简单，即使是新手也能快速掌握。VScode SSH连接是现代远程开发的热门方式，能极大提升工作效率。
前提条件
在开始之前，请确保你已满足以下条件：
- 一台已安装Ubuntu系统的远程服务器或虚拟机（推荐Ubuntu 18.04或更高版本）。
- 本地计算机已安装VScode（Visual Studio Code）。
- 远程Ubuntu系统已联网，并具有sudo权限的用户账户。
- 基本熟悉命令行操作。
步骤一：在Ubuntu上安装和配置SSH服务
首先，我们需要在Ubuntu系统上安装SSH服务器，以实现远程访问。这是Ubuntu远程开发的基础步骤。
- 打开Ubuntu终端（快捷键Ctrl+Alt+T）。
- 输入以下命令安装OpenSSH服务器：
sudo apt update && sudo apt install openssh-server -y - 安装完成后，启动SSH服务：
sudo systemctl start ssh - 设置SSH服务开机自启：
sudo systemctl enable ssh - 检查SSH服务状态，确认运行正常：
sudo systemctl status ssh
如果看到“active (running)”字样，说明SSH服务已成功启动。现在，你的Ubuntu系统已准备好接受SSH连接。
步骤二：在VScode中安装Remote-SSH扩展
接下来，我们需要在本地VScode中安装Remote-SSH扩展，这是实现VScode远程开发的关键工具。
- 打开本地VScode。
- 点击左侧活动栏的“扩展”图标（或按Ctrl+Shift+X）。
- 在搜索框中输入“Remote - SSH”，找到由Microsoft发布的扩展，点击“安装”。
- 安装完成后，重启VScode以激活扩展。
这个扩展允许VScode通过SSH连接到远程机器，并直接在本地编辑远程文件。
步骤三：配置SSH连接
现在，我们将配置VScode连接到Ubuntu系统。请确保你知道Ubuntu系统的IP地址（可通过在Ubuntu终端输入ip addr show查看）和用户名。
- 在VScode中，按F1键打开命令面板，输入“Remote-SSH: Connect to Host”，并选择它。
- 选择“Add New SSH Host”，然后输入SSH连接命令：
ssh username@ubuntu_ip_address例如：ssh user@192.168.1.100。将“username”替换为你的Ubuntu用户名，“ubuntu_ip_address”替换为Ubuntu系统的IP地址。 - VScode会提示选择SSH配置文件，通常选择默认的
~/.ssh/config文件。 - 接下来，点击右下角弹出的“Connect”按钮，VScode将尝试通过SSH连接Ubuntu。
- 首次连接时，可能会提示输入Ubuntu用户的密码（或使用SSH密钥认证）。输入密码后，VScode将在新窗口中打开远程连接。
这个SSH配置教程部分确保了连接的安全性和稳定性。如果连接成功，你将看到VScode左下角显示“SSH: ubuntu_ip_address”，表示已连接到远程Ubuntu。
步骤四：测试连接和开始开发
连接成功后，你可以在VScode中直接访问Ubuntu系统的文件系统，进行代码编辑和运行。
- 在VScode中，点击“文件”菜单，选择“打开文件夹”，然后浏览远程Ubuntu上的目录（如
/home/username/projects）。 - 打开一个文件进行编辑，保存更改将直接应用到远程Ubuntu系统。
- 你还可以使用VScode的集成终端（Ctrl+`）在远程Ubuntu上执行命令，就像在本地一样。
至此，你已经成功实现了VScode远程连接Ubuntu！现在可以享受无缝的远程开发体验了。
常见问题与解决方案
- 连接超时或失败：检查Ubuntu防火墙设置，确保SSH端口（默认22）开放。在Ubuntu终端运行
sudo ufw allow ssh。 - 密码认证问题：如果不想每次输入密码，可以配置SSH密钥认证。在本地生成密钥对，并将公钥添加到Ubuntu的
~/.ssh/authorized_keys文件中。 - VScode扩展不工作：部分VScode扩展需要在远程Ubuntu上重新安装。连接后，VScode会提示安装推荐扩展。
总结
本教程详细介绍了VScode使用SSH远程连接Ubuntu的步骤，从安装SSH服务到配置VScode扩展，每一步都力求简单明了。通过VScode SSH连接，你可以轻松实现Ubuntu远程开发，提升开发效率。如果你遇到任何问题，请参考常见问题部分或搜索在线资源。现在，开始你的远程开发之旅吧！
本文由主机测评网于2026-01-14发表在主机测评网_免费VPS_免费云服务器_免费独立服务器，如有疑问，请联系我们。
本文链接：https://www.vpshk.cn/20260117644.html
