VSCode 连接远程 Linux 服务器环境配置图文教程

准备工作

1. 确保你已安装最新版 Visual Studio Code
2. 确保你有远程 Linux 服务器的 SSH 访问权限（用户名、密码或密钥）
3. 确保本地机器可以连接到目标服务器（网络可达）

安装 Remote - SSH 扩展

1. 打开 VSCode
2. 点击左侧活动栏的扩展图标 (或按 Ctrl+Shift+X)
3. 搜索 "Remote - SSH"
4. 找到由 Microsoft 发布的 "Remote - SSH" 扩展并点击安装

配置 SSH 连接

方法一：使用 SSH 配置文件

1. 打开 VSCode 命令面板 (Ctrl+Shift+P)
2. 输入 "Remote-SSH: Open Configuration File..."
3. 选择你的 SSH 配置文件（通常是 ~/.ssh/config）

在配置文件中添加服务器信息：

Host myserver  # 自定义名称
    HostName 192.168.1.100  # 服务器IP或域名
    User username           # 登录用户名
    Port 22                # SSH端口，默认22
    IdentityFile ~/.ssh/id_rsa  # 私钥路径(如果使用密钥认证)

方法二：直接输入连接信息

1. 打开 VSCode 命令面板 (Ctrl+Shift+P)
2. 输入 "Remote-SSH: Connect to Host..."
3. 选择 "Add New SSH Host..."
4. 输入 SSH 连接命令格式：ssh username@hostname -p port
   • 例如：ssh user@192.168.1.100 -p 22

连接到远程服务器

1. 打开 VSCode 命令面板 (Ctrl+Shift+P)
2. 输入 "Remote-SSH: Connect to Host..."
3. 选择你配置好的主机名称

首次连接时： - 如果是密码认证，会提示输入密码 - 如果是密钥认证且设置了密码，会提示输入密钥密码 - 会提示确认服务器的指纹信息

常见问题解决

1. 连接超时

• 检查网络连接是否正常
• 确认服务器IP和端口是否正确
• 确认服务器SSH服务是否运行 (sudo service ssh status)

2. 认证失败

• 检查用户名和密码是否正确
• 如果是密钥认证，确保私钥权限为600 (chmod 600 ~/.ssh/id_rsa)
• 检查服务器上~/.ssh/authorized_keys是否包含你的公钥

3. 无法安装VS Code Server

• 确保服务器有互联网访问权限
• 检查服务器是否满足系统要求
• 尝试手动安装： bash curl -Lk 'https://code.visualstudio.com/sha/download?build=stable&os=cli-alpine-x64' --output vscode-cli.tar.gz tar -xf vscode-cli.tar.gz

高级配置

端口转发

在SSH配置中添加：

Host myserver
    LocalForward 5432 localhost:5432  # 将远程5432端口转发到本地

多跳连接

配置跳板机连接：

Host jumpserver
    HostName jump.example.com
    User jumpuser

Host targetserver
    HostName target.example.com
    User targetuser
    ProxyCommand ssh -W %h:%p jumpserver

使用技巧

1. 远程资源管理器：左侧活动栏点击远程资源管理器图标，管理多个连接
2. 终端集成：直接使用VSCode内置终端访问远程shell (Ctrl+)
3. 文件编辑：像本地文件一样直接编辑远程文件
4. 扩展安装：部分扩展需要安装在远程服务器上

通过以上步骤，你应该已经成功配置了VSCode与远程Linux服务器的连接，可以开始高效的远程开发工作了。