Memasang Localtonet di macOS
Di halaman ini 9 bagian
- Sebelum memulai
- Memasang dengan Homebrew
- Tambahkan tap Localtonet dan pasang
- Periksa pemasangan
- Memasang secara manual
- Mengunduh dan mengekstrak
- Opsional: pindahkan ke PATH Anda
- Jalankan klien
- Menjalankannya dengan token Anda
- Memeriksa sesi
- Menjalankan sebagai layanan launchd
- Memasang layanan
- Memeriksa bahwa layanan berjalan
- Yang dibuat oleh pemasangan
- Perintah layanan
- Upgrade
- Menghapus pemasangan
- Pemecahan masalah
- Halaman terkait
Di macOS, klien Localtonet adalah program konsol untuk Mac Intel dan Apple Silicon. Pasang dengan Homebrew atau dari arsip ZIP, jalankan dengan AuthToken Anda, dan pasang sebagai layanan launchd jika ingin berjalan di setiap boot.
Sebelum memulai #
- Akun Localtonet. Buat gratis jika Anda belum punya.
- AuthToken Anda. Pilih Salin pada kartu AuthToken di Dasbor, atau salin token dari Token Saya.
- Untuk pemasangan dengan Homebrew: Homebrew.
- Untuk layanan launchd: akun yang dapat memakai
sudo.
Memasang dengan Homebrew #
-
Tambahkan tap Localtonet dan pasang #
Tap menambahkan repositori pihak ketiga ke Homebrew, sehingga Anda dapat memasang dan memperbarui formula darinya.
Terminalbrew tap localtonet/tap brew install localtonet -
Periksa pemasangan #
Terminallocaltonet --versionPerintah ini menampilkan versi klien.
Memasang secara manual #
Jika Anda lebih suka mengunduh langsung, ambil arsip untuk Mac Anda. ZIP berisi satu file, localtonet.
| Mac | Arsip |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Mengunduh dan mengekstrak #
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 -
Opsional: pindahkan ke PATH Anda #
Tanpa langkah ini Anda menjalankan klien dengan path-nya,
~/localtonet/localtonet. Setelahnya Anda dapat mengetiklocaltonetdi folder mana pun.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Jalankan klien #
-
Menjalankannya dengan token Anda #
Terminallocaltonet --authtoken <YOUR_TOKEN>Klien menyimpan token secara lokal. Lain kali Anda dapat menjalankannya cukup dengan
localtonet. Jika Anda menjalankannya tanpa token tersimpan, klien menanyakanPlease Enter AuthToken or PIN. -
Memeriksa sesi #
Terminal menampilkan
Session Status: Connecteddi atas tabel dengan satu baris per tunnel yang berjalan:IP/Url,Protocol,Client IP,Client Port,Ping, danStatus. Tabel kosong sampai Anda menjalankan tunnel di dasbor, lihat Panduan cepat.Tekan Ctrl + C untuk menghentikan klien. Tekan F12 untuk menghapus token tersimpan dan keluar.
Menjalankan sebagai layanan launchd #
Layanan menjalankan Localtonet di setiap boot, tetap berjalan setelah Anda logout, dan tidak memerlukan terminal yang terbuka. Perintah layanan memerlukan root, jadi jalankan dengan sudo.
-
Memasang layanan #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>Perintah ini mendaftarkan job launchd tingkat sistem untuk token ini dan langsung menjalankannya. Perintah menjawab dengan nama job:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>adalah 9 karakter pertama token Anda. Setiap token memiliki job-nya sendiri, jadi perintah layanan lainnya memerlukan--authtokenyang sama untuk menemukannya. -
Memeriksa bahwa layanan berjalan #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Job yang berjalan menjawab
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Di dasbor, token menampilkan Online di bawah Token Saya.
Yang dibuat oleh pemasangan #
| Item | Lokasi |
|---|---|
| Definisi job launchd | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| Output standar klien | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| Output galat klien | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
Job dimulai saat Mac boot, dan launchd menjalankan klien lagi saat klien keluar dengan galat. Job menjalankan file localtonet dari path yang dimilikinya saat Anda memasang layanan, dengan token sebagai bagian dari argumennya.
Perintah layanan #
Jalankan setiap perintah dengan sudo dan tambahkan --authtoken <YOUR_TOKEN>.
| Perintah | Fungsinya |
|---|---|
--install-service | Menulis definisi job, memuatnya, dan menjalankan klien. |
--start-service | Menjalankan job. Jika sudah berjalan, launchd memulainya ulang. |
--stop-service | Menghentikan klien. Job tetap terpasang dan berjalan lagi pada boot berikutnya. |
--status-service | Menampilkan status, misalnya Running, Stopped, NotFound, atau Error. |
--remove-service | Menghentikan job, membongkarnya, dan menghapus definisi job. |
Layanan dipasang dengan opsi yang Anda berikan bersama --install-service. Opsinya tercantum di Referensi CLI.
Upgrade #
- Homebrew:
brew upgrade localtonet - Pemasangan manual: unduh arsip terbaru dan ganti file
localtonet.
Jika Localtonet berjalan sebagai layanan, pasang layanan lagi setelah upgrade Homebrew: hapus, lalu pasang dengan token yang sama. Pemasangan juga menjalankannya.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Job mempertahankan path file tempat ia dipasang. Setelah upgrade manual yang membiarkan klien di tempat yang sama, cukup hentikan layanan dengan --stop-service, ganti file, lalu jalankan layanan dengan --start-service. Menjalankan sebagai layanan menjelaskan perintah-perintah ini.
Menghapus pemasangan #
- Jika Anda memasang layanan, hapus:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Untuk menghapus token tersimpan, jalankan klien dan tekan F12.
- Hapus klien. Dengan Homebrew:
brew uninstall localtonet, danbrew untap localtonet/tapuntuk menghapus tap. Setelah pemasangan manual, hapus filelocaltonet.
Pemecahan masalah #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
Perintah dijalankan tanpa root. Ulangi dengan sudo.
sudo: localtonet: command not found
sudo tidak menemukan klien di path pencariannya sendiri. Berikan path lengkap. command -v localtonet menampilkannya, misalnya:
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>Setelah pemasangan manual tanpa langkah PATH, path-nya adalah ~/localtonet/localtonet.
Install failed: Plist already exists for 'Localtonet_…'
Layanan untuk token ini sudah terpasang. Periksa dengan --status-service. Untuk memasangnya lagi, jalankan --remove-service terlebih dahulu.
Layanan sudah terpasang tetapi token tetap Offline
Baca log galat job, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, dan pastikan file localtonet masih ada di path yang dimilikinya saat Anda memasang layanan.
Wrong Token!
Klien mengharapkan AuthToken 33 karakter dari Token Saya, atau PIN 6 digit yang belum kedaluwarsa. Salin token lagi dan masukkan pada prompt.
This token is used in another localtonet application!
Klien Localtonet lain di Mac ini sudah berjalan dengan token yang sama. Tutup, atau jalankan yang ini dengan token berbeda. Gunakan satu klien yang berjalan per token.