可通过五种方案实现外网访问QoderWake：一、路由器端口映射+DDNS；二、FRP自建穿透；三、nat123商用工具；四、Ngrok临时隧道；五、ZeroTier虚拟局域网。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在外网访问局域网中运行的QoderWake服务，但该服务无法被公网直接访问，则可能是由于QoderWake部署在无公网IP的内网环境，且未配置有效的端口暴露或隧道转发机制。以下是实现外网访问QoderWake服务的多种可行方案：
一、通过路由器端口映射+动态DNS（适用于具备动态公网IP的宽带环境）
该方法利用运营商分配的动态公网IP，结合DDNS服务将变化的IP绑定至固定域名，并通过路由器NAT规则将外部请求定向至QoderWake所在内网设备。无需额外服务器，成本为零，但依赖光猫/路由器支持DDNS客户端及端口转发功能。
1、登录路由器管理界面（通常地址为192.168.1.1或192.168.0.1，账号密码见设备标签或说明书）。
2、进入“高级设置”→“NAT转发”或“虚拟服务器”页面，添加新规则：外部端口填写8080（或其他未被占用端口），内部IP填写QoderWake服务器的局域网地址（如192.168.1.105），内部端口填写QoderWake实际监听端口（默认可能为3000或8000）。
3、启用UPnP并保存配置；若路由器支持DDNS，选择服务商（如Oray、No-IP），输入注册的域名与账户凭据，开启自动更新。
4、在外网浏览器中访问http://yourdomain.ddns.net:8080，验证是否成功加载QoderWake界面。
二、使用FRP自建穿透服务（适用于拥有云服务器的用户）
FRP是一种高性能反向代理工具，通过在云服务器（服务端frps）与QoderWake主机（客户端frpc）之间建立加密长连接，绕过NAT限制。此方式稳定可控，支持HTTP/TCP协议，可为QoderWake分配独立子域名。
1、在云服务器（Linux）下载FRP最新版，解压后编辑frps.toml：设置bindPort = 7000，配置auth.token = "qoderwake2026"，并开放服务器安全组中7000端口。
2、执行./frps -c frps.toml启动服务端；确认进程持续运行且无报错。
3、在QoderWake所在机器下载对应平台FRP客户端，创建frpc.toml：填入云服务器公网IP、7000端口、相同token；在[[proxies]]段添加类型为http的代理，customDomains设为qwk.yourdomain.com，localPort设为QoderWake实际端口。
4、运行./frpc -c frpc.toml；等待日志显示“start proxy success”，即可在外网通过http://qwk.yourdomain.com访问服务。
三、采用nat123等商用穿透工具（适用于无公网IP且无云服务器的场景）
nat123提供免部署的一键式穿透服务，客户端安装后自动连接其全国节点，分配随机或自定义二级域名，适合家庭、测试环境快速启用。所有流量经其加密中转，无需技术配置，但免费版存在带宽与并发连接数限制。
1、访问nat123官网下载Windows/macOS/Linux客户端，安装后使用手机号注册并登录。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、点击“添加映射”，应用类型选择HTTP或TCP；内网主机IP填写QoderWake所在设备的局域网地址，内网端口填写其监听端口。
3、外网域名可选用系统分配的免费二级域名（如abc.nat123.cc），或购买VIP开通自定义域名；启用映射并确保状态显示为“在线”。
4、在外网任意设备浏览器中输入该域名，检查是否正常响应QoderWake服务页面。
四、借助Ngrok官方服务（适用于开发调试与临时共享）
Ngrok提供开箱即用的HTTPS隧道，自动分配全球可访问的随机URL，内置身份验证与请求日志，特别适合演示、API联调等短期需求。免费账户每会话最长8小时，隧道URL每次重启变更。
1、前往ngrok.com注册账号，下载对应平台客户端，执行ngrok config add-authtoken <your_token>绑定账户。
2、确认QoderWake正在本地运行（如http://127.0.0.1:3000），在终端执行：ngrok http 3000。
3、终端将输出类似https://a1b2-c3d4-5678-f9g0.ngrok-free.app的隧道地址，复制该链接。
4、在外网设备打开该链接，立即访问到本机QoderWake服务，所有HTTP请求与响应均实时透传。
五、利用ZeroTier构建虚拟局域网（适用于多设备协同与长期稳定访问）
ZeroTier创建去中心化SDN网络，将外网设备与QoderWake主机纳入同一虚拟子网，实现IP直连。无需端口映射或中转服务器，所有通信经端到端加密，适合需要SSH、数据库直连等底层协议的场景。
1、访问zerotier.com注册账号，创建新网络，记录生成的16位网络ID（如abcd1234ef567890）。
2、在QoderWake服务器及所有需访问它的外网设备上安装ZeroTier客户端，运行后执行：zerotier-cli join abcd1234ef567890。
3、登录ZeroTier Web控制台，在Members列表中勾选对应设备，点击“Auth”授权加入网络。
4、等待各设备获取到10.147.x.x段虚拟IP；在外网设备中直接访问QoderWake的虚拟IP加端口（如http://10.147.22.5:3000）。
