Bu sayfa 2026'da Nodetonet'i komut satırından nasıl kullanacağını anlatıyor. Bir konuda baştan dürüst olalım: ngrok http 3000 gibi tek-binary nodetonet CLI'ımız henüz yok. Bu, public yol haritasında yer alıyor ve oraya geleceğiz. Bu arada ajan zaten bir CLI binary, REST API tam donanımlı ve 30 saniyelik bir shell fonksiyonu seni yolun büyük kısmına götürür.
Özet: curl kullanabiliyorsan ve elinde bir Bearer token varsa, web panelinin yapabildiği her şeyi yapabilirsin — HTTP tünelleri oluştur, mobil proxy'leri yönet, canlı istatistikleri sorgula, IP'leri döndür ve her şeyi CI'da söküp at — tarayıcıya dokunmadan.
Bugün terminalden neler yapabilirsin
Komutlara dalmadan önce API'nin bugün neyini kapsadığına ve gelecekteki CLI binary'sinin neler ekleyeceğine hızlı bir bakış:
| Yetenek | Bugün çalışıyor (curl / REST) | Geliyor: gerçek CLI binary |
|---|---|---|
| Tünel oluştur / durdur / sil | Evet — POST /api/v1/proxies | Evet — nodetonet http 3000 |
| Tünelleri listele & canlı durum | Evet — GET /api/v1/proxies | Evet — biçimli tablo |
| API token üret | Evet — POST /api/v1/tokens | Evet — nodetonet token create |
| Mobil proxy havuzlarını yönet | Evet — /api/v1/rotating-proxies | Evet — interaktif flag |
| Token'ı OS keychain'de sakla | Hayır — export NTN_TOKEN gerekli | Evet — nodetonet config |
| Canlı istek inspector | Hayır — yalnızca panel | Evet — terminale akar |
| Shell tamamlamaları | Hayır | Evet — bash / zsh / fish |
API yüzeyi stabil ve versiyonlanmış — bugün yazdığın her şey CLI çıktığında da çalışmaya devam eder; çünkü CLI, aynı endpoint'ler üstünde kullanıcı dostu bir sarmalayıcıdır.
1 · Ajanı kur
Ajan, Linux, macOS ve Windows için önceden derlenmiş binary olarak gönderdiğimiz tek bir Node.js bundle'ı. Tek satırlık kurucu işletim sistemi/mimariyi algılar ve binary'yi /usr/local/bin/nodetonet-agent'a (veya kullanıcı kurulumunda $HOME/.local/bin'e) bırakır. Bu ajan ayrıca VDS'te HTTP tünelleri barındıran Windows .exe'yi de çalıştırır — aynı binary, farklı rol.
# macOS / Linux — /usr/local/bin'e kurar (sudo kullanır)
curl -fsSL https://nodetonet.com/agent/install.sh | sh
# Kullanıcı kurulumu — root yok, ~/.local/bin'e bırakır
curl -fsSL https://nodetonet.com/agent/install.sh | INSTALL_DIR=$HOME/.local/bin sh
# Windows (PowerShell)
iwr https://nodetonet.com/agent/install.ps1 -useb | iexKurucu bittikten sonra nodetonet-agent --version build hash ve sürümü yazdırmalı. Her sürümün SHA-256'sı /download altında binary'nin yanında yayınlanır; güvenmeden önce dosyayı doğrulayabilirsin. Sorun giderme ipuçları için ajan kurulum rehberine bak.
2 · Ajanı eşleştir
Ajan, ancak eşleştirildikten sonra hesabınla konuşur. Eşleştirme tek seferlik bir değiş tokuş: ajan bir anahtar çifti üretir, panel bir eşleştirme token'ı (8 karakterlik kod) verir ve kodu nodetonet-agent pair komutuna yapıştırdığında cihaz hesap panelinizde tünel almaya hazır şekilde görünür.
$ nodetonet-agent pair
Paneldeki 8 karakterlik eşleştirme kodunu yapıştır: AB12-CD34
v 'web-1' olarak eslesti (id: 8f3e...c4)
v Ajan hub wss://hub.nodetonet.com'a kaydedildi
v Durum: cevrimici - uptime butcesi OK - tunel kabul ediyorBu noktadan sonra ajan kalıcı bir WebSocket üzerinden bağlı kalır. Token grubunun izin verdiği kadar tüneli bu ajan üzerinden çalıştırabilirsin. Anahtar çifti yerel olarak saklanır ve asla düz metin olarak makinenden çıkmaz.
3 · Bearer token al
Her API çağrısı, hesabına kapsamlandırılmış bir Bearer token ile kimlik doğrular. İlk token'ı panelden profil ayarların üzerinden üret, sonrasında programatik olarak oluşturabilirsin:
# API üzerinden token oluştur (ilk token için paneli kullan)
curl -X POST https://nodetonet.com/api/v1/tokens -H "Authorization: Bearer $NTN_TOKEN" -H "Content-Type: application/json" -d '{"name": "ci-bot", "scopes": ["proxies:write", "proxies:read"]}'Token'ı CI sır yöneticinizde sakla (GitHub Actions Secrets, GitLab CI Variables, vb.) — kaynak koduna asla commit etme. Daha fazlası için API anahtarını anlamak ve müşteri API token'ları vs kişisel token'lar yazılarına bak.
4 · Komut satırından tünel oluştur
Özel CLI yayınlanana kadar "tünel oluştur" komutu, Bearer token'ınla POST /api/v1/proxies'e bir curl çağrısıdır. Kimlik doğrulama ve hata yönetimi için REST API ilk çağrı rehberine bak.
export NTN_TOKEN="ntn_live_xxxxxxxxxxxxxxxx"
curl -X POST https://nodetonet.com/api/v1/proxies -H "Authorization: Bearer $NTN_TOKEN" -H "Content-Type: application/json" -d '{
"name": "dev-server",
"subdomain": "alice-dev",
"target_host": "127.0.0.1",
"target_port": 3000,
"device_id": "8f3e...c4"
}'Yanıt; public URL'i, otomatik düzenlenen Let's Encrypt sertifika durumunu ve sonraki PATCH / DELETE çağrıları için gereken proxy id'sini içerir. Sertifikalar otomatik yenilenir — nasıl çalıştığı için Let's Encrypt otomatik yenileme'ye bak.
{
"id": "px_01HXXXX",
"url": "https://alice-dev.nodetonet.com",
"status": "running",
"created_at": "2026-05-15T09:14:22Z"
}5 · Drop-in shell fonksiyonu
Şunu ~/.zshrc veya ~/.bashrc'ye yapıştır ve bugün için kabul edilebilir bir ngrok http 3000 eşdeğerine sahip ol:
ntn() {
local port="${1:-3000}"
local sub="${2:-$(whoami)-dev}"
curl -fsS -X POST https://nodetonet.com/api/v1/proxies \
-H "Authorization: Bearer $NTN_TOKEN" \
-H "Content-Type: application/json" \
-d "{\"subdomain\":\"$sub\",\"target_host\":\"127.0.0.1\",\"target_port\":$port}" \
| jq -r '.url'
}
# kullanim: ntn 3000 -> https://alice-dev.nodetonet.com yazdirır
# ntn 8080 my-api -> https://my-api.nodetonet.com yazdirırNodetonet'in peşin-kredi modelinde boştaki tüneller hiçbir şey tutmaz; bu yüzden her geliştirme oturumunun başında bunu çağırabilir ve temizlemeyi unutmayı önemsemeyebilirsin — arka planda tıklayan ücretli bir saat yok.
6 · Programatik örnekler — listele, güncelle, sil
Beklediğin üç fiil:
# hesabındaki tüm proxy'leri listele
curl -H "Authorization: Bearer $NTN_TOKEN" https://nodetonet.com/api/v1/proxies
# birini durdur (durdurulurken ücretsiz)
curl -X PATCH -H "Authorization: Bearer $NTN_TOKEN" -H "Content-Type: application/json" -d '{"status":"stopped"}' https://nodetonet.com/api/v1/proxies/px_01HXXXX
# birini sil
curl -X DELETE -H "Authorization: Bearer $NTN_TOKEN" https://nodetonet.com/api/v1/proxies/px_01HXXXXHer uç noktanın tam şeması /openapi.json'da; Postman, Insomnia veya herhangi bir OpenAPI kod üreticisine yapıştırarak saniyeler içinde typed bir client elde edebilirsin. Python örneği için Python'da programatik tünel oluşturma'ya bak.
7 · CI/CD'de API kullanımı
Yaygın bir CI deseni: job başlangıcında tünel aç, entegrasyon testlerini public URL'e karşı çalıştır, sonra söküp at. API durumsuz ve tüneller oluşturup silmesi ucuz olduğu için bunu birçok job'da paralel yapmak güvenlidir.
# .github/workflows/integration.yml (özet)
- name: Tunel baslat
run: |
URL=$(ntn $PORT preview-$GITHUB_RUN_ID)
echo "TUNNEL_URL=$URL" >> $GITHUB_ENV
- name: Testleri calistir
run: npx playwright test --base-url $TUNNEL_URL
- name: Tuneli kapat (her zaman)
if: always()
run: curl -X DELETE -H "Authorization: Bearer $NTN_TOKEN" https://nodetonet.com/api/v1/proxies/$TUNNEL_IDOtomasyonda mobil proxy havuzlarını yönetmek — IP döndürme, IP değişimi tetikleme, canlı byte sayımlarını okuma — için aynı REST API /api/v1/rotating-proxies altında geçerlidir. Ölçeklenen desenler için 100+ proxy için toplu işlemler'e bak.
8 · Yolda: gerçek bir ngrok tarzı CLI
Yukarıdaki shell fonksiyonu seni yolun %80'ine götürür. Kalan %20 — gerçek bir CLI binary gerektiren şeyler — yol haritasında:
nodetonet http 3000— tek komutla tünel, URL yazdırır, ön planı tutar,Ctrl+C'de kapatır.nodetonet tcp 5432— public internet üzerinden veritabanı bağlantıları için kullanışlı TCP tünelleri, aynı UX.nodetonet config— token'ı OS keychain'de sakla; artıkexport NTN_TOKENyok.- Terminale akan canlı istek inspector — request line, header'lar, body önizlemesi — tarayıcı paneline gerek yok.
- bash, zsh ve fish için shell tamamlamaları.
nodetonet proxy rotate— rotating proxy cihazında IP değişimini doğrudan terminalden tetikle.
CLI, CLI · Q3 2026 olarak takip ediliyor. Beta test etmek istersen iletişim sayfasından ulaş ya da discord.gg/nodetonet'teki topluluğa katıl.
Terminal kullanımı için güvenlik kontrol listesi
NTN_TOKEN'ı asla loglama veya commit etme — CI sağlayıcının sır deposunu kullan.- Her job için gereken minimum izinlere sahip kapsamlı token'lar üret (
proxies:readvsproxies:write). - Token'ları düzenli olarak döndür;
DELETE /api/v1/tokens/:idendpoint'i anında iptal eder. install.sh'yi belirli bir sürüm hash'ine sabitle ve /download'da yayınlanan SHA-256'yı doğrula.- CI runner paylaşımlıysa token'ı tüm hesap yerine proje namespace'ine kapsaylandır. Rehber için müşteri API token'ları vs kişisel token'lar'a bak.
Başlayın
Hazır mısın? Ajanı indir, hesabından bir Bearer token al ve yukarıdaki tek-satırlık komutla ilk tünelini aç. Tam REST referansı /openapi.json'da, topluluk discord.gg/nodetonet'te.