docs: clarify remote transport IP reporting

2026-01-25 00:39:50 +00:00
parent a6c97b5a48
commit 6375ee836f
2 changed files with 16 additions and 3 deletions
--- a/docs/platforms/macos.md
+++ b/docs/platforms/macos.md
@@ -180,6 +180,9 @@ components can talk to a remote Gateway as if it were on localhost.
  or restarts it if needed.
 - **SSH shape:** `ssh -N -L <local>:127.0.0.1:<remote>` with BatchMode +
  ExitOnForwardFailure + keepalive options.
+- **IP reporting:** the SSH tunnel uses loopback, so the gateway will see the node
+  IP as `127.0.0.1`. Use **Direct (ws/wss)** transport if you want the real client
+  IP to appear (see [macOS remote access](/platforms/mac/remote)).

 For setup steps, see [macOS remote access](/platforms/mac/remote). For protocol
 details, see [Gateway protocol](/gateway/protocol).