快速开始
远程桌面不需要在控制台创建任何东西：目标机器写在网关的启动参数里，网关带着账户 Key 启动即接入，访问地址由日志直接打印出来。
下面以「在家里连办公室那台 Windows（内网地址 192.168.10.7）」为例，整个过程约 3 分钟。
第 1 步：获取账户 Key
前往 Web 控制台 用邮箱验证码注册 / 登录，复制你的专属 Key。远程桌面与文件共享、内网穿透 共用同一个 Key，详见 账号与 Key。
第 2 步：在被控机上启动网关
网关跑在能被那台机器访问到的机器上 —— 直接放在被控机上最省事，同一内网的 NAS、软路由也行。单文件按平台从 远程桌面更新日志 或官网下载区取（Windows 有 amd64 / arm64 / 386 三种包，Linux 另有 arm 与 386）。
# Windows（PowerShell，反引号是续行符）
.\p2pee-remote.exe -key '<你的Key>' `
-connect "办公室机=rdp:192.168.10.7?user=ops"
# Linux / macOS（文件名以实际下载的版本为准）
chmod +x ./p2pee-remote-1.0.0-linux-amd64
./p2pee-remote-1.0.0-linux-amd64 -key '<你的Key>' -connect '办公室机=rdp:192.168.10.7?user=ops'
| 写法 | 说明 |
|---|---|
-key | 必填，账户 Key，用来换取信令凭证与 ICE 服务器 |
-connect | 要连的目标机器，一条就是一台，可以重复给 |
办公室机=rdp: | 展示名称 + 协议（RDP 用 rdp:、VNC 用 vnc:），端口不写取默认值 3389 / 5900；名称也可以整个省掉，-connect rdp:192.168.10.7 就能起 |
?user=ops | 预置登录用户名（页面仍可改）；RDP 口令不能写在启动参数里，只能在页面输入 |
启动成功后控制台输出大致长这样：
==============================================
p2pee-remote 1.0.0 启动中（版本门控由 p2pee 服务端判定）
==============================================
目标机 rdp-1 RDP 192.168.10.7:3389 账号 ops
✅ 信令服务已连接
公网访问页: https://p2pee.cn/r/<凭证>/
-connect 里的地址必须是回环、私有网段（10/8、172.16/12、192.168/16）、链路本地、CGNAT（100.64/10，Tailscale 这类虚拟内网）、*.local/.lan/.internal 之类域名或不含点的裸主机名。公网地址在启动阶段就被拒绝，没有开关可以绕过 —— 这是为防止网关被当成匿名跳板，详见 目标串与被控机要求。
第 3 步：用浏览器打开访问地址
复制日志里「公网访问页」那一行（整行原样复制，结尾的 / 保留；控制台列表里那条不带斜杠的也能直接打开），在任何一台设备的浏览器里打开：
- 页面自己与网关打通点对点通道，状态行显示
网关在线 · 1 台机器 · 并发上限 2； - 点机器卡片，填用户名与密码（域可选），选一个分辨率；
- 点「连接桌面」，等首帧画面出来就能操作了。
第一次建议用手机流量（脱离同一内网）打开地址试一次，确认打洞在外网环境下能成。打不开时按 常见问题排查 的顺序走：① 网关进程还在；② 地址是这次启动打印的（重启过就是新地址）；③ 目标机的远程桌面已开启、账号口令正确。
让网关常驻
网关进程退出 = 访问地址立即失效，所以被控机那边的网关要保证长期运行：Windows 用任务计划程序设「启动时」运行，Linux 写 systemd 服务配 Restart=always，NAS 上直接用 Docker 部署 或 飞牛 NAS 应用。具体写法见 CLI 命令行。