Qoder连接远程服务器有四种方法：一、用内置Remote SSH直连；二、先用本地VS Code部署VS Code Server再接入；三、用cpolar创建TCP隧道穿透内网；四、运行Qoder CLI启动HTTP服务反向接入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Qoder中尝试连接远程服务器进行云端代码实时编辑，但SSH连接失败或无法建立稳定会话，则可能是由于认证配置缺失、远程服务未启用或网络路径不通所致。以下是实现该连接的多种可行方法：
一、使用Qoder内置Remote SSH组件直连
Qoder已预集成Remote SSH功能，无需额外安装插件，可直接通过图形界面发起SSH连接，适用于已开放22端口且具备密码或密钥认证能力的服务器。
1、启动Qoder，在左侧边栏找到Remote Explorer图标并点击。
2、点击右上角的加号（+）按钮，选择SSH Target。
3、在弹出的输入框中输入连接字符串：ssh username@server_ip_address，其中username为服务器登录用户名，server_ip_address为服务器公网或内网IP。
4、按回车确认后，Qoder将提示输入密码或选择私钥文件；若首次连接，需接受远程主机指纹。
5、连接成功后，右侧资源管理器将显示远程文件系统，可直接双击编辑文件，保存即实时同步至服务器。
二、借助本地VS Code预部署VS Code Server再接入Qoder
当目标服务器未预装VS Code Server或Qoder直连报“command not found”等错误时，可先用本地VS Code完成远端环境初始化，使Qoder复用同一套服务进程，避免重复部署冲突。
1、在本地Windows/macOS电脑上打开VS Code，确保已安装官方Remote - SSH扩展。
2、使用相同连接字符串（如ssh user@192.168.1.100）连接目标服务器。
3、等待VS Code自动在远程~/.vscode-server/目录下完成服务安装与版本匹配。
4、断开本地VS Code连接，不关闭远程服务进程。
5、切换至Qoder，在Remote Explorer中复用同一连接字符串发起连接，多数情况下可直接进入已就绪的工作区。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、通过cpolar创建TCP隧道穿透内网服务器
当远程服务器位于企业内网、无固定公网IP或22端口被防火墙屏蔽时，需借助内网穿透工具暴露SSH服务，使Qoder能从外网访问该端口。
1、在远程服务器上执行命令安装cpolar：curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash。
2、运行cpolar authtoken命令，粘贴从https://www.cpolar.com/获取的认证token完成授权。
3、创建指向本地22端口的TCP隧道：cpolar tcp 22，记录返回的临时公网地址（如tcp://xxx.cpolar.io:12345）。
4、在Qoder的Remote Explorer中输入新连接字符串：ssh username@xxx.cpolar.io -p 12345。
5、输入对应密码或加载私钥，完成穿透连接。
四、使用Qoder CLI在远程服务器端启动守护进程后反向接入
该方式绕过传统SSH客户端连接逻辑，转而由Qoder CLI在服务器端启动轻量级服务，Qoder IDE通过HTTP协议与其通信，适合受限网络环境或需长期保持会话的场景。
1、在目标服务器终端执行安装命令：curl -fsSL https://qoder.com/install | bash。
2、运行qodercli --yolo --model=auto启动CLI服务，默认监听localhost:3000。
3、若需外网访问，配置反向代理（如Nginx）或使用cpolar暴露3000端口。
4、在Qoder中打开命令面板（Ctrl+Shift+P），输入Qoder: Connect to Remote CLI。
5、填入服务器公网地址及端口（如http://your-server-ip:3000），建立双向通信链路。
