在 VS Code 中连接服务器主要通过Remote - SSH 扩展实现,以下是详细步骤:
一、安装必要组件
- 下载地址:[code.visualstudio.com](https://code.visualstudio.com/)
2. 安装 Remote - SSH 扩展
1、打开 VS Code
2、点击左侧扩展图标(或按Ctrl+Shift+X)
3、搜索 "Remote - SSH"
4、安装 Microsoft 官方发布的扩展
Windows:安装 [OpenSSH 客户端](https://docs.microsoft.com/zh-cn/windows-server/administration/openssh/openssh_install_firstuse) 或使用 Git Bash
macOS/Linux:通常已内置
二、配置 SSH 连接
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
- 重新安装 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
评论