FRP 网域
FRP 网域用于访问 frp 的 STCP / XTCP visitor 资源。
OmniGate 的 FRP 设计分两层：
- 网域层保存 frpc client 配置。
- 资源层保存 visitor 配置。
网域层配置
| 字段 | 说明 |
|---|---|
| 名称 | 网域显示名 |
| clientID | frpc client ID，可选 |
| user | frpc user，通常需要和服务端配置匹配 |
| serverAddr | frps 地址 |
| serverPort | frps 端口，默认 7000 |
| auth.token | frps token |
| transport.protocol | tcp、kcp 或 quic，默认 tcp |
资源层 visitor 配置
FRP 资源不需要手动填写本地地址和端口。OmniGate 会自动分配 127.0.0.1:<随机端口>，避免端口冲突。
资源层需要填写：
| 字段 | 说明 |
|---|---|
| visitor 类型 | STCP 或 XTCP |
| serverUser | 对端 frpc 的 user，需要与发布服务的一端一致 |
| serverName | 对端 proxies.name，例如 ssh 或 web |
| secretKey | 对端 proxies.secretKey |
资源列表第二行会显示 serverUser.serverName，方便确认连接的是哪个 FRP 服务。
打开资源时发生什么
- OmniGate 根据网域配置登录 frps。
- 根据资源配置启动 visitor。
- 随机绑定一个本地可用端口。
- Web、SSH、文件或 VNC 客户端访问该本地端口。
常见问题
frps 提示 client_id already online
同一个 user + clientID 不能重复在线。建议：
- 不要在多个设备上使用完全相同的 clientID。
- 如果你反复点击同一个资源，OmniGate 会尽量复用已有 visitor session，但服务端仍可能因为旧连接未释放短暂冲突。
custom listener doesn't exist
通常是资源层serverUser或serverName填错。serverUser要与发布服务的 frpc user 一致。
SSH 用 FRP 连上但认证失败
先确认同一 SSH 资源在直连下是否可用。FRP 只负责转发 TCP，SSH 认证仍由目标 sshd 决定。使用私钥登录时，要在 SSH 资源里选择对应密钥。