İçeriğe geç
Localtonet Localtonet Panel

Localtonet'i hizmet olarak çalıştırma

Bu sayfa için yardım al
Bu sayfada 8 bölüm
  1. Başlamadan önce
  2. Hizmeti kurun
  3. Windows
  4. Hizmet adı
  5. Hizmet ne çalıştırır
  6. Hizmeti yönetme
  7. Windows
  8. Hizmetin nerede kayıtlı olduğu ve günlüklerinin nerede olduğu
  9. Token'ı değiştirme
  10. Bilmeniz gerekenler
  11. Sorun giderme
  12. İlgili sayfalar

Localtonet istemcisini arka plan hizmeti olarak kurun; böylece cihazla birlikte başlar, oturumu kapattıktan sonra da çalışmaya devam eder ve açık bir terminal gerektirmez. Tek bir komut onu Windows hizmetlerine, macOS'ta launchd'ye veya Linux'ta systemd'ye kaydeder.

Başlamadan önce #

  • Konsol istemcisi cihazda kurulu: Windows, macOS veya Linux.
  • Token'larım sayfasından bu cihaz için bir AuthToken.
  • Yönetici hakları: Windows'ta Yönetici olarak çalıştır ile açılmış bir terminal, macOS ve Linux'ta sudo.
  • Linux'ta systemd kullanan bir dağıtım. Termux desteklenmez; orada Android uygulamasını kullanın.

DEB veya RPM paketinden, OpenWrt'de ya da Docker'da mı kurdunuz? Bunların açılışta başlamak için kendi yolu vardır. Bu sayfa yerine DEB ve RPM paketleri, OpenWrt ve Docker sayfalarına bakın.

Hizmeti kurun #

İstemciyi --install-service ve token'ınızla bir kez çalıştırın. <YOUR_TOKEN> yerine AuthToken'ınızı yazın. Bu komuta her zaman --authtoken ekleyin: hizmet, kurulduğu token ile bağlanır.

Windows #

localtonet dosyasını içeren klasörde Komut İstemi veya PowerShell'i Yönetici olarak açın, ardından şunu çalıştırın:

Komut İstemi veya PowerShell (Yönetici)
localtonet --install-service --authtoken <YOUR_TOKEN>

İstemci, otomatik başlayan bir Windows hizmeti oluşturur ve başlatır. Hizmet services.msc içinde Localtonet Service açıklamasıyla görünür. Hizmet başarısız olursa Windows onu bir dakika sonra yeniden başlatır.

macOS

Bash
sudo localtonet --install-service --authtoken <YOUR_TOKEN>

İstemci, /Library/LaunchDaemons/<SERVICE_NAME>.plist konumuna bir launchd işi yazar, yükler ve başlatır. İş açılışta başlar ve bir hatayla çıkarsa launchd onu yeniden başlatır.

Linux

Bash
sudo localtonet --install-service --authtoken <YOUR_TOKEN>

İstemci, /etc/systemd/system/<SERVICE_NAME>.service konumuna bir systemd birimi yazar, etkinleştirir ve başlatır. Birim açılışta başlar ve systemd onu bir hatadan beş saniye sonra yeniden başlatır.

sudo, localtonet dosyasını bulamazsa onu yoluyla çalıştırın, örneğin dosyayı içeren klasörden sudo ./localtonet.

Başarılı olduğunda istemci hizmetin adını yazdırır:

Çıktı
[CLI] Installed service 'Localtonet_AbCdEfGhI'

Kurulum hizmeti de başlatır, bu nedenle ayrı bir başlatma komutuna gerek yoktur. Artık panelde bu token için tünel oluşturabilir ve başlatabilirsiniz.

Hizmet adı #

Hizmetin adı, Localtonet_ ve ardından token'ın ilk dokuz karakteridir, örneğin Localtonet_AbCdEfGhI. Bu sayfa onu <SERVICE_NAME> olarak yazar. Ad token'dan geldiği için aynı cihaza token başına bir hizmet kurabilirsiniz ve her yönetim komutunun hizmetini bulması için aynı token'a ihtiyacı vardır.

Hizmet ne çalıştırır #

Hizmet, aynı localtonet dosyasını aynı konumdan, kurulum komutunda verdiğiniz seçeneklerle başlatır. Bundan iki sonuç çıkar:

  • Dosyayı taşımayın veya silmeyin. Hizmet tanımı dosyanın tam yolunu içerir. Linux'ta dosya /root içindeyse kurucu onu /usr/local/lib/<SERVICE_NAME>/ konumuna kopyalar ve hizmet bu kopyayı çalıştırır.
  • Diğer seçenekler korunur. Kurulum komutundaki --net ve --ip ya da --proxy env gibi seçenekler hizmette saklanır ve her başlatmada kullanılır. Bkz. CLI başvurusu.

Hizmeti yönetme #

Bu seçeneklerden biriyle aynı token'ı kullanın. macOS ve Linux'ta başına sudo koyun. Windows'ta durum dışındaki her şey için Yönetici terminali kullanın.

KomutNe yaparBaşarılı olduğunda çıktı
localtonet --status-service --authtoken <YOUR_TOKEN>Hizmetin durumunu gösterir.[CLI] Service '<SERVICE_NAME>' status: Running
localtonet --stop-service --authtoken <YOUR_TOKEN>Hizmeti durdurur. Tünelleri çevrimdışı olur. Bir sonraki açılışta yeniden başlar.[CLI] Stopped service '<SERVICE_NAME>'.
localtonet --start-service --authtoken <YOUR_TOKEN>Durdurulmuş bir hizmeti başlatır.[CLI] Started service '<SERVICE_NAME>'.
localtonet --remove-service --authtoken <YOUR_TOKEN>Hizmeti durdurur ve kaydını kaldırır. localtonet dosyasının kendisi kalır.[CLI] Removed service '<SERVICE_NAME>'.

Durum şu değerlerden biridir:

DurumAnlamı
RunningHizmet çalışıyor.
StoppedHizmet kurulu ama çalışmıyor.
InstallingHizmet başlıyor.
NotFoundBu token için kurulu bir hizmet yok.
PausedYalnızca Windows: hizmet duraklatıldı.
ErrorHizmet başarısız oldu veya durumu okunamadı.
UnknownHizmet yöneticisi, istemcinin tanımadığı bir durum döndürdü.

Hizmet adıyla işletim sisteminin araçlarını da kullanabilirsiniz:

Windows #

services.msc dosyasını açın ve <SERVICE_NAME> hizmetini bulun veya Yönetici terminalinde sc kullanın:

Komut İstemi (Yönetici)
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>

macOS

Bash
sudo launchctl print system/<SERVICE_NAME>

Linux

Bash
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>

Hizmetin nerede kayıtlı olduğu ve günlüklerinin nerede olduğu #

SistemKayıtGünlükler
WindowsAdı <SERVICE_NAME> olan, başlangıç türü otomatik olan ve LocalSystem hesabı altında çalışan bir Windows hizmeti.Hizmetin konsol penceresi yoktur ve kurucu bir günlük dosyası ayarlamaz. Hizmetin durumunu, cihazı ve tünellerini panelde kontrol edin.
macOS/Library/LaunchDaemons/<SERVICE_NAME>.plist, sistem genelinde bir launchd işi./var/log/<SERVICE_NAME>.out.log ve /var/log/<SERVICE_NAME>.err.log
Linux/etc/systemd/system/<SERVICE_NAME>.service, multi-user.target için etkinleştirilmiş.systemd günlüğü: journalctl -u <SERVICE_NAME> -f

Hizmet, istemcinin bir terminalde gösterdiği tünel tablosunu yazdırmaz. Cihazınızın ve tünellerinizin durumu için paneli kullanın.

Token'ı değiştirme #

Bir cihazın token'ını değiştirmek için hizmeti eski token ile kaldırın ve yenisiyle yeniden kurun:

Bash
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>

Bilmeniz gerekenler #

  • Token başına bir istemci. Hizmet çalışırken aynı token ile, bu cihazda veya başka bir cihazda ikinci bir Localtonet istemcisi başlatmayın. Bir token ile bağlanan ikinci istemci, birincinin bağlantısını keser.
  • İstemciyi güncelleme. Hizmet, tanımının işaret ettiği dosyayı çalıştırmaya devam eder. Hizmeti durdurun, o dosyayı yeni sürümle değiştirin ve hizmeti yeniden başlatın.
  • Proxy parolaları saklanmaz. Kurulum komutu, parola içeren bir proxy URL'sini ve --proxy-user seçeneğini reddeder. --proxy env ile kurun ve proxy değişkenlerini hizmetin ortamında ayarlayın.
  • Cihaz Terminali. Cihaz Localtonet'i hizmet olarak çalıştırıyorsa hizmetin sonucu kullanabilmesi için localtonet --terminal enable komutunu Yönetici terminalinden veya sudo ile çalıştırın. Bkz. Cihaz Terminali.

Sorun giderme #

MesajNeden ve çözüm
[CLI] Install failed: '…' requires elevated (admin/root) privileges.Komut yönetici hakları olmadan çalıştırıldı. Terminali Windows'ta Yönetici olarak açın veya macOS ve Linux'ta sudo kullanın. Windows ve Linux'ta başlatma, durdurma ve kaldırma için de aynı mesaj görünür.
[CLI] Install failed: ve ardından Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux) veya Plist already exists for … (macOS)Bu token için bir hizmet zaten kurulu. Başlatmak için --start-service kullanın veya yeniden kurmak istiyorsanız önce --remove-service çalıştırın.
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment.Kurulum komutu --proxy-user veya parola içeren bir proxy URL'si içeriyordu. Bunun yerine --proxy env kullanın.
Kurulumdan hemen sonra Windows'ta [CLI] Start failed: …Hizmet zaten çalışıyor, çünkü kurulum onu başlatır. --status-service ile kontrol edin.
Durum NotFoundVerdiğiniz token için hizmet yok. Hizmeti kurduğunuz token olduğundan emin olun.
Durum Running ama cihaz panelde çevrimdışıToken'ı kontrol edin: Token'larım sayfasından yeniden kopyalayın, hizmeti kaldırın ve yeniden kurun. Başka hiçbir istemcinin aynı token'ı kullanmadığından da emin olun.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek