核心组件与原理

VSCode Remote-SSH：通过SSH协议将本地VSCode与远程服务器连接，实现代码编辑、调试等操作均在远程执行，本地仅作为交互界面。
CPolar：内网穿透工具，将局域网中的远程服务器暴露到公网，解决无固定公网IP或防火墙限制的问题。

环境配置步骤

安装必要工具

• 远程服务器需安装SSH服务（如OpenSSH）并启动。
• 本地VSCode安装扩展"Remote - SSH"。
• 在服务器和本地分别安装CPolar客户端。

配置SSH免密登录
生成本地密钥对并上传公钥至远程服务器：

ssh-keygen -t rsa
ssh-copy-id user@remote_server_ip

测试免密登录：ssh user@remote_server_ip。

CPolar内网穿透配置
在服务器运行CPolar，创建TCP隧道映射SSH端口（默认22）：

cpolar tcp 22

记录生成的公网地址（如tcp://3.tcp.cpolar.cn:10246），此地址用于替代原SSH连接IP。

VSCode Remote-SSH连接

1. 在VSCode中按F1，选择"Remote-SSH: Connect to Host"。
2. 输入CPolar生成的公网地址格式：ssh user@3.tcp.cpolar.cn -p 10246。
3. 首次连接需验证指纹，确认后即可访问远程文件系统。

高级优化

保持连接稳定性

• 在VSCode的settings.json中添加参数防止超时：

"remote.SSH.useLocalServer": false,
"remote.SSH.enableDynamicForwarding": true

CPolar自启动配置
使用systemd或crontab确保CPolar服务在服务器重启后自动运行：

# systemd示例（/etc/systemd/system/cpolar.service）
[Unit]
Description=CPolar Tunnel
After=network.target

[Service]
ExecStart=/usr/local/bin/cpolar tcp 22
Restart=always

[Install]
WantedBy=multi-user.target

安全注意事项

• 限制CPolar公网地址的访问IP，通过cpolar.yml配置防火墙规则。
• 定期更新CPolar和SSH服务的版本，避免漏洞风险。
• 建议为SSH服务启用双向认证（如Google Authenticator）。

故障排查

连接失败

• 检查CPolar进程是否运行：ps aux | grep cpolar。
• 验证端口是否被占用：netstat -tuln | grep 22。

延迟过高

• 更换CPolar的服务器区域（如从us1切换到hk1）。
• 使用mosh替代部分SSH连接以优化网络波动。

此方案适用于开发、运维等需频繁跨环境协作的场景，结合VSCode的扩展生态（如Docker、数据库插件），可进一步实现全功能云端开发环境。