VSCode 连接 VPS 的详细指南
卡尔云官网
www.kaeryun.com
在开发过程中，有时候需要在本地使用 VSCode 直接连接到 VPS（虚拟服务器），以便进行调试、测试或者直接运行代码，虽然 VSCode 本身已经支持 SSH 连接，但有时候可能需要额外配置以达到最佳效果，本文将详细介绍如何在 VSCode 中连接到 VPS。
准备工作
确认 VPS 的设置
确保你的 VPS 已经配置好了 SSH 服务，并且公钥认证（PGP Key）已经生成，你可以通过 VPS 控制面板或者控制台命令来验证。
- 如果是通过面板，打开“SSH”服务,检查是否启用了公钥认证。
- 如果是通过控制台，运行以下命令：
ssh -V
如果显示公钥认证的标志（
authorized keys found），说明 VPS 已经配置好了。
获取 VPS 的公钥
你需要获取 VPS 的公钥，这个公钥将用于 VSCode 的 SSH 连接配置。
- 打开 VPS 控制面板，找到“Key”或“Certificates”部分,下载并保存你的公钥文件。
- 如果是通过控制台，运行以下命令，替换
your_vps_host为你的 VPS 主机名：ssh-key-id | grep -E '^[a-zA-Z0-9_-]+$'
这将显示你的公钥 ID,你可以将它复制并保存。
配置 VSCode 的 SSH 插件
VSCode 的 SSH 插件是连接 VPS 的主要工具,确保插件已经安装并启用。
- 打开 VSCode，进入 Extensions 管理器（按
Ctrl+Shift+X或X）。 - 在搜索框中输入“ssh”，找到“VS Code SSH”插件，点击“安装”。
- 启用插件后，点击“X”退出。
配置 SSH 连接
添加 SSH 配置文件
在 VSCode 中，可以通过配置文件来指定连接 VPS 的参数。
- 打开终端（按
Ctrl+Shift+P或Ctrl+Shift+D），输入以下命令，下载并安装ssh-config：npm install -g ssh-config
- 运行以下命令，生成 SSH 配置文件：
ssh-config -F
这将创建
~/.ssh/config文件，里面包含默认的 SSH 设置。
修改 SSH 配置文件
在 ~/.ssh/config 文件中,找到以下部分：
[Host] HostName=your_vps_host User=your_username
将 your_vps_host 替换为你 VPS 的主机名，your_username 替换为你在 VPS 上的用户名。
添加公钥认证
为了方便连接,启用公钥认证：
[Host]* # 代表所有主机 PubkeyAuthentication yes AuthorizedKeysFile ~/.ssh/authorized_keys
保存并退出。
使用 SSH 连接到 VPS
打开终端
在 VSCode 中，按 Ctrl+Shift+P 或 Ctrl+Shift+D 打开终端。
连接到 VPS
运行以下命令，替换 your_vps_host 和 your_username：
ssh -i ~/.ssh/config -o User=your_username -o HostName=your_vps_host your_vps_host
验证连接
连接成功后,终端会显示类似以下内容：
Connected to your_vps_host via SSH (-T unencrypted) 2023-10-01 12:00:00高级配置
设置默认连接
如果你经常连接到同一台 VPS,可以设置默认连接：
ssh -i ~/.ssh/config -p
使用 PuTTY 配置
如果你习惯使用 PuTTY 连接，可以将 SSH 配置文件导出为 PuTTY 配置文件：
ssh-config -F | tee -s ~/.puttyrc
然后在 PuTTY 中选择 ~/.puttyrc 作为配置文件。
常见问题
连接不上 VPS
- 确认 VPS 的 SSH 服务是否启用了公钥认证。
- 检查 VPS 的公钥文件是否正确。
- 确认 VSCode 的 SSH 插件是否安装并启用。
SSH 错误提示
- 检查公钥文件路径是否正确。
- 确认 VPS 的公钥文件包含你的公钥。
密钥丢失
- 定期备份公钥文件。
- 确保公钥文件不被他人未经授权访问。
通过以上步骤，你可以在 VSCode 中轻松连接到 VPS 进行开发和调试，配置 SSH 插件和设置公钥认证可以大大提高连接的便捷性和安全性,希望本文能帮助你顺利实现连接目标。
卡尔云官网
www.kaeryun.com
上一篇