VSCode 连接服务器与本地配置文件指南

一、安装扩展

在 VSCode 扩展商店中搜索并安装：

• Remote - SSH

---

二、本地配置文件

1. SSH 配置文件位置

Windows: C:\Users\<你的用户名>\.ssh\config	
Linux/macOS: ~/.ssh/config	#不存在的话自己手动创建

2. 配置格式示例

# 基础配置示例
Host myserver
    HostName 192.168.1.100	#服务器ip
    User shuaige	#登录用户
    Port 22

三、VSCode 连接服务器步骤

方法一：通过命令面板连接

1. 打开命令面板

   • Windows/Linux: Ctrl + Shift + P
   • macOS: Cmd + Shift + P

2. 输入并选择

   Remote-SSH: Connect to Host...
   

3. 选择配置好的服务器别名

   • 选择 myserver（你配置的 Host 名称）

4. 输入密码登录即可

方法二：通过远程资源管理器连接

1. 点击左侧活动栏的 远程资源管理器 图标（显示器形状）
2. 在 REMOTES 下拉菜单中选择目标服务器
3. 点击服务器旁的 连接窗口 图标

方法三：左下角远程图标 Open a Remote Window

1. 弹出菜单中选择 Connect to Host
2. 选择相应主机登录

---

注意：

至此通过密码登录远程服务器的方式已经介绍完毕，如需通过密钥登录可继续向下查看本指南

四、使用 SSH 密钥连接远程服务器（可选）

1. 生成密钥

# Windows (Git Bash / PowerShell) / Linux / macOS
ssh-keygen -t rsa -b 4096 # 生成RSA密钥对(4096位)

按照提示操作：

1. 保存位置：直接回车（使用默认路径 C:\Users<你的用户名>.ssh\id_rsa）
2. 密码短语：可选，建议设置增加安全性（留空则无需密码）

**（可选）**如需要区分不同服务器，可指定文件名：

ssh-keygen -t rsa -b 4096 -f C:\Users\<用户名>\.ssh\id_rsa_prod  #可选

2. 将公钥上传到服务器

生成后得到两个文件(默认命名为例)

1. id_rsa -> 私钥 (本地保管)
2. id_rsa.pub -> 公钥 (需上传至服务器)

方式一：ssh-copy-id（需Git Bash中执行）

# 在Git Bash 中执行
ssh-copy-id 用户名@服务器IP

# 示例
ssh-copy-id shuaige@192.168.1.100
# 输入密码后，公钥会自动添加到服务器的 ~/.ssh/authorized_keys

方式二：手动复制公钥

1. 查看并复制本地公钥内容

   # 在 Windows 本地执行
   type C:\Users\<你的用户名>\.ssh\id_rsa.pub	
   

2. 登录服务器并添加公钥

# 打开终端 先使用密码登录服务器
ssh 用户名@服务器IP

# 在服务器上执行以下命令
mkdir -p ~/.ssh                 # 创建 .ssh 目录（如不存在）
echo "公钥内容" >> ~/.ssh/authorized_keys   # 添加公钥（同理使用vim）
chmod 600 ~/.ssh/authorized_keys # 改权限

3. 本地config文件配置

更新本地config文件（路径可查看上文）

# 密钥登录配置
Host myserver-key
    HostName 192.168.1.100	
    User shuaige
    Port 22
    IdentityFile C:\Users\<你的用户名>\.ssh\id_rsa   # 私钥路径
    #IdentitiesOnly yes                               # 只使用指定密钥