Qoder内网穿透通过预置中继节点实现无公网IP远程访问：一、确认设备内置Qoder模块并连通官方服务器；二、开启后自动生成二级域名外网链接；三、可手动添加HTTP/HTTPS/TCP自定义映射；四、需配置防火墙与UPnP辅助；五、通过连接日志排查断连问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望外网用户能够直接访问您部署在家庭或办公室局域网中的本地服务（如Web应用、NAS、远程桌面等），但当前网络环境既无公网IP，也未配置路由器端口映射，则Qoder内网穿透是一种轻量、低门槛的解决方案。以下是针对Qoder工具的具体设置步骤：
一、确认Qoder服务端可用性与客户端兼容性
Qoder并非开源通用型穿透工具（如FRP或NPS），而是特定生态下的轻量级穿透代理组件，通常作为某国产NAS或智能终端配套软件集成存在。其运行依赖预置的服务中继节点，不支持用户自建服务端。因此需先确认设备固件版本已内置Qoder模块，并确保设备能正常连接至Qoder官方中继服务器。
1、登录设备管理后台（如NAS的Web UI或智能主机控制面板）。
2、进入“网络”或“远程访问”菜单，查找“Qoder”、“快速远程”或“一键穿透”类选项。
3、检查状态栏是否显示“服务节点连接正常”或类似绿色在线提示；若显示离线或超时，请确认设备已联网且未被防火墙拦截出站TCP 443/80端口。
二、启用Qoder并获取外网访问地址
启用Qoder后，系统将自动向中继服务器注册本机内网服务，并分配唯一可访问的二级域名或随机端口映射地址。该过程无需手动填写内网IP或端口号，由Qoder客户端自动探测并绑定默认服务（如HTTP 80、HTTPS 443、SMB 445等）。
1、在Qoder设置页面点击“开启穿透”按钮。
2、等待约10–20秒，页面刷新后查看生成的外网访问链接，格式通常为https://xxxxxx.qoderlink.com或http://xxxxxx.qoderlink.com:xxxx。
3、复制该链接，在外网任意设备浏览器中打开，验证是否能加载本地服务首页。
三、手动指定服务端口与协议类型
当默认自动识别未覆盖目标服务（例如本地运行在8080端口的Node.js应用或3389端口的Windows远程桌面），需进入高级设置模式，显式声明内网服务地址及协议。Qoder支持HTTP、HTTPS、TCP三种转发模式，其中TCP模式可用于非Web类服务。
1、在Qoder设置页点击“添加自定义映射”。
2、选择协议类型：HTTP（自动处理SSL证书）、HTTPS（需上传证书）、TCP（纯端口透传）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、填写内网目标：127.0.0.1:8080（若服务仅监听本地）或192.168.1.100:3389（若需局域网其他设备响应）。
4、保存后，页面将生成对应的新外网地址，如tcp://xxxxxx.qoderlink.com:22334，该端口由Qoder动态分配且唯一。
四、配置设备级防火墙与UPnP辅助发现
部分Qoder设备在首次启动时会尝试通过UPnP协议向路由器申请临时端口开放，以提升穿透成功率。若路由器禁用UPnP或位于多层NAT后（如校园网、企业专线），则需手动放行设备出站连接，并确保本地系统防火墙允许Qoder进程访问网络。
1、在Windows中打开“高级安全Windows Defender防火墙”，进入“出站规则”，确认Qoder相关进程（如qoder-agent.exe）状态为“已启用”。
2、登录路由器管理界面，进入“安全设置”或“防火墙”页，将Qoder所在设备的MAC地址加入“信任设备列表”。
3、若路由器支持DMZ主机功能，可临时将Qoder设备IP设为DMZ主机，用于排除中间NAT干扰（仅调试阶段使用，完成后应关闭）。
五、验证穿透稳定性与连接日志
Qoder客户端内置实时连接状态监控，可查看隧道维持时间、数据吞吐量及最近一次重连原因。稳定穿透需维持与中继服务器的长连接心跳，若频繁断开，往往指向本地网络策略限制或运营商QoS限速。
1、返回Qoder设置页，点击“查看连接日志”，筛选关键词“connected”、“reconnect”、“timeout”。
2、若日志中持续出现“connect failed: connection refused”，说明中继服务器拒绝接入，需检查设备是否被列入服务端黑名单或授权过期。
3、若日志显示“heartbeat timeout”，则需在设备网络设置中将DNS改为114.114.114.114或8.8.8.8，规避本地DNS劫持导致的心跳包解析失败。
