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 資源裡選擇對應金鑰。