Share URLs Core

Every tunnel automatically gets a human-readable share URL like swift-bay.nfltr.xyz. Share it with anyone — no sign-up required to access. Add password protection, IP restrictions, or bearer token authentication with a single flag.


How Share URLs Work

When you start a tunnel, the NFLTR server generates a memorable two-word subdomain and routes it to your agent. The share URL is a wildcard DNS entry — *.nfltr.xyz — so it works instantly with zero DNS configuration.

VISITOR swift-bay.nfltr.xyz No auth required DNS *.nfltr.xyz wildcard CNAME NFLTR SERVER Code → Agent lookup + relay YOUR APP localhost:3000

Basic Usage

Share URLs are generated automatically — just run nfltr http:

$ nfltr http 3000
Share URL: https://swift-bay.nfltr.xyz/

Send the URL to anyone. They can access your local service immediately — no NFLTR account needed.

To disable share URL generation:

nfltr http 3000 --no-share

Protection Options

Share URLs can be protected in multiple ways — all configurable from the command line:

🔑 Password Protection

Visitors must enter a password before accessing the share URL.

nfltr http 3000 \
  --share-auth mysecretpass

🌐 IP Allowlist

Restrict access to specific IP addresses or CIDR ranges.

nfltr http 3000 \
  --share-ip-allowlist 1.2.3.4 \
  --share-ip-allowlist 10.0.0.0/8

🎟️ Bearer Token

Require an Authorization: Bearer header for programmatic access.

nfltr http 3000 \
  --share-bearer mytoken123

# Access with:
curl -H "Authorization: Bearer mytoken123" \
  https://swift-bay.nfltr.xyz/

URL Formats

NFLTR provides two types of URLs for each tunnel:

TypeURL PatternPersistence
Share URLhttps://swift-bay.nfltr.xyz/Changes on each tunnel start (ephemeral)
Browse URLhttps://nfltr.xyz/browse/alice.my-api/Stable — uses your agent ID (persistent)

Use share URLs for temporary access (demos, reviews, testing). Use browse URLs with --name for stable, long-lived endpoints.

Auto-Expiry

Share URLs expire automatically when the agent disconnects. This ensures that temporary links don't linger after you stop your tunnel. When the agent reconnects, a new share code is generated.

💡 Combine protections

You can use multiple protection mechanisms together. For example, --share-auth + --share-ip-allowlist requires both password and correct IP address.

Use Cases

Start sharing in seconds

One command gives you a public, shareable URL for any local service.

Download Agent HTTP Tunnels →