İçeriğe geç
Localtonet Localtonet Panel

Localtonet'i macOS'a kurun

Bu sayfa için yardım al
Bu sayfada 9 bölüm
  1. Başlamadan önce
  2. Homebrew ile kurulum
  3. Localtonet tap'ini ekleyin ve kurun
  4. Kurulumu kontrol edin
  5. El ile kurulum
  6. İndirin ve çıkarın
  7. İsteğe bağlı: PATH içine taşıyın
  8. İstemciyi başlatın
  9. Token'ınızla başlatın
  10. Oturumu kontrol edin
  11. launchd hizmeti olarak çalıştırma
  12. Hizmeti kurun
  13. Çalıştığını doğrulayın
  14. Kurulumun oluşturduğu öğeler
  15. Hizmet komutları
  16. Yükseltme
  17. Kaldırma
  18. Sorun giderme
  19. İlgili sayfalar

macOS'ta Localtonet istemcisi, Intel ve Apple Silicon Mac'ler için bir konsol programıdır. Homebrew ile veya bir ZIP arşivinden kurun, AuthToken'ınızla başlatın ve her açılışta başlamasını istiyorsanız launchd hizmeti olarak kurun.

Başlamadan önce #

  • Bir Localtonet hesabı. Hesabınız yoksa ücretsiz oluşturun.
  • AuthToken'ınız. Panel'deki AuthToken kartında Kopyala düğmesini seçin veya Token'larım sayfasından bir token kopyalayın.
  • Homebrew ile kurulum için: Homebrew.
  • launchd hizmeti için: sudo kullanabilen bir hesap.

Homebrew ile kurulum #

  1. Localtonet tap'ini ekleyin ve kurun #

    Tap, Homebrew'a üçüncü taraf bir depo ekler; böylece o depodaki formülleri kurabilir ve güncelleyebilirsiniz.

    Terminal
    brew tap localtonet/tap
    brew install localtonet
  2. Kurulumu kontrol edin #

    Terminal
    localtonet --version

    Komut istemcinin sürümünü yazdırır.

El ile kurulum #

Doğrudan indirmeyi tercih ediyorsanız Mac'inize uygun arşivi alın. ZIP tek bir dosya içerir: localtonet.

MacArşiv
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. İndirin ve çıkarın #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip
    unzip localtonet-osx-64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. İsteğe bağlı: PATH içine taşıyın #

    Bu adım olmadan istemciyi yoluyla, ~/localtonet/localtonet, başlatırsınız. Bu adımdan sonra herhangi bir klasörde localtonet yazabilirsiniz.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

İstemciyi başlatın #

  1. Token'ınızla başlatın #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    İstemci token'ı yerel olarak saklar. Bir sonraki sefer yalnızca localtonet ile başlatabilirsiniz. Saklanmış token olmadan başlatırsanız Please Enter AuthToken or PIN sorusunu sorar.

  2. Oturumu kontrol edin #

    Terminal, çalışan her tünel için bir satır içeren bir tablonun üstünde Session Status: Connected gösterir: IP/Url, Protocol, Client IP, Client Port, Ping ve Status. Panelde bir tünel başlatana kadar tablo boştur; Hızlı başlangıç sayfasına bakın.

    İstemciyi durdurmak için Ctrl + C tuşlarına basın. Saklanan token'ı silip çıkmak için F12 tuşuna basın.

launchd hizmeti olarak çalıştırma #

Hizmet, Localtonet'i her açılışta başlatır, oturumu kapattıktan sonra da çalışır durumda tutar ve açık bir terminal gerektirmez. Hizmet komutları root yetkisi ister; bu yüzden onları sudo ile çalıştırın.

  1. Hizmeti kurun #

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

    Komut, bu token için sistem genelinde bir launchd işi kaydeder ve hemen başlatır. İşin adını yanıt olarak verir:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX>, token'ınızın ilk 9 karakteridir. Her token'ın kendi işi vardır; bu yüzden diğer hizmet komutlarının onu bulması için aynı --authtoken değerine ihtiyacı vardır.

  2. Çalıştığını doğrulayın #

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    Çalışan bir iş [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running yanıtını verir. Panelde token, Token'larım sayfasında Çevrimiçi görünür.

Kurulumun oluşturduğu öğeler #

ÖğeKonum
launchd iş tanımı/Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist
İstemcinin standart çıktısı/var/log/Localtonet_<TOKEN_PREFIX>.out.log
İstemcinin hata çıktısı/var/log/Localtonet_<TOKEN_PREFIX>.err.log

İş Mac açıldığında başlar ve istemci bir hatayla çıktığında launchd onu yeniden başlatır. İş, hizmeti kurduğunuz andaki yolundaki localtonet dosyasını, token'ı bağımsız değişkenlerinin bir parçası olarak çalıştırır.

Hizmet komutları #

Her komutu sudo ile çalıştırın ve --authtoken <YOUR_TOKEN> ekleyin.

KomutNe yapar
--install-serviceİş tanımını yazar, yükler ve istemciyi başlatır.
--start-serviceİşi başlatır. Zaten çalışıyorsa launchd onu yeniden başlatır.
--stop-serviceİstemciyi durdurur. İş kurulu kalır ve bir sonraki açılışta yeniden başlar.
--status-serviceDurumu yazdırır; örneğin Running, Stopped, NotFound veya Error.
--remove-serviceİşi durdurur, yüklemesini kaldırır ve iş tanımını siler.

Hizmet, --install-service ile birlikte verdiğiniz seçeneklerle kurulur. Seçenekler CLI başvurusunda listelenir.

Yükseltme #

  • Homebrew: brew upgrade localtonet
  • El ile kurulum: güncel arşivi indirin ve localtonet dosyasını değiştirin.

Localtonet hizmet olarak çalışıyorsa Homebrew yükseltmesinden sonra hizmeti yeniden kurun: önce kaldırın, ardından aynı token ile kurun. Kurulum hizmeti ayrıca başlatır.

Terminal
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>

İş, kurulduğu dosyanın yolunu korur. İstemciyi aynı yerde bırakan bir el ile yükseltmeden sonra hizmeti --stop-service ile durdurmak, dosyayı değiştirmek ve hizmeti --start-service ile başlatmak yeterlidir. Bu komutlar Hizmet olarak çalıştırma sayfasında anlatılır.

Kaldırma #

  1. Hizmeti kurduysanız kaldırın: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Saklanan token'ı silmek için istemciyi başlatın ve F12 tuşuna basın.
  3. İstemciyi kaldırın. Homebrew ile: brew uninstall localtonet; tap'i kaldırmak için brew untap localtonet/tap. El ile kurulumdan sonra localtonet dosyasını silin.

Sorun giderme #

Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.

Komut root yetkisi olmadan çalıştırıldı. Onu sudo ile yineleyin.

sudo: localtonet: command not found

sudo, istemciyi kendi arama yolunda bulamıyor. Bunun yerine tam yolu verin. command -v localtonet onu yazdırır; örneğin:

Bash
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>

PATH adımı olmadan el ile kurulumdan sonra yol ~/localtonet/localtonet olur.

Install failed: Plist already exists for 'Localtonet_…'

Bu token için bir hizmet zaten kurulu. Onu --status-service ile kontrol edin. Yeniden kurmak için önce --remove-service komutunu çalıştırın.

Hizmet kurulu ama token Çevrimdışı kalıyor

İşin hata günlüğünü, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, okuyun ve localtonet dosyasının hizmeti kurduğunuz andaki yolunda hâlâ var olduğunu kontrol edin.

Wrong Token!

İstemci, Token'larım sayfasındaki 33 karakterlik AuthToken'ı veya süresi dolmamış 6 haneli bir PIN'i bekler. Token'ı yeniden kopyalayın ve istemde girin.

This token is used in another localtonet application!

Bu Mac'te başka bir Localtonet istemcisi aynı token ile zaten çalışıyor. Onu kapatın veya bunu farklı bir token ile başlatın. Token başına bir çalışan istemci kullanın.

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

Destek