Nodetonet masaüstü agent'ı, herhangi bir Windows, macOS veya Linux makineyi proxy arka ucuna dönüştüren küçük, tek dosyalık bir daemon'dur. Çalışıp bir token ile eşleştirildikten sonra, cihaz panelinizde yeşil ONLINE olarak görünür ve saniyeler içinde mobil proxy, rotating proxy veya HTTP tünel trafiğini üzerinden yönlendirmeye başlayabilirsiniz.
Bu rehber her platformu adım adım ele alıyor; ilk çalıştırmada karşılaşacağınız platforma özgü engeller de dahil. Android agent'ı (telefon ve tabletler) için İlk tokeniniz ve Android eşleştirme yazısına bakın. Token oluşturma her platformda aynıdır ve o yazının sonunda anlatılmaktadır.
Başlamadan önce: token oluşturun
Her agent örneği bir proxy token'ı ile bağlıdır. Token'lar, panelin bir cihazı tanımlama, trafiğe atama ve sağlığını izleme biçimidir. Henüz oluşturmadıysanız panelde /tokens sayfasını açın, Yeni token'a tıklayın, bir etiket verin ve değeri kopyalayın; ilk açılışta agent'a yapıştıracaksınız. Bir token = bir agent süreci; ayrı makinelerde her biri kendi token'ıyla istediğiniz kadar agent çalıştırabilirsiniz.
Bu agent'ın bir round-robin rotating proxy havuzunun parçası olmasını istiyorsanız, kurulumdan sonra bir token grubu oluşturun ve token'ı ekleyin. Yapışkan oturumlar (bir arayanın proxy kullanıcı adına -session-XXXX eklediği durum) için agent tarafında ekstra yapılandırmaya gerek yoktur.
1. Windows
Windows kurulumu üçü arasında en basit olanıdır. /download sayfasından Windows sekmesini seçin ve nodetonet-agent-windows-x64.exe dosyasını indirin. Binary kod imzalıdır; Windows Defender SmartScreen uyarı vermeden çalıştırmaya izin vermelidir.
.exedosyasına çift tıklayın. Küçük bir konsol penceresi açılır.- İlk açılışta agent şunu sorar: "Paste your token:". /tokens sayfasından token'ınızı kopyalayıp konsol penceresine sağ tıklayarak yapıştırın.
- Agent token'ı
%APPDATA%Nodetonetconfig.jsoniçine kaydeder ve sonraki her açılışta otomatik olarak yeniden bağlanır — o makinede bir daha token sorulmaz.
Windows'ta başlangıçta otomatik çalıştırma (üçüncü taraf araç gerekmez)
Win+R tuş kısayoluyla Çalıştır iletişim kutusunu açın, shell:startup yazın ve Enter'a basın. Açılan klasöre .exe dosyasının kısayolunu bırakın; Windows, kullanıcı her oturum açtığında agent'ı otomatik başlatacaktır. Hata durumunda yeniden başlatma veya oturum açmadan çalışma gibi servis benzeri davranış istiyorsanız, "Kullanıcı oturum açmış olsun ya da olmasın çalıştır" ve "Hata eyleminde yeniden başlat" ayarlı bir Zamanlanmış Görev kullanın.
2. macOS
macOS, varsayılan olarak imzasız üçüncü taraf binary'leri engellediği için ekstra bir adım gerektirir: Gatekeeper. İndirme sayfasından macOS sekmesini seçin ve nodetonet-agent-macos-x64 dosyasını alın. Aynı binary, Apple Silicon'da Rosetta 2 altında çalışır; yerel arm64 build planlanmaktadır.
- Terminal'i açın ve dosyayı çalıştırılabilir yapın:
chmod +x ~/Downloads/nodetonet-agent-macos-x64 - Başlatmayı deneyin:
~/Downloads/nodetonet-agent-macos-x64. macOS "geliştirici doğrulanamadığından açılamaz" hatasıyla reddedecektir. - Finder'da binary'yi bulun, sağ tıklayıp Aç'ı seçin. Bir Aç butonu içeren iletişim kutusu açılır — tıklayın. Bu, binary'yi Gatekeeper veritabanına whitelist'e ekler; sonraki açılışlarda ek adım gerekmez.
- İstendiğinde token'ınızı yapıştırın. Yapılandırma
~/Library/Application Support/Nodetonet/config.jsoniçine kaydedilir.
Daha hızlı Gatekeeper atlatma: açmadan önce Terminal'de bir kez xattr -d com.apple.quarantine ~/Downloads/nodetonet-agent-macos-x64 çalıştırın. Uyarıyı tetikleyen şey karantina genişletilmiş özniteliğidir; kaldırmak binary'nin diyalog olmadan normal şekilde açılmasını sağlar.
macOS'ta oturum açınca otomatik çalıştırma
Önerilen yaklaşım bir launchd plist dosyasıdır. ~/Library/LaunchAgents/com.nodetonet.agent.plist dosyasını binary'ye işaret eden bir ProgramArguments anahtarı ve RunAtLoad true olarak oluşturun, ardından launchctl load ~/Library/LaunchAgents/com.nodetonet.agent.plist çalıştırın. Agent her oturum açışta otomatik başlayacak ve çıkarsa yeniden başlatılacaktır.
3. Linux
Linux en esnek platformdur. İndirme sayfasından nodetonet-agent-linux-x64 dosyasını alın. Binary statik olarak linklenmiştir — glibc versiyon karmaşası yok, eksik paylaşılan kütüphane yok, Docker sarmalayıcısına gerek yok. Ubuntu 20.04, Debian, CentOS, Alpine ve 64-bit çekirdeğe sahip hemen her sistemde çalışır.
curl -L https://nodetonet.com/agent/nodetonet-agent-linux-x64 -o /usr/local/bin/nodetonet-agent
chmod +x /usr/local/bin/nodetonet-agent
nodetonet-agent --token YOUR_TOKEN_HEREAgent ön planda çalışır ve stdout'a log basar. Durdurmak için Ctrl+C'ye basın. İlk --token çağrısından sonra yapılandırma ~/.config/nodetonet/config.json içine kaydedilir; sonraki çalıştırmalar bayrak gerektirmez.
4. systemd servisi olarak çalıştırma (Linux)
Başsız veya gözetimsiz sunucular için agent'ı uygun bir systemd birimi olarak çalıştırmak şiddetle tavsiye edilir — hem önyüklemede başlar hem de çökmede otomatik yeniden başlatılır.
/etc/systemd/system/nodetonet-agent.service servis dosyasını oluşturun:
[Unit]
Description=Nodetonet agent
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=/usr/local/bin/nodetonet-agent
Restart=always
RestartSec=5
User=nodetonet
Group=nodetonet
MemoryMax=256M
TasksMax=128
[Install]
WantedBy=multi-user.targetArdından ayrı bir sistem kullanıcısı oluşturun, token yapılandırmasını o kullanıcı altına yazın ve servisi etkinleştirin:
useradd --system --create-home --shell /usr/sbin/nologin nodetonet
sudo -u nodetonet nodetonet-agent --token YOUR_TOKEN_HERE
# Config dosyası yazıldıktan sonra Ctrl+C'ye basın
systemctl daemon-reload
systemctl enable --now nodetonet-agent
systemctl status nodetonet-agentnodetonet kullanıcısı olarak yapılan ilk çalıştırma token'ı o kullanıcının config dizinine yazar; bundan sonra systemd yeniden başlatmaları otomatik yönetir. Logları journalctl -u nodetonet-agent -f ile izleyin.
Platforma göre hızlı karşılaştırma
| Platform | Binary adı | Config yolu | Otomatik başlatma yöntemi |
|---|---|---|---|
| Windows | nodetonet-agent-windows-x64.exe | %APPDATA%Nodetonetconfig.json | Başlangıç klasörü veya Zamanlanmış Görev |
| macOS | nodetonet-agent-macos-x64 | ~/Library/Application Support/Nodetonet/config.json | launchd plist |
| Linux | nodetonet-agent-linux-x64 | ~/.config/nodetonet/config.json | systemd birimi |
5. Bağlantıyı doğrulama
Agent'ı başlattıktan sonra panelde /tokens sayfasını açın. Token satırınız birkaç saniye içinde ONLINE'a dönmeli; cihaz sütununda işletim sistemi ve ana bilgisayar adı meta verisi görünmelidir. Trafiğin aktığını ve çıkış IP'sinin makinenin bağlantısıyla eşleştiğini doğrulamak için ücretsiz IP adresim nedir aracımızı açın ve yeni eşleştirilen token üzerinden bir istek gönderin.
Token 30 saniyeden fazla OFFLINE kalırsa:
vds.nodetonet.com'a 443 portunda giden TCP bağlantısının bir güvenlik duvarı veya kurumsal proxy tarafından engellenmediğini kontrol edin.- Agent'ın stdout çıktısına (Linux'ta systemd journal) bakın — her yeniden bağlanma girişimini ve hata nedenini loglar.
- Token değerinin doğru olduğunu onaylayın; tek bir yanlış karakter kalıcı kimlik doğrulama hatasına neden olacaktır.
Heartbeat zamanlaması, zaman aşımı mantığı ve ONLINE/OFFLINE durum makinesinin gerçekte ne anlama geldiği hakkında daha derin bir inceleme için Cihaz sağlığı — ONLINE aslında ne demek yazısını okuyun.
Kurulumdan sonra ne yapmalı
- Nodetonet nasıl kullanılır — ilk girişten canlı proxy trafiğine uçtan uca kurulum.
- Token grupları: cihaz havuzları oluşturma — bu agent'ı rotating proxy istekleri için round-robin havuzuna ekleyin.
- Windows'ta PC agent'ı detaylı — servis yapılandırması, log dosyaları ve performans ayarı.
- Proxy istemcileri ve müşteri başı kimlik doğrulama — her son kullanıcıya kota ve iş parçacığı limitleriyle ayrı kimlik bilgileri verin.
- Kimlik doğrulamalı SOCKS5 — yeni eşleştirilen cihazda SOCKS5'i yapılandırın.
- Henüz yapmadıysanız ücretsiz hesap açın.