NVIDIA / NVIDIA/Personal-AI-Router
[Feature]: Support for Tailscale mesh network endpoints (CGNAT IPs and MagicDNS domain names)
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Go
- Sterne
- 1.4k
- Forks
- 250
- Ø Merge
- 23 Std. 27 Min.
- Gemergte PRs (30 T.)
- 1
Beschreibung
Area
Discovery or pairing
User problem
Note: This feature request includes AI generated suggestions (Google's Antigravity). I have marked
form sections where I lack context knowledge.
When attempting to connect a device (such as a MacBook Pro) located outside the local physical network using
Tailscale, PAIR is unable to connect to the remote LLM or register the remote machine as a node.
Specifically:
- Automatic Discovery Fails: mDNS discovery does not span across subnets or overlay networks without
explicit multicast forwarding. - Manual IP Addition Fails: Adding a node manually using its Tailscale IPv4 address (
100.64.x.xCGNAT
range) fails to establish pairing or route requests. - MagicDNS Hostnames Fail: Adding a node using its Tailscale domain name
(e.g.,macbook-pro.tailnet- name.ts.net) is either rejected by host validation or fails during probe/pairing.
As a result, users working remotely cannot access their home/office PAIR cluster's LLM resources or contribute remote nodes to an existing cluster.
Desired outcome
Tailscale & VPN Node Pairing: Users should be able to manually add out-of-network nodes by entering
either their Tailscale IP address (100.64.0.0/10) or MagicDNS domain name in the "Add Node" interface.
Alternatives considered
I tried an OpenVPN connection instead of Tailscale and had the same user problem.
Compatibility and security implications
Note: these are AI generated suggestions (Google's Antigravity) that I am not certain of.
- Address Scoring: Updating
services/shared/netpickso that explicit manual node additions for CGNAT
(100.64.0.0/10) and virtual interface addresses (tailscale0,utun) are not demoted below unreachable
physical LAN interfaces. - DNS & FQDN Support: Ensuring
nvpair-manual-nodesand cluster pairing clients perform asynchronous DNS
re-resolution for MagicDNS domain names (.ts.net). - mTLS & SANs: Ensuring TLS certificates issued during PIN pairing include MagicDNS hostnames and
Tailscale IP addresses in Subject Alternative Names (SANs). - Security: PAIR's PIN pairing, identity verification, and mTLS traffic encryption will protect
communication even over external overlay networks.
Validation approach
- Set up a PAIR host on a local network equipped with Tailscale.
- Connect a remote device (e.g., MacBook Pro on cellular/external Wi-Fi) to the same Tailscale network
(Tailnet). - Open PAIR UI on the host, select Add Node, and input the MacBook Pro's Tailscale IP (
100.64.x.y) or
MagicDNS domain. - Verify PIN pairing completes successfully, telemetry/node-info populates, and inference requests route to
the remote node.
Confirmations
- I searched existing issues for duplicates.
- I agree to follow the Code of Conduct.
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne damit, den Add Node-Flow für manuelle Adressen und Pairing nachzuverfolgen, und untersuche anschließend services/shared/netpick und nvpair-manual-nodes. Prüfe, wie die Host-Validierung, die DNS-Auflösung, das PIN-Pairing und die Zertifikat-SANs für Node-Endpunkte gehandhabt werden. Die Aufgabe ist abgeschlossen, wenn eine Tailscale-IP oder ein MagicDNS-Name das Pairing abschließen, Node-Informationen auffüllen und Inferenzanfragen im Validierungs-Setup weiterleiten kann.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- go
- Bereich
- authentication, networking, security
- Issue-Typ
- Feature
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Aktiv
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 45/100