安装必要工具

确保已安装最新版 VSCode 和官方 Remote-SSH 扩展。Windows 用户需安装 OpenSSH 客户端（Windows 10/11 内置），Linux/macOS 自带 SSH 客户端。

CPolar 需从官网下载对应平台版本，注册后获取认证 token。建议将 CPolar 二进制文件路径加入系统环境变量。

配置 Remote-SSH 连接

在 VSCode 中按 Ctrl+Shift+P 打开命令面板，输入 "Remote-SSH: Add New SSH Host"，按格式 ssh username@hostname -p port 添加目标服务器。连接前需确保：

• 本地已生成 SSH 密钥对并将公钥添加到服务器的 ~/.ssh/authorized_keys
• 服务器端开启 SSH 服务（默认端口 22）

建立 CPolar 内网穿透

在服务器终端执行以下命令启动 HTTP 穿透（示例）：

cpolar http 8080 -region=hk

成功后会返回公网 URL，形如 https://xxxx.cpolar.cn。如需持久化隧道，在 cpolar.yml 配置：

tunnels:
  dev-env:
    addr: 22
    proto: tcp
    region: hk
    remote_port: 12345

通过 cpolar start dev-env 启动服务，此时可通过 ssh username@x.cpolar.cn -p 12345 远程连接。

端口转发配置

在 VSCode 的 SSH 配置文件（通常位于 ~/.ssh/config）添加：

Host RemoteDev
  HostName xxxx.cpolar.cn
  User ubuntu
  Port 12345
  TCPKeepAlive yes
  ServerAliveInterval 60

使用 VSCode 的 "Remote-SSH: Connect to Host" 选择该配置即可连接穿透后的内网服务器。

调试与优化

遇到连接问题时可检查：

• CPolar 状态：cpolar status
• 网络延迟：ping xxxx.cpolar.cn
• 防火墙设置：确保服务器放行 CPolar 端口

为提高稳定性，建议：

• 在 CPolar 控制台设置自动重启
• 使用 Pro 版本获得固定域名
• 配合 tmux/nohup 保持后台运行

安全注意事项

暴露内网服务时需：

• 使用强密码+SSH 密钥认证
• 定期更换 CPolar 认证 token
• 限制可访问 IP 范围
• 避免转发敏感服务端口

通过以上配置，即可实现跨地域的远程开发环境访问，所有代码修改和调试操作均在远端服务器执行，本地仅作为交互终端。