NVIDIA / NVIDIA/Personal-AI-Router
[Feature]: Support for Tailscale mesh network endpoints (CGNAT IPs and MagicDNS domain names)
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 1.4k
- Forks
- 250
- Avg merge
- 23h 27m
- Merged PRs (30d)
- 1
Description
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.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by tracing the Add Node flow for manual addresses and pairing, then inspect services/shared/netpick and nvpair-manual-nodes. Check how host validation, DNS resolution, PIN pairing, and certificate SANs are handled for node endpoints. Done means a Tailscale IP or MagicDNS name can complete pairing, populate node information, and route inference requests in the validation setup.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go
- Domain
- authentication, networking, security
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100