Langsung ke konten
Localtonet Localtonet Dasbor

Memasang Localtonet di macOS

Bantuan untuk halaman ini
Di halaman ini 9 bagian
  1. Sebelum memulai
  2. Memasang dengan Homebrew
  3. Tambahkan tap Localtonet dan pasang
  4. Periksa pemasangan
  5. Memasang secara manual
  6. Mengunduh dan mengekstrak
  7. Opsional: pindahkan ke PATH Anda
  8. Jalankan klien
  9. Menjalankannya dengan token Anda
  10. Memeriksa sesi
  11. Menjalankan sebagai layanan launchd
  12. Memasang layanan
  13. Memeriksa bahwa layanan berjalan
  14. Yang dibuat oleh pemasangan
  15. Perintah layanan
  16. Upgrade
  17. Menghapus pemasangan
  18. Pemecahan masalah
  19. 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 #

  1. Tambahkan tap Localtonet dan pasang #

    Tap menambahkan repositori pihak ketiga ke Homebrew, sehingga Anda dapat memasang dan memperbarui formula darinya.

    Terminal
    brew tap localtonet/tap
    brew install localtonet
  2. Periksa pemasangan #

    Terminal
    localtonet --version

    Perintah ini menampilkan versi klien.

Memasang secara manual #

Jika Anda lebih suka mengunduh langsung, ambil arsip untuk Mac Anda. ZIP berisi satu file, localtonet.

MacArsip
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. Mengunduh dan mengekstrak #

    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. Opsional: pindahkan ke PATH Anda #

    Tanpa langkah ini Anda menjalankan klien dengan path-nya, ~/localtonet/localtonet. Setelahnya Anda dapat mengetik localtonet di folder mana pun.

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

Jalankan klien #

  1. Menjalankannya dengan token Anda #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    Klien menyimpan token secara lokal. Lain kali Anda dapat menjalankannya cukup dengan localtonet. Jika Anda menjalankannya tanpa token tersimpan, klien menanyakan Please Enter AuthToken or PIN.

  2. Memeriksa sesi #

    Terminal menampilkan Session Status: Connected di atas tabel dengan satu baris per tunnel yang berjalan: IP/Url, Protocol, Client IP, Client Port, Ping, dan Status. 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.

  1. Memasang layanan #

    Terminal
    sudo 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 --authtoken yang sama untuk menemukannya.

  2. Memeriksa bahwa layanan berjalan #

    Terminal
    sudo 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 #

ItemLokasi
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>.

PerintahFungsinya
--install-serviceMenulis definisi job, memuatnya, dan menjalankan klien.
--start-serviceMenjalankan job. Jika sudah berjalan, launchd memulainya ulang.
--stop-serviceMenghentikan klien. Job tetap terpasang dan berjalan lagi pada boot berikutnya.
--status-serviceMenampilkan status, misalnya Running, Stopped, NotFound, atau Error.
--remove-serviceMenghentikan 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.

Terminal
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 #

  1. Jika Anda memasang layanan, hapus: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Untuk menghapus token tersimpan, jalankan klien dan tekan F12.
  3. Hapus klien. Dengan Homebrew: brew uninstall localtonet, dan brew untap localtonet/tap untuk menghapus tap. Setelah pemasangan manual, hapus file localtonet.

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:

Bash
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.

Dukungan