Localtonet'i macOS'a kurun
Bu sayfada 9 bölüm
- Başlamadan önce
- Homebrew ile kurulum
- Localtonet tap'ini ekleyin ve kurun
- Kurulumu kontrol edin
- El ile kurulum
- İndirin ve çıkarın
- İsteğe bağlı: PATH içine taşıyın
- İstemciyi başlatın
- Token'ınızla başlatın
- Oturumu kontrol edin
- launchd hizmeti olarak çalıştırma
- Hizmeti kurun
- Çalıştığını doğrulayın
- Kurulumun oluşturduğu öğeler
- Hizmet komutları
- Yükseltme
- Kaldırma
- Sorun giderme
- İ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:
sudokullanabilen bir hesap.
Homebrew ile kurulum #
-
Localtonet tap'ini ekleyin ve kurun #
Tap, Homebrew'a üçüncü taraf bir depo ekler; böylece o depodaki formülleri kurabilir ve güncelleyebilirsiniz.
Terminalbrew tap localtonet/tap brew install localtonet -
Kurulumu kontrol edin #
Terminallocaltonet --versionKomut 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.
| Mac | Arşiv |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
İndirin ve çıkarın #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -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 -
İ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ördelocaltonetyazabilirsiniz.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
İstemciyi başlatın #
-
Token'ınızla başlatın #
Terminallocaltonet --authtoken <YOUR_TOKEN>İstemci token'ı yerel olarak saklar. Bir sonraki sefer yalnızca
localtonetile başlatabilirsiniz. Saklanmış token olmadan başlatırsanızPlease Enter AuthToken or PINsorusunu sorar. -
Oturumu kontrol edin #
Terminal, çalışan her tünel için bir satır içeren bir tablonun üstünde
Session Status: Connectedgösterir:IP/Url,Protocol,Client IP,Client Port,PingveStatus. 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.
-
Hizmeti kurun #
Terminalsudo 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ı--authtokendeğerine ihtiyacı vardır. -
Çalıştığını doğrulayın #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Çalışan bir iş
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Runningyanıtını verir. Panelde token, Token'larım sayfasında Çevrimiçi görünür.
Kurulumun oluşturduğu öğeler #
| Öğe | Konum |
|---|---|
| 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.
| Komut | Ne 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-service | Durumu 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
localtonetdosyası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.
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 #
- Hizmeti kurduysanız kaldırın:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Saklanan token'ı silmek için istemciyi başlatın ve F12 tuşuna basın.
- İstemciyi kaldırın. Homebrew ile:
brew uninstall localtonet; tap'i kaldırmak içinbrew untap localtonet/tap. El ile kurulumdan sonralocaltonetdosyası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:
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.