想从外网访问本地 Qoder CLI，例如在手机上远程操作或发起任务，最直接的方案就是使用内网穿透。毕竟本地服务运行在家庭或办公网络中，外部设备需要安全接入，必须搭建一条桥梁通道。
具体如何实现？下面详细说明步骤：先启动远程控制模式，再选择合适的穿透工具建立隧道，最后通过公网地址在手机端登录同一账号即可完成远程连接。
如果你已经在本地电脑上运行了 Qoder CLI，现在希望从外部网络（如手机、平板或其他远程设备）安全地接入这个会话，甚至直接下达指令，那么内网穿透就是必须掌握的技能。下面直接进入操作流程，不绕圈子。
一、确认本地 Qoder CLI 运行状态并启用远程控制模式
这一步的关键是确保本地 CLI 已经做好被外部连接的准备，并且开启了实时监听功能。远程控制模式需要终端持续运行，同时保持网络稳定活跃。
打开终端，进入你的项目目录，执行 qodercli 启动 CLI 会话。随后在交互界面中输入：/remote -control。当终端输出二维码以及一个访问 URL 时，说明远程监听已经成功启动。
二、选择并部署内网穿透工具（Cpolar 方式）
Cpolar 提供了图形化界面，配置过程相对直观，非常适合没有公网 IP 的场景。它支持 TCP 协议直连，能够与 Qoder CLI 使用的 WebSocket 或 HTTP 通信端口无缝对接。
首先访问 Cpolar 官网下载对应操作系统的客户端，完成安装并绑定账号。然后在终端执行 cpolar login，使用邮箱进行身份认证。接着运行命令启动 TCP 隧道：cpolar tcp --region=cn_vip 22222（这里的 22222 是 Qoder CLI 默认的监听端口，如果你更改过端口请相应调整）。
操作完成后，记下 Cpolar 分配的公网地址，格式类似 tcp://xxxxx.cpolar.cn:12345，后续连接时会用到。
三、选择并部署内网穿透工具（Ngrok 方式）
Ngrok 适用于临时调试或快速验证场景，免费版已能满足基础的远程访问需求。需要注意，其域名是随机生成的，且免费连接存在时长限制。
前往 ngrok.com 注册账号，下载对应平台的 CLI 工具。然后执行 ngrok config add-authtoken
四、在移动端或外网设备接入 Qoder CLI 会话
这一步的核心是将外部请求引导至本地正在运行的 CLI 实例。穿透地址与本地端口必须保持一致，同时移动端需要使用同一个账号登录。
在手机浏览器中打开上一步获取的公网地址（比如 Cpolar 或 Ngrok 提供的 tcp:// 域名加端口）。页面会自动跳转到 Qoder Mobile Web 登录页，使用你本地的阿里云账号进行登录。
登录成功后，系统会识别当前的隧道连接，并加载已经激活的 CLI 会话，实时日志以及交互按钮都会显示出来。此时你可以点击“批准操作”或者输入新指令（例如“重试上一步”），指令会通过隧道传输到本地 CLI 并被执行。
五、配置固定域名与端口（Cpolar 高级选项）
每次重启隧道后地址都会发生变化，手机端需要重新配置，比较繁琐。Cpolar 的付费通道支持绑定专属子域名和固定端口，让访问地址保持稳定。
登录 Cpolar 官网控制台，进入“保留 TCP 地址”页面，选择一个地区申请固定端口（例如 22222）。然后在本地终端执行绑定命令：cpolar tcp --subdomain=qoder-remote 22222。这样就能获得一个类似 tcp://qoder-remote.cpolar.cn:22222 的永久访问地址。
将该地址保存在手机备忘录中，今后所有外网访问都复用此链接，无需再重新扫码或配置，省时省力。