p2peep2pee.com
控制台

常见问题排查

按「先看哪一段」的顺序排：网关进程 → 地址 → 信令（在线） → 通道（打洞） → 目标机（协议与凭据）。

现象最可能的原因看哪一节
打开地址显示「地址无效」（404）凭证段被截断 / 改动，或网关已经换了 markID地址无效
页面提示「网关离线」网关没在跑、Key 不对、或地址不是这次启动打印的那条网关离线
列表空白：网关没有可连接的服务（检查启动参数 -connect）没给 -connect，或目标全部被额度截断清单为空
通道建好但停在「正在建立会话…」网关 TCP 连不到目标机的 3389 / 5900连不上目标机
RDP 报认证失败 / 立刻被断NLA（CredSSP）与账号口令问题RDP 认证与 NLA
有画面但黑屏 / 一直等首帧首帧依赖分辨率协商与显示通道黑屏与画面异常
家宽能连、公司网连不上对称 NAT 打洞失败打洞失败
只有前 2 台机器在列表 / 启动就打印版本提示退出被控端额度截断、版本低于最低要求额度与版本

地址无效（404）

入口路由在查用户之前先校验凭证段，格式不对、对不上用户、或该用户已注销，一律返回 404「地址无效」—— 不暴露「这个地址存在但不可用」。逐项确认：

  1. 整串复制：凭证段是 base64，里面可能出现 /、+、_、-，从聊天软件或终端里复制最容易被截断 —— 重新从日志横幅那一行整行复制。
  2. 结尾斜杠：网关打印的带 /，控制台列表那条不带，两种本站都能打开；自己在网关前面加了 CDN / 反向代理时，确认没把 /r/xxx/yyy 的多段路径改写掉。
  3. 地址属于哪次启动：非会员每次启动随机分配 markID，重启过网关旧地址就永久失效，控制台列表里的新行才是当前那条。

网关离线

页面会先探测网关在不在（gw-probe），探测失败直接报「网关离线」，不会干等打洞超时。依次查：网关进程是否还在；启动日志里有没有 ✅ 信令服务已连接（没有就是 Key 错 —— 注意首尾空格、区分大小写 —— 或网络出不去）；被控机是否休眠；地址里的 markID 与当前运行的网关是否同一个。

清单为空

网关没有可连接的服务（检查启动参数 -connect） 有两种来源：启动时确实没给 -connect（漏写一次 -connect 会让程序直接报错退出，不会静默当成空清单）；或给了但超出被控端额度 —— 免费版最多 2 台，超出部分不进列表，只在网关日志出现一行提示。

连不上目标机

会话建不起来、或表单显示 连接失败: <原因>，几乎都是网关到目标机那一段 TCP 不通：远程桌面没开（Windows 系统属性 → 远程 → 勾选允许远程连接）；端口不对（不是 3389 / 5900 就要在 -connect 里显式写，VNC 常见 5901）；防火墙拦了（要为「远程桌面」在专用网络放行，第三方安全软件常单独拦 3389）；跨网段 / VLAN（把网关放到能路由到那台机器的位置，容器则要确认用的是 host 网络）；地址写错（填的是内网地址，*.local / 裸主机名要靠网关所在机器的解析能力）。

验证链路最快的办法

在网关所在机器上直接测端口通不通：Windows Test-NetConnection 192.168.10.7 -Port 3389，Linux nc -vz 192.168.10.7 3389。不通就先解决内网这一段，远程桌面帮不上忙。

RDP 认证与 NLA

情况表现处理
填了用户名 + 口令优先走 NLA（CredSSP），失败自动回退标准安全层保持这个用法，绝大多数机器不用改设置
用户名留空直接连接后要面对远端登录界面这条路径要求目标机关闭 NLA（Win10 / 11 默认开启）
无凭据连上后约 30 秒被断开服务端下发 Error Info 0x0000000C（LocalSessionManager 事件 40）已知且预期：无人完成登录的「登录会话」会被主机主动收掉。无凭据连接只适合看画面与验链路，填了凭据的会话不受影响
域账号需要填「域（可选）」本机账户请留空，别填机器名
空口令账户连不上Windows 默认策略禁止空口令远程登录，给账户设口令或换一个账户

黑屏与画面异常

现象处理
连上后一直黑屏先点工具栏「Ctrl+Alt+Del」把远端从锁屏救回来；仍无画面就断开重连
画面只出上半部分 / 尺寸不对用分辨率下拉换一档再点「切换分辨率」；服务器不支持原地改时会带新分辨率自动重连（约 1-2 秒黑屏，正常）
「切换分辨率」点了没反应目标机不支持 display 通道；若你启动时加了 -rdp-no-display（排查兼容性用）就是自己关掉了这能力，去掉该参数
输不进字点一下桌面让画布取得焦点。看网关的会话结束日志：浏览器 → 网关 0 B 说明输入根本没送到
VNC 画面发糊VNC 按窗口铺满做本地缩放，不请求远端改尺寸。远端分辨率调大或把浏览器窗口拉大

打洞失败

家宽正常、公司网络 / 多层 NAT 环境连不上，通常是对称 NAT：

  1. 网关侧加 -force-relay 再启动一次 —— 能连上就说明是 NAT 类型问题，不是配置错；
  2. 确认服务端已给这个账户下发 TURN（浏览器侧只配 STUN，中继由网关侧的 TURN 兜底，一侧有中继候选就能配对）；
  3. 需要指定自建中继时用 -turn / -turn-user / -turn-pass 覆盖（STUN 不可覆盖）；中继带宽有限，先降分辨率再试。
不要拿 -debug 当线上用法

-debug 会在本机开一个 HTTP 端口（默认 127.0.0.1:8081）提供内嵌页面，并把日志降到 Debug 级。它是联调手段，长期跑会把机器暴露在本网段任何能访问该端口的人面前。

额度与版本

限制免费版会员版超了会怎样
最多 -connect 目标数210超出部分不进列表（只在网关日志出现）
最大并发桌面会话210新的选择被拒绝，表单显示失败原因；多个标签页各连一台会各占一份

数值由服务端随信令凭证下发，升级见 套餐与计费。版本低于服务端最低要求（当前 1.0.0）时启动即退出 —— 这是版本门控，旧协议和新页面对不上，到 远程桌面更新日志 下载新版本替换二进制。日志里 ⚠ 服务端提示 那一行黄色高亮是运营文案，不参与任何判定，看到它不需要处理。

其它

现象说明
「本页面不支持嵌入 iframe」有意限制：一条 P2P 连接会占一份并发额度，请直接访问地址
「全屏」按钮点不动浏览器只允许在 localhost 或 https 页面进入全屏
剪贴板 / Ctrl+Alt+Del 按钮不见了当前连的是 VNC：这三项依赖 RDP 虚拟通道，RFB 没有对应机制

仍未解决请带上网关日志（已自动脱敏）到 QQ 群 980221634。本机 RDP 协商诊断（probe）、无头截图（shot）与日志字段见 远程桌面内部实现。

相关

本页目录