Ngrok Nedir ve Nasıl Kullanılır

sysuser · 30 Kas 2025

Ngrok, lokal bilgisayarınızda çalışan uygulamaları internete güvenli bir şekilde açmanızı sağlayan bir araçtır. Geliştiriciler için test ortamları, IoT cihazları, lokal oyun sunucuları veya web uygulamalarınızı paylaşmak için idealdir. Ngrok, tünel bağlantısı ile HTTPS sertifikalarını otomatik yönetir ve uygulamanızı hızlıca erişilebilir hâle getirir.

Ngrok Hesabı ve Auth Token
Ngrok’u kullanmak için öncelikle

Bağlantıları görmek için giriş yapmış veya kayıtlı olmanız gerekiyor.

oluşturun. Hesap açtıktan sonra size özel auth token’ınızı

Bağlantıları görmek için giriş yapmış veya kayıtlı olmanız gerekiyor.

alabilirsiniz. Bu token, Ngrok Agent CLI ile hesabınızı bağlamak için gereklidir.

Ngrok Agent CLI Kurulumu
Ngrok Agent CLI, uygulamanızı internete açmak için kullanacağınız ana araçtır. İşletim sisteminize uygun kurulum adımlarını uygulayın.

Mac OS için:

Kod:

brew install ngrok



Debian Linux için:



curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
| sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
&& echo "deb https://ngrok-agent.s3.amazonaws.com buster main" \
| sudo tee /etc/apt/sources.list.d/ngrok.list \
&& sudo apt update \
&& sudo apt install ngrok

Windows için:
Windows App Store’dan yükleyin veya

Bağlantıları görmek için giriş yapmış veya kayıtlı olmanız gerekiyor.

linkini kullanabilirsiniz.

Kurulumu doğrulamak için:

Kod:

ngrok help

komutunu çalıştırın. Yardım metni görünüyor ise kurulum başarıyla tamamlanmıştır.

Hesabınızı Bağlamak
Ngrok Agent CLI’yi hesabınıza bağlamak için auth token’ınızı kullanın:

Kod:

ngrok config add-authtoken $YOUR_TOKEN

Uygulamanızı Başlatmak
Lokal uygulamanızı başlatın. Ngrok, bu uygulamanıza gelen trafiği internete yönlendirecek.

Örnek Node.js HTTP sunucu (8080 portu):

Kod:

const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end('<h1>Hello from Node.js HTTP Server!</h1>');
});
server.listen(8080, () => console.log('Server running at http://localhost:8080'));

Go veya Python için de benzer minimal HTTP sunucuları oluşturabilirsiniz.

Uygulamanızı Internete Açmak
Ngrok agent’i başlatın ve port numarasını girin:

Kod:

ngrok http 8080

Ngrok size ücretsiz bir dev domain sağlar. Ücretli planlarda --url ile domain özelleştirebilirsiniz.

Tarayıcıda yönlendirme URL’sine giderek uygulamanızı HTTPS ile görebilirsiniz.

Uygulamanızı Güvenceye Almak
Ngrok, kullanıcı doğrulama ve güvenlik politikalarını destekler. ngrok.yml dosyanız üzerinden Traffic Policy ayarlayabilirsiniz:

ngrok config edit

Örnek OAuth ayarı:

Kod:

endpoints:
- name: cli-quickstart
url: $YOUR_DOMAIN
traffic_policy:
on_http_request:
- actions:
- type: oauth
config:
provider: google
upstream:
url: 8080
protocol: http1

Bu sayede kullanıcılar uygulamaya erişmeden önce Google hesabıyla giriş yapmak zorunda kalır.

Endpoint’i Başlatmak

Kod:

ngrok start cli-quickstart

Artık uygulamanız güvenli bir şekilde internete açılmıştır.

Ngrok ile Agent SDK’ları kullanarak programatik kontrol sağlayabilir, sürekli açık cloud endpoint’ler kurabilir veya trafik politikaları ile ileri güvenlik ve erişim kontrolleri ekleyebilirsiniz. Ngrok Agent CLI komutları ile endpoint’lerinizi yönetmek, test etmek ve ölçeklendirmek oldukça kolaydır.

Ngrok Nedir ve Nasıl Kullanılır

sysuser