Je eerste HTTPS-tunnel maken in 30 seconden

ASD CLI maakt beveiligde HTTPS-tunnels van je lokale machine naar het internet. Met één commando krijg je een publieke URL voor elke lokale service — geen port forwarding, geen firewall-regels, geen certificaten beheren. Deze gids brengt je in minder dan een minuut van nul naar een werkende tunnel.

Wat je gaat bouwen

Aan het einde van deze gids heb je een lokale webserver die bereikbaar is via een publieke HTTPS-URL die iedereen in de browser kan openen.

Je laptop                      Het internet
localhost:3000  ──SSH tunnel──▶  https://app-abc123.cicd.eu1.asd.engineer
                                 (publiek, HTTPS, automatisch certificaat)

Vereisten

• Een terminal (Linux, macOS of Windows)
• Een lokale service op een willekeurige poort, of we starten er een

Stap 1: Installeer ASD CLI

Voer de one-liner installer uit voor je platform:

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/asd-engineering/asd-cli/main/install.sh | bash

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/asd-engineering/asd-cli/main/install.ps1 | iex"

Controleer na installatie of het werkt:

asd --version

Stap 2: Start een lokale server

Als je al een lokale dev server draait (Next.js, Vite, Django, Rails, etc.), ga dan naar Stap 3. Anders start je een snelle testserver:

Python:

python -m http.server 3000

Node.js:

npx serve -p 3000

Controleer of het werkt door http://localhost:3000 te bezoeken in je browser.

Stap 3: Maak het publiek

Eén commando maakt de tunnel:

asd expose 3000

Je ziet output zoals:

Local:  http://localhost:3000
Caddy:  http://app.localhost
Tunnel: https://app-abc123.cicd.eu1.asd.engineer

Dat is het. De tunnel-URL is publiek, beveiligd met HTTPS en een automatisch certificaat, en werkt overal ter wereld. Deel het met een collega, plak het in een webhook-configuratie, of open het op je telefoon.

Stap 4: Pas de URL aan (optioneel)

Geef je tunnel een herkenbare naam:

asd expose 3000 --name myapp

Resultaat:

Tunnel: https://myapp-abc123.cicd.eu1.asd.engineer

De --name parameter zet een prefix in de URL, wat het makkelijker maakt om te herkennen wanneer je meerdere tunnels draait.

Je tunnels beheren

Bekijk wat er draait en stop tunnels wanneer je klaar bent:

# Toon alle actieve tunnels
asd expose list

# Stop een specifieke tunnel
asd expose stop myapp

# Stop op poortnummer
asd expose stop 3000

Voorbeeld asd expose list output:

myapp
    Port:     3000
    Local:    http://myapp.localhost
    Tunnel:   https://myapp-abc123.cicd.eu1.asd.engineer
    Status:   ✅ Online
    Uptime:   🕐 2h 15m

Authenticatie instellen

Voordat je tunnels kunt gebruiken, heb je credentials nodig. Kies de methode die bij je past:

Snel testen (geen account nodig):

# Verkrijg 5 minuten ephemeral credentials
curl -X POST https://asd.engineer/functions/v1/create-ephemeral-token

Voor langere sessies:

Maak tunnel credentials aan op asd.host → Account → Tunnel Tokens, en zet ze in je .env bestand:

ASD_TUNNEL_TOKEN=jouw-token
ASD_TUNNEL_USER=jouw-gebruiker

Hoe het werkt onder de motorkap

Wanneer je asd expose 3000 uitvoert, gebeuren er drie dingen:

1. ASD start een lokale Caddy reverse proxy (als die nog niet draait)
2. Een SSH-tunnel verbindt je machine met de ASD cloud
3. ASD cloud levert een publieke HTTPS-URL met automatische certificaten

Browser → HTTPS → ASD Cloud → SSH Tunnel → Caddy (lokaal) → localhost:3000

Je service blijft op je machine staan. De tunnel versleutelt al het verkeer. Het HTTPS-certificaat wordt automatisch aangemaakt.

Wat nu

• Lokale services exposen — meerdere services, custom subdomeinen, en de asd.yaml workflow
• asd.yaml configureren — projectconfiguratie voor dagelijks ontwikkelen
• Basic authenticatie toevoegen — bescherm je tunnel met een wachtwoord