一、环境准备

1. 本地环境
   • 安装VSCode（推荐最新版）

   • 安装Git Bash/Windows Terminal（Windows用户）

   • 确保云服务器已开启SSH服务（默认端口22）

2. 服务器环境

   # Ubuntu/Debian服务器执行
   sudo apt update && sudo apt install openssh-server -y
   sudo systemctl restart ssh
   

二、生成SSH密钥对（免密核心）
本地操作

ssh-keygen -t ed25519 -C "your_email@example.com"  # 推荐使用ed25519算法
# 连续回车3次（不设置密码）
cat ~/.ssh/id_ed25519.pub  # 复制输出的公钥内容

服务器配置

ssh root@your_server_ip  # 首次连接需输入密码
mkdir -p ~/.ssh
echo "粘贴你的公钥内容" >> ~/.ssh/authorized_keys
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
exit

三、VSCode远程连接配置

1. 安装插件
   • 搜索安装 Remote - SSH 插件（微软官方）

• 右侧活动栏点击「远程资源管理器」图标

2. 配置连接

# ~/.ssh/config 文件内容示例
Host my-cloud-server
    HostName 123.123.123.123
    User root
    IdentityFile ~/.ssh/id_ed25519  # 指定私钥路径
    Port 22

3. 连接测试
4. 点击「+」添加新主机
5. 选择配置文件 my-cloud-server
6. 首次连接会自动部署VSCode Server（约需1分钟）

四、免密登录验证

ssh my-cloud-server  # 直接连接无需密码

六、常见问题解决

提示：首次配置建议保留密码登录，待免密验证成功后再禁用密码登录，可通过sudo passwd -d root删除密码

遇到问题可查看~/.vscode-server/.log中的详细日志。