公网接入指南
让外网通过你的服务器，访问局域网内的云机（ADB、画面、控制、音频）
它能做什么
用一台公网服务器作为中转，让你在家、出差时也能远程连接公司/机房内的云机：
- 在外网执行 ADB 调试
- 在外网投流画面、音频、远程控制
- 多人协作共用同一台服务器
准备工作
1. 准备一台 Linux 服务器
最常见的选择是阿里云 / 腾讯云 / 华为云等服务商的入门级云服务器。
最低系统要求：
- Debian 11 及以上，或 Ubuntu 20.04 及以上，或 CentOS 8 及以上 / Rocky / Alma
- 有一个固定的公网 IP，或一个已解析的域名
2. 准备 SSH 登录信息
需要以下信息以便部署：
- 服务器 IP 或域名（例如
frp.example.com） - SSH 端口（默认 22，部分云厂商会改为其他端口）
- SSH 用户名和密码
关于权限：建议使用
root用户登录。
3. 在云控制台预先放行端口（TCP）
需要在云服务商的安全组或防火墙里放行以下端口：
| 端口 | 默认值 | 含义 |
|---|---|---|
| 通信端口 | 7000 | 客户端连到服务器的入口 |
| 控制台端口 | 7500 | 服务器管理面板 |
| 映射端口范围 | 30000 - 31000 | 分配给云机使用的端口区间 |
上述默认值可以在部署时自定义。无论用默认值还是改过的值，都必须在云控制台放行。
部署步骤
第 1 步：打开"公网映射"页面
在桌面客户端左侧菜单点击 公网映射。
第 2 步：选择部署模式
| 模式 | 适用情况 |
|---|---|
| 公网服务器（推荐） | 云厂商买的服务器，99% 选这个 |
| NAT 穿透 | 服务器在内网，需要路由器额外做端口转发 |
NAT 模式额外要求：路由器上把通信端口 / 控制台端口 / 映射端口范围都做相同的端口转发到内网服务器。
第 3 步：填写服务器连接信息
| 字段 | 说明 |
|---|---|
| 服务器 IP / 域名 | 你的服务器地址 |
| SSH 端口 | 默认 22，按实际填 |
| SSH 用户名 | 登录服务器的账号 |
| SSH 密码 | 登录服务器的密码 |
第 4 步：设置两个密码
部署表单需要你设置两个密码：
| 密码 | 用途 |
|---|---|
| 控制台密码（服务端） | 登录服务器管理面板时使用 |
| 客户端密码（客户端） | 客户端与服务器之间的通信凭证 |
两个密码都必须至少 8 位，包含大小写字母和特殊符号。
第 5 步：(可选) 调整端口
默认值通常够用，特殊需求才改：
- 通信端口、控制台端口、映射端口范围（与第二步表格中含义一致）
第 6 步：(可选) 是否启用 "隐藏映射端口"
默认关闭即可。除非有特殊安全需求才打开。
第 7 步：点 "部署并启动"
界面会显示部署进度。失败时会显示具体原因，常见的有：
- SSH 连接失败：检查 IP、端口、用户名、密码是否正确
- 端口被占用：换一个端口重试
- 系统不支持：服务器系统版本太老（不在支持范围）
把云机加入映射
部署成功后，主界面会列出所有已发现的云机。
主机层面
每个主机右侧有"开启映射"开关。打开后，主机本身可以通过公网访问。
主机右侧还有 "全部开启 / 全部关闭" 按钮，点击后会对该主机下的所有云机一次性开启或关闭映射。
单台云机映射
每台云机右侧也有自己的开关。打开后会自动建立 ADB、画面、控制、音频几个端口的映射。 点击开关时可以选择只映射其中部分端口类型。
关闭映射
关闭对应开关，端口会被立即释放。如果该端口上还有正在使用的连接，系统会自动尝试断开。
极少数情况下顽固的连接无法断开，会弹出一个"端口未能完全断开"提示。这时你可以选择关闭整个映射服务，强制断开所有连接。
配置完后怎么用
部署成功后，每台映射好的云机会自动分配一个公网端口。映射列表里能看到每台云机对应的端口号。
ADB 远程调试
adb connect 你的服务器IP:云机分配的ADB端口例如，云机 A 的 ADB 端口被分配为 30001：
adb connect frp.example.com:30001
adb -s frp.example.com:30001 shell画面 / 控制 / 音频
把对应端口告诉你的客户端工具（例如 scrcpy 系列工具）即可。
日常管理
| 操作 | 作用 |
|---|---|
| 启动映射 | 服务停止后重新启动 |
| 关闭映射 | 停止所有映射，但保留配置（下次可直接启动） |
| 设置 | 修改服务器配置、客户端配置、SSH 信息 |
| 释放无用端口 | 清理已删除云机残留的端口占用 |
| 重置服务 | 卸载服务器上的所有相关服务，并清空本地所有配置（不可恢复） |
修改配置的提示
- 修改服务器配置（如端口、密码）后，会提示"需要更新远程服务器"，确认后会通过 SSH 重新配置并重启服务
- 修改客户端管理端口、公网地址后，会提示"需要重启映射服务"，确认后重启
- 仅修改映射开关 / 端口类型 → 实时生效，无需重启
修改 SSH 密码
如果服务器 SSH 密码改了，进入"设置 → SSH 配置"更新新密码即可，系统会自动重连。
常见问题
Q1：部署失败，提示"端口已被占用"
服务器上已有其他程序占着同一个端口（最常见是已经装了的 nginx 占着 80）。
解决：把"服务端口"改成其他没被占用的端口（例如 8080、7001）。
Q2：关闭映射后客户端还能连上
正常情况下，关闭后大约 5 - 15 秒内会被强制断开。如果一直能连上：
- 客户端可能在持续重连，可以关闭整个映射服务彻底切断
- 如果用的是 CentOS 7 等老系统，升级到推荐版本
Q3：弹窗提示"端口未能完全断开"
系统已经多次尝试断开了，但仍有顽固连接。如需立即生效，请关闭整个映射服务。
Q4：部署成功但外网访问不了
按以下顺序检查：
- 云控制台的安全组 / 防火墙：相关端口是否放行了（TCP 协议）
- NAT 模式下：路由器是否把对应端口转发到了内网服务器
- 本地网络：你所在的网络是否被防火墙限制了出站
Q5：如何彻底卸载
点击"重置服务"。注意此操作不可恢复，会清理远程服务器上的相关程序和所有本地配置。
安全建议
- 使用强密码：服务端控制台密码、客户端通信密码都要用强密码（已强制最低复杂度）
- 及时关闭不用的映射：减少暴露面
- 服务器选地理位置较近的：减少延迟，提升体验