[{"data":1,"prerenderedAt":495},["ShallowReactive",2],{"navigation_docs":3,"-pml-2-troubleshooting":60,"-pml-2-troubleshooting-surround":490},[4,20],{"title":5,"path":6,"stem":7,"children":8},"PML 2 插件开发指南","\u002Fpml-2-plugin","pml-2-plugin",[9,12,16],{"title":10,"path":6,"stem":11},"插件开发综述","pml-2-plugin\u002Findex",{"title":13,"path":14,"stem":15},"插件系统埋点说明","\u002Fpml-2-plugin\u002Ftriggers","pml-2-plugin\u002F1.triggers",{"title":17,"path":18,"stem":19},"插件系统运算符说明","\u002Fpml-2-plugin\u002Foperators","pml-2-plugin\u002F2.operators",{"title":21,"path":22,"stem":23,"children":24},"PML 2","\u002Fpml-2","pml-2",[25,28,32,36,40,44,48,52,56],{"title":26,"path":22,"stem":27},"介绍 & 下载","pml-2\u002Findex",{"title":29,"path":30,"stem":31},"安装","\u002Fpml-2\u002Finstall","pml-2\u002F2.install",{"title":33,"path":34,"stem":35},"用户指南","\u002Fpml-2\u002Fuser_guide","pml-2\u002F3.user_guide",{"title":37,"path":38,"stem":39},"故障排查","\u002Fpml-2\u002Ftroubleshooting","pml-2\u002F4.troubleshooting",{"title":41,"path":42,"stem":43},"配置文件","\u002Fpml-2\u002Fconfig","pml-2\u002F5.config",{"title":45,"path":46,"stem":47},"主题","\u002Fpml-2\u002Fthemes","pml-2\u002F6.themes",{"title":49,"path":50,"stem":51},"插件开发指南","\u002Fpml-2\u002Fplugin","pml-2\u002F7.plugin",{"title":53,"path":54,"stem":55},"PML 2 隐私政策","\u002Fpml-2\u002Fpolicy","pml-2\u002F8.policy",{"title":57,"path":58,"stem":59},"PML 2 用户协议","\u002Fpml-2\u002Fuser_agreement","pml-2\u002F9.user_agreement",{"id":61,"title":37,"body":62,"description":483,"extension":484,"links":485,"meta":486,"navigation":487,"path":38,"seo":488,"stem":39,"__hash__":489},"docs\u002Fpml-2\u002F4.troubleshooting.md",{"type":63,"value":64,"toc":466},"minimark",[65,70,81,85,88,177,180,184,191,197,213,217,222,226,265,269,274,278,297,301,306,310,328,332,337,341,349,351,354,362,364,367,371,376,380,388,392,397,401,423,427,432,436],[66,67,69],"h1",{"id":68},"故障排查指南-隧道启动失败","故障排查指南 (隧道启动失败)",[71,72,73],"blockquote",{},[74,75,76,77,80],"p",{},"本文档配合 ",[78,79,33],"a",{"href":34},"「隧道状态与失败原因」章节使用。当隧道卡片显示红色「失败」状态时, 先点卡片上的「复制错误信息」拿到失败摘要, 再按下述路径排查。",[82,83,84],"h2",{"id":84},"常见失败类别",[74,86,87],{},"启动失败会被映射为以下几类 (卡片上直接显示可读文案, 非原始日志):",[89,90,91,107],"table",{},[92,93,94],"thead",{},[95,96,97,101,104],"tr",{},[98,99,100],"th",{},"类别",[98,102,103],{},"典型触发条件",[98,105,106],{},"排查方向",[108,109,110,133,144,155,166],"tbody",{},[95,111,112,116,130],{},[113,114,115],"td",{},"认证失败",[113,117,118,119,123,124,123,127],{},"token \u002F 登录态异常, 服务端返回 ",[120,121,122],"code",{},"401"," \u002F ",[120,125,126],{},"unauthorized",[120,128,129],{},"auth failed",[113,131,132],{},"见下方 §1",[95,134,135,138,141],{},[113,136,137],{},"端口占用",[113,139,140],{},"远程端口或本地端口被其他进程占用",[113,142,143],{},"见下方 §2",[95,145,146,149,152],{},[113,147,148],{},"节点不可达",[113,150,151],{},"节点连接被拒、域名无法解析、启动后 30 秒无在线确认",[113,153,154],{},"见下方 §3",[95,156,157,160,163],{},[113,158,159],{},"进程崩溃",[113,161,162],{},"mefrpc 进程异常退出 (退出码非 0)",[113,164,165],{},"见下方 §4",[95,167,168,171,174],{},[113,169,170],{},"未知",[113,172,173],{},"不属于以上任何一类的错误",[113,175,176],{},"见下方 §5",[178,179],"hr",{},[82,181,183],{"id":182},"_1-认证失败","§1 认证失败",[74,185,186,190],{},[187,188,189],"strong",{},"表现",": 失败摘要含「认证失败 \u002F token 无效 \u002F 未授权」等字样, 或服务端返回 401。",[74,192,193,196],{},[187,194,195],{},"排查路径",":",[198,199,200,204,207,210],"ol",{},[201,202,203],"li",{},"重新登录一次 (退出账号后重新登录, 刷新本地 token), 再启动隧道。",[201,205,206],{},"确认账号仍有该隧道的使用权限 (节点是否停用、账号是否欠费\u002F封禁)。",[201,208,209],{},"若频繁出现, 检查系统时间是否正确 (偏差过大会导致 token 签名校验失败)。",[201,211,212],{},"仍失败: 复制错误信息并附上账号节点信息提交反馈。",[82,214,216],{"id":215},"_2-端口占用","§2 端口占用",[74,218,219,221],{},[187,220,189],{},": 失败摘要含「端口被占用 \u002F address already in use」等字样。",[74,223,224,196],{},[187,225,195],{},[198,227,228,235,262],{},[201,229,230,231,234],{},"确认",[187,232,233],{},"远程端口","没有被其他隧道占用 (同一节点的同一远程端口只能分配给一条隧道)。",[201,236,230,237,240,241],{},[187,238,239],{},"本地端口","没有被本机其他程序占用 (如 80 端口被 IIS\u002Fnginx 等占用)。\n",[242,243,244,251],"ul",{},[201,245,246,247,250],{},"Windows: ",[120,248,249],{},"netstat -ano | findstr :端口号"," 查看占用进程。",[201,252,253,254,257,258,261],{},"Linux\u002FmacOS: ",[120,255,256],{},"lsof -i :端口号"," 或 ",[120,259,260],{},"ss -ltnp | grep 端口号","。",[201,263,264],{},"占用确认后: 停掉占用程序, 或在创建\u002F编辑隧道时更换端口。",[82,266,268],{"id":267},"_3-节点不可达","§3 节点不可达",[74,270,271,273],{},[187,272,189],{},": 失败摘要含「无法连接 \u002F 连接被拒绝 \u002F 节点不可达」, 或启动后 30 秒无在线确认 (超时)。",[74,275,276,196],{},[187,277,195],{},[198,279,280,291,294],{},[201,281,282,283],{},"使用隧道管理页的「刷新测速」确认该节点是否可达 (延迟\u002F超时\u002F失败)。\n",[242,284,285,288],{},[201,286,287],{},"超时: 节点过载或网络波动, 稍后重试, 或换一个节点。",[201,289,290],{},"失败 (连接被拒): 节点可能下线或未开放该端口。",[201,292,293],{},"检查本机网络: 能否正常访问其他网站\u002F服务; 代理\u002FVPN 是否干扰了到节点的连接。",[201,295,296],{},"检查本机防火墙\u002F安全软件是否拦截了 mefrpc 出站连接。",[82,298,300],{"id":299},"_4-进程崩溃","§4 进程崩溃",[74,302,303,305],{},[187,304,189],{},": 失败摘要含「进程异常退出 (退出码 N)」等字样。",[74,307,308,196],{},[187,309,195],{},[198,311,312,315,318,325],{},[201,313,314],{},"确认 mefrpc 版本是否与当前节点服务端兼容 (更新页可查看最新版本; 必要时重新下载客户端)。",[201,316,317],{},"查看崩溃前终端输出: 在终端页手动执行同样的启动命令, 观察报错点。",[201,319,320,321,324],{},"配置文件损坏时也会导致崩溃: 删除 ",[120,322,323],{},"Config\u002Ffrp"," 下对应的临时配置后重试。",[201,326,327],{},"仍崩溃: 复制错误信息 (含退出码), 提交反馈。",[82,329,331],{"id":330},"_5-未知错误","§5 未知错误",[74,333,334,336],{},[187,335,189],{},": 失败摘要为原始 API 错误信息。",[74,338,339,196],{},[187,340,195],{},[198,342,343,346],{},[201,344,345],{},"摘要通常已包含服务端返回的原始信息, 可据此关键词搜索或直接反馈。",[201,347,348],{},"将「复制错误信息」的内容 (应用版本 + mefrpc 版本 + 摘要) 完整粘贴到反馈中。",[178,350],{},[82,352,353],{"id":353},"通用建议",[242,355,356,359],{},[201,357,358],{},"反馈问题前, 一律使用卡片上的「复制错误信息」, 内容包含应用版本与 mefrpc 版本, 能大幅加快定位。",[201,360,361],{},"修改网络环境 (代理、DNS、防火墙) 后, 重新「刷新测速」验证节点连通性, 再尝试启动。",[178,363],{},[82,365,366],{"id":366},"更新失败",[368,369,370],"h3",{"id":370},"获取更新信息失败",[74,372,373,375],{},[187,374,189],{},": 「更新」页状态区显示「获取更新失败」, 无最新版本信息。",[74,377,378,196],{},[187,379,195],{},[198,381,382,385],{},[201,383,384],{},"检查网络连接 (能否访问其他网站); 代理\u002FVPN 是否拦截了到更新 API 的请求。",[201,386,387],{},"点击「检查更新」重试; 若更新通道为「预览」, 可切回「稳定」通道再试 (预览通道偶发无发布)。",[368,389,391],{"id":390},"下载失败-校验失败","下载失败 \u002F 校验失败",[74,393,394,396],{},[187,395,189],{},": 状态区显示「更新下载失败…」或「下载文件校验失败…」, 出现「重试下载」按钮。",[74,398,399,196],{},[187,400,195],{},[198,402,403,406,413,416],{},[201,404,405],{},"点击「重试下载」重试一次 (网络波动常见)。",[201,407,408,409,412],{},"仍失败: 在「设置」页切换",[187,410,411],{},"下载源"," (TPCA ↔ 官方) 后重试。",[201,414,415],{},"校验失败且重试仍出现: 下载源文件可能损坏, 等待一段时间后重试, 或切换下载源。",[201,417,418,419,422],{},"若为 Windows 且下载的是安装包, 确认磁盘空间充足 (安装包数百 MB, 需预留 ",[120,420,421],{},"Cache"," 目录空间)。",[368,424,426],{"id":425},"首次启动隧道时-mefrpc-下载失败","首次启动隧道时 mefrpc 下载失败",[74,428,429,431],{},[187,430,189],{},": 启动隧道时提示下载 mefrpc 客户端失败, 隧道无法启动。",[74,433,434,196],{},[187,435,195],{},[198,437,438,449,455],{},[201,439,440,441,444,445,448],{},"确认 ",[120,442,443],{},"bin\u002Fmefrpc.exe"," (Windows) 或 ",[120,446,447],{},"bin\u002Fmefrpc.tar"," (Linux\u002FmacOS) 是否存在; 缺失时启动隧道会自动下载。",[201,450,451,452,454],{},"下载失败: 在「设置」页切换",[187,453,411],{}," (TPCA ↔ 官方) 后重新启动隧道。",[201,456,457,458,461,462,465],{},"校验失败 (文件损坏): 删除 ",[120,459,460],{},"bin"," 下残留的 ",[120,463,464],{},"mefrpc*.tmp"," 与损坏文件后重试。",{"title":467,"searchDepth":468,"depth":468,"links":469},"",2,[470,471,472,473,474,475,476,477],{"id":84,"depth":468,"text":84},{"id":182,"depth":468,"text":183},{"id":215,"depth":468,"text":216},{"id":267,"depth":468,"text":268},{"id":299,"depth":468,"text":300},{"id":330,"depth":468,"text":331},{"id":353,"depth":468,"text":353},{"id":366,"depth":468,"text":366,"children":478},[479,481,482],{"id":370,"depth":480,"text":370},3,{"id":390,"depth":480,"text":391},{"id":425,"depth":480,"text":426},"本文将介绍 PML 2 常见的故障排查方法。","md",null,{},true,{"title":37,"description":483},"ORacaH56mPGOL3UBDur83W6ZN7c8VG6xCWhtjeV7qiE",[491,493],{"title":33,"path":34,"stem":35,"description":492,"children":-1},"本文将介绍如何使用 PML 2。",{"title":41,"path":42,"stem":43,"description":494,"children":-1},"本文将介绍 PML 2 的配置文件。",1787386338132]