Jouw Lokale AI Openstellen met Cloudflare Tunnels: Zo Koppel je Naden aan Externe Diensten
Stel je voor: je hebt thuis je eigen slimme AI draaien met Naden, alles keurig in een Docker-container. Je bent trots, maar opeens stuit je op een muur – je wilt koppelen met Gmail of Telegram, maar niemand kan jouw lokale AI bereiken! Gelukkig is het opzetten van een Cloudflare tunnel helemaal niet zo ingewikkeld als het lijkt. In deze blog neem ik je stap voor stap mee van lokaal naar wereldwijd toegankelijk, zodat jouw Naden eindelijk kan praten met de buitenwereld.
Van Lokaal naar Publiek: Het Cloudflare Tunnel Fundamant
Het begint allemaal bij Cloudflare. Misschien klinkt het als iets voor grote bedrijven, maar binnen vijf minuten heb jij je eigen tunnel live. Allereerst heb je een domeinnaam nodig. Heb je er al één? Top! Geen domein? Geen probleem, bij Cloudflare koop je er één voor een paar euro per jaar. Een stuk slimmer (én stabieler) dan een gratis tijdelijke URL van bijvoorbeeld ngrok: je slimme AI verdient z'n eigen voordeur.
Publieke URL versus Tijdelijke Tunnels
Veel beginnende hobbyisten kiezen voor een quick-and-dirty oplossing zoals ngrok, maar dat levert enkel een tijdelijk, onvoorspelbaar adres op. Met een domein bij Cloudflare geef je externe apps een betrouwbare route naar jouw AI, en dat scheelt frustratie op de lange termijn.
Stap-voor-Stap: Je Eerste Cloudflare Tunnel inrichten
Cloudflare Zero Trust is jouw startpunt. Na inloggen kies je aan de linkerkant Zero Trust, vervolgens Networks en dan Tunnels. Klik op ‘Add a tunnel’ en geef hem een herkenbare naam, bijvoorbeeld naden-test. Nu vraagt Cloudflare om een ‘connector’ op je apparaat te installeren – kies je platform, volg de installatie-instructies en check of de tunnel als ‘healthy’ wordt weergegeven.
Je tunnel verbindt nu jouw lokale netwerk met de online wereld, maar je bent er nog niet. Nu moet je je domein aan deze tunnel koppelen, zodat dataverkeer écht kan doorstromen.
Van Localhost naar Wereldwijd: Hostnaam Instellen
Klik op je tunnel, kies voor ‘Configure’, en voeg een ‘Public Hostname’ toe. Kies als subdomein bijvoorbeeld naden, en wijs deze toe aan jouw hoofddomein – bijvoorbeeld naden.techcorp.org. De service wijs je vervolgens naar jouw lokale poort, doorgaans localhost:5678 als je de standaardinstellingen gebruikt. Na opslaan is je tunnel live en kun je vanaf elke plek jouw lokale Naden benaderen!
"Ineens kun je je AI-assistent bedienen vanuit je smartphone, of hem koppelen aan apps als Telegram en Google, allemaal dankzij die ene publieke adres die via Cloudflare netjes en veilig naar je thuis-setup doorschakelt."
Maak het Af: Webhooks & Omgevingsvariabelen in Docker
Ben je al onderweg, maar werken inkomende koppelingen zoals webhooks of Google-integraties nog niet? Dan moet je Docker vertellen waar de buitenwereld je kan vinden. Ga naar je docker-compose.yml middels je favoriete editor (Visual Studio Code, Cursor, of zelfs Kladblok) en voeg de benodigde environment variables toe:
- WEBHOOK_URL: Deze zet je op jouw publieke Cloudflare domein, bijvoorbeeld https://naden.techcorp.org/
- NADEN_PROTOCOL: Deze zet je op https om externe communicatie correct in te stellen.
Vergeet niet het Docker-container te herstarten nadat je deze wijzigingen hebt doorgevoerd. Gebruik hiervoor in de terminal:
- docker compose down – om je container stop te zetten
- docker compose up -d – om alles weer op te starten met de nieuwe instellingen
Belangrijke aandachtspunten op een rij:
- Zorg dat je tunnel ‘healthy’ is in het Cloudflare dashboard voor je verder gaat
- Check of de publieke URL nu in je Naden-browser staat in plaats van alleen localhost
- Sla je docker-compose.yml altijd op vóór je herstart
- Laat de AI-community (of een LLM) meehelpen als je vastloopt met terminal-commando’s – met de juiste context kom je ver
Wat Dit Betekent Voor de Toekomst van Jouw Eigen AI
Met een Cloudflare tunnel heb je niet alleen je eigen AI uit de ‘kelder’ getild, maar geef je hem een volwaardige plek op het wereldtoneel. Je Naden kan nu worden gebruikt voor slimme koppelingen met Google Drive, Telegram of andere diensten die ooit onbereikbaar waren. En als je ooit groter wilt gaan – denk aan workflows, automatiseringen of zelfs een eigen API-servertje aanbieden – dan vormt deze setup het fundament waarop je eindeloos kunt uitbreiden.
Dit lijkt misschien veel techniek, maar met een beetje puzzelen (en de juiste begeleiding) wordt een gesloten thuisproject ineens een slimme, publieke tool. Dus, durf je eigen AI de wereld in te sturen – Cloudflare zorgt dat het veilig en soepel gebeurt!