需通过内网穿透实现外网访问本地qoder cli:先启用/remote -control模式获取二维码与url;再选cpolar或ngrok建立tcp隧道映射22222端口;最后用公网地址在手机登录同一账号即可远程操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已在本地电脑运行 Qoder CLI 服务,但希望从外网(如手机、其他网络环境)安全访问该会话或发起任务,则需通过内网穿透打通访问链路。以下是实现远程访问本地 Qoder 服务的具体步骤:
一、确认本地 Qoder CLI 运行状态并启用远程控制模式
此步骤确保本地 CLI 已处于可被外部连接的状态,并开启实时监听能力。远程控制模式依赖本地终端持续运行,且需保持网络活跃。
1、打开终端,进入目标项目目录,执行 qodercli 启动 CLI 会话。
2、在 CLI 交互界面中输入命令:/remote -control。
3、等待终端输出包含二维码和访问 URL 的提示信息,表明远程监听已成功启动。
二、选择并部署内网穿透工具(Cpolar 方式)
Cpolar 提供图形化配置与稳定中转服务,适用于无公网 IP 场景,且支持 TCP 协议直通,适配 Qoder CLI 的 WebSocket 或 HTTP 通信端口。
1、访问 Cpolar 官网下载适用于您操作系统的客户端,并完成安装与账号绑定。
2、在终端中执行 cpolar login,使用邮箱完成身份认证。
3、运行命令启动 TCP 隧道:cpolar tcp --region=cn_vip 22222(其中 22222 为 Qoder CLI 默认监听端口,若自定义请替换)。
4、记录 Cpolar 分配的公网地址,格式类似 tcp://xxxxx.cpolar.cn:12345。
三、选择并部署内网穿透工具(Ngrok 方式)
Ngrok 支持快速隧道建立,适合临时调试与验证,其免费版可满足基础远程访问需求,但需注意域名随机性与连接时长限制。
1、前往 ngrok.com 注册账号并下载对应平台的 ngrok CLI。
2、执行 ngrok config add-authtoken
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
3、启动 TCP 隧道映射本地 Qoder CLI 端口:ngrok tcp 22222。
4、从终端输出中提取类似 tcp://0.tcp.ngrok.io:12345 的公网访问地址。
四、在移动端或外网设备接入 Qoder CLI 会话
此步骤将外网请求导向本地正在运行的 CLI 实例,需确保穿透地址与本地端口一致,且移动端使用同一账号登录。
1、在手机浏览器中打开上一步获取的公网地址(如 cpolar 或 ngrok 提供的 tcp:// 域名+端口)。
2、页面将自动跳转至 Qoder Mobile Web 登录页,使用与本地 CLI 相同的阿里云账号登录。
3、登录成功后,系统识别当前隧道连接并加载已激活的 CLI 会话,显示实时日志与交互按钮。
4、点击“批准操作”或输入新指令(如“重试上一步”),指令将经隧道传入本地 CLI 并执行。
五、配置固定域名与端口(Cpolar 高级选项)
避免每次重启隧道后地址变更导致移动端重新配置,可通过 Cpolar 付费通道绑定专属子域名与固定端口,提升访问稳定性。
1、登录 Cpolar 官网控制台,进入“保留 TCP 地址”页面,选择地区并申请一个固定端口(如 22222)。
2、返回本地终端,执行命令绑定该端口:cpolar tcp --subdomain=qoder-remote 22222。
3、获得形如 tcp://qoder-remote.cpolar.cn:22222 的永久访问地址。
4、将该地址保存至手机备忘录,后续所有外网访问均复用此链接,无需重新扫码或配置。










