远程协作方案概述

通过 VSCode Remote-SSH 连接远程服务器，结合 CPolar 实现内网穿透，统一团队编码环境，解决开发环境差异问题。

环境准备

远程服务器要求

• 安装 SSH 服务（如 OpenSSH）
• 配置固定用户权限（避免权限冲突）
• 确保服务器具备足够资源（CPU/内存）

本地设备要求

• 安装最新版 VSCode
• 安装官方扩展 Remote - SSH
• 安装 CPolar 客户端（如需内网穿透）

配置 VSCode Remote-SSH

1. 添加远程主机
   在 VSCode 命令面板（Ctrl+Shift+P）输入 Remote-SSH: Add New SSH Host，按格式填写：

   ssh username@remote_server_ip -p port
   

2. 连接远程环境
   通过 Remote Explorer 侧边栏选择目标主机，首次连接需输入密码或配置 SSH 密钥。

3. 同步扩展与配置

   • 扩展同步：VSCode 会提示在远程安装本地已用扩展。
   • 设置同步：通过 Settings Sync 统一团队偏好（如缩进、主题等）。

内网穿透配置（CPolar）

适用场景
当远程服务器位于内网或无公网 IP 时，通过 CPolar 暴露 SSH 端口。

1. 安装 CPolar

   curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash
   

2. 启动穿透服务

   cpolar tcp 22
   

   执行后获取公网地址（如 tcp://3.tcp.cpolar.cn:10246）。

3. 更新 VSCode 连接配置
   将原 SSH 地址中的 IP 和端口替换为 CPolar 生成的公网地址：

   ssh username@3.tcp.cpolar.cn -p 10246
   

统一团队开发环境

1. 共享开发容器
   使用 devcontainer.json 定义环境依赖（如 Python 版本、Node.js 等），确保所有成员通过相同镜像开发。

2. 版本控制集成

   • 远程服务器安装 Git，配置全局忽略文件（如 .gitignore）。
   • 通过 VSCode 内置 Git 工具管理代码，避免本地与远程差异。

3. 实时协作插件
   安装 Live Share 扩展，支持多人同时编辑同一文件并实时同步。

常见问题解决

• SSH 连接超时
  检查 CPolar 服务是否运行，或更换为更稳定的隧道（如 Ngrok）。

• 权限不足
  确保远程用户对项目目录有读写权限：

  sudo chown -R username:username /path/to/project
  

• 扩展安装失败
  手动下载 .vsix 文件后，通过 Extensions: Install from VSIX 安装。

性能优化建议

• 限制同时连接的远程会话数量。
• 使用轻量级 Linux 发行版作为远程系统（如 Alpine）。
• 关闭不必要的 VSCode 扩展以降低资源占用。