智川云
智川云RIVERMIND

主题

VSCode 远程开发 ​

通过 Remote-SSH 插件连接智川云实例进行开发。

重要

长时间训练请使用 守护进程，避免 SSH 断开导致程序终止。

前置要求 ​

  • 本地安装 VSCode
  • 安装 Remote-SSH 插件
  • 智川云实例已开机

配置步骤 ​

1. 获取 SSH 信息 ​

从控制台复制 SSH 命令：

bash
ssh root@<地址> -p <端口>
# 示例：ssh root@connect.gpuhome.cc -p 10309

参数说明：

参数说明示例
root用户名（固定为 root）-
<地址>服务器地址connect.gpuhome.cc
-p <端口>SSH 端口号10309

2. 安装插件 ​

系统快捷键
Windows/LinuxCtrl+Shift+X
macOSCmd+Shift+X

搜索 Remote-SSH → 安装

3. 添加主机 ​

  1. 打开命令面板：
    • Windows/Linux：F1 或 Ctrl+Shift+P
    • macOS：F1 或 Cmd+Shift+P
  2. 输入 Remote-SSH: Add New SSH Host
  3. 粘贴 SSH 命令
  4. 选择保存到 ~/.ssh/config

注意

SSH 命令末尾如有空格需删除。

4. 连接 ​

  1. 打开命令面板 → 输入 Remote-SSH: Connect to Host
  2. 选择主机 → 选择 Linux → 输入密码

5. 打开项目 ​

连接后点击「打开文件夹」，建议使用数据盘目录：

/root/rivermind-data/your-project/

Python 配置 ​

智川云实例预装了 Conda 环境管理工具，选择 Python 解释器时需指定 Conda 中的 Python 路径。

打开命令面板：

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

输入 Python: Select Interpreter，选择对应的 Python 解释器。

常用路径：

环境路径
基础环境（base）/opt/conda/bin/python
自定义 Conda 环境/opt/conda/envs/<环境名>/bin/python
系统 Python/usr/bin/python3

查看已有环境

在实例终端中执行 conda env list 可查看所有 Conda 环境及其路径。

推荐插件 ​

插件用途
Python语言支持
Pylance智能提示
JupyterNotebook
GitLensGit 增强

本地代理转发 ​

如需在远程实例中使用 GitHub Copilot、Claude 等需要网络代理的服务，可通过 SSH 端口转发将本地代理转发到远程服务器。

适用场景

此功能适用于需要访问国外服务（如 GitHub Copilot、Claude、npm 等）的用户。如无此需求可跳过本节。

前提条件 ​

  • 本地电脑已配置代理服务（如 Clash、V2Ray 等）
  • 本地代理监听端口（如 10808）

配置 SSH 端口转发 ​

编辑本地 SSH 配置文件 ~/.ssh/config，添加 RemoteForward 配置：

Host gpuhome
    HostName connect.gpuhome.cc
    User root
    Port 10309
    RemoteForward 10808 127.0.0.1:10808

参数说明：

参数说明
RemoteForward远程端口转发配置
10808（第一个）远程服务器监听的端口
127.0.0.1:10808本地代理地址和端口

原理说明

RemoteForward 10808 127.0.0.1:10808 表示将远程服务器的 10808 端口转发到本地的 127.0.0.1:10808。连接后，远程服务器访问 127.0.0.1:10808 实际上会通过 SSH 隧道访问本地代理。

配置 VSCode 代理 ​

连接到远程实例后，打开 VSCode 设置（远程）：

  1. 按 Ctrl+Shift+P（macOS：Cmd+Shift+P）打开命令面板
  2. 输入 Preferences: Open Remote Settings (JSON)
  3. 添加以下配置：
json
{
  "http.proxy": "http://127.0.0.1:10808",
  "http.proxyStrictSSL": false
}

注意

  • 配置需添加到远程设置（Remote Settings），而非本地设置
  • http.proxyStrictSSL 设为 false 可避免 SSL 证书验证问题
  • 确保本地代理服务已启动，否则连接会失败

验证配置 ​

在远程终端中测试代理是否生效：

bash
# 测试代理连接
curl -x http://127.0.0.1:10808 https://api.github.com

# 如果返回 GitHub API 信息，说明代理配置成功

故障排除 ​

Copilot 仍无法使用 ​

  1. 确认本地代理服务已启动
  2. 确认 SSH 连接时使用了配置了 RemoteForward 的 Host
  3. 重启 VSCode 远程连接
  4. 检查代理端口是否正确

端口冲突 ​

如果 10808 端口已被占用，可更换其他端口（如 10809），同时修改 SSH 配置和 VSCode 代理设置中的端口号。

常见问题 ​

连接失败 ​

  1. 确认实例已开机
  2. 检查 SSH 地址和端口是否正确
  3. 检查密码是否正确
  4. 清除 known_hosts 中的旧记录：ssh-keygen -R [主机地址]:端口号

找不到文件 ​

  1. 刷新文件列表（右键 → Refresh）
  2. 重新打开文件夹
  3. 检查文件路径是否正确

插件无法安装 ​

远程实例需要网络访问才能安装插件。如遇问题，可配置 本地代理转发。

相关文档 ​

智算无疆 川流不息

Copyright © 2026 智川云