vscode怎么连接服务器?

在 VS Code 中连接服务器主要通过Remote - SSH 扩展实现,以下是详细步骤:

一、安装必要组件

安装 VS Code

- 下载地址:[code.visualstudio.com](https://code.visualstudio.com/)

2. 安装 Remote - SSH 扩展

1、打开 VS Code

2、点击左侧扩展图标(或按Ctrl+Shift+X

3、搜索 "Remote - SSH"

4、安装 Microsoft 官方发布的扩展

本地 SSH 客户端

Windows:安装 [OpenSSH 客户端](https://docs.microsoft.com/zh-cn/windows-server/administration/openssh/openssh_install_firstuse) 或使用 Git Bash

macOS/Linux:通常已内置

二、配置 SSH 连接

方法1:快速连接

1、点击左下角「远程连接」图标

2、选择「Connect to Host...」

3、选择「Add New SSH Host」

4、输入:ssh username@server_ip -p port

username:服务器用户名

server_ip:服务器IP地址或域名

port:SSH端口(默认22)

方法2:配置 SSH Config 文件(推荐)

1、打开命令面板(Ctrl+Shift+P

2、输入「Remote-SSH: Open SSH Configuration File」

3、选择~/.ssh/config 文件

4、添加配置:

Host myserver
    HostName server_ip
    User username
    Port 22
    IdentityFile ~/.ssh/id_rsa

三、连接步骤

1、点击左下角远程连接图标

2、选择「Connect to Host...」

3、选择配置的主机名(如myserver

4、选择服务器平台(Linux/Windows/macOS)

5、输入密码(如使用密钥登录则自动连接)

四、SSH 密钥认证(免密登录)

生成密钥对

ssh-keygen -t rsa -b 4096

上传公钥到服务器

方法1:使用 ssh-copy-id
ssh-copy-id username@server_ip
方法2:手动复制
cat ~/.ssh/id_rsa.pub | ssh username@server_ip "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

五、高级功能

端口转发

Host myserver
    HostName server_ip
    LocalForward 8888 localhost:8888  # 转发Jupyter等

跳板机配置

Host jumpserver
    HostName jump_ip
    User jump_user
Host targetserver
    HostName target_ip
    User target_user
    ProxyJump jumpserver

多因素认证

安装Remote - SSH: Editing Configuration Files 扩展管理复杂配置

六、常见问题解决

连接被拒绝

检查服务器SSH服务
sudo systemctl status sshd
检查防火墙
sudo ufw allow 22

权限错误

修复.ssh目录权限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

VS Code 远程扩展失败

- 重新安装 Remote - SSH 扩展

- 清除远程开发缓存:rm -rf ~/.vscode-server

七、实用技巧

1、同步本地设置:连接后安装扩展会同步到服务器

2、端口转发:转发服务器端口到本地调试

3、终端集成:可直接在VS Code终端操作服务器

4、文件编辑:支持直接在服务器上编辑文件

5、开发容器:结合Dev Containers使用Docker环境

八、替代方案

1、SFTP 扩展:仅文件同步,不提供完整开发环境

2、Dev Containers:连接Docker容器

3、WSL:连接Windows子系统Linux

快速开始命令

安装扩展
code --install-extension ms-vscode-remote.remote-ssh
连接服务器
ssh username@ip -p port

连接成功后,VS Code 左下角会显示「SSH: 服务器名称」,表示已成功连接远程服务器。

文章摘自:https://idc.huochengrm.cn/fwq/24777.html

评论