macOS에 Localtonet 설치하기
이 페이지의 내용 섹션 9개
macOS에서 Localtonet 클라이언트는 Intel 및 Apple Silicon Mac용 콘솔 프로그램입니다. Homebrew 또는 ZIP 아카이브로 설치하고 AuthToken으로 시작하며, 부팅할 때마다 시작되어야 한다면 launchd 서비스로 설치하세요.
시작하기 전에 #
- Localtonet 계정. 없다면 무료로 만드세요.
- AuthToken. 대시보드의 AuthToken 카드에서 복사를 선택하거나 내 토큰에서 토큰을 복사하세요.
- Homebrew로 설치하려면: Homebrew.
- launchd 서비스를 쓰려면:
sudo를 사용할 수 있는 계정.
Homebrew로 설치 #
-
Localtonet tap 추가 및 설치 #
tap은 Homebrew에 서드파티 저장소를 추가하여 그곳의 formula를 설치하고 업데이트할 수 있게 합니다.
터미널brew tap localtonet/tap brew install localtonet -
설치 확인하기 #
터미널localtonet --version명령이 클라이언트의 버전을 출력합니다.
수동 설치 #
직접 다운로드하려면 내 Mac에 맞는 아카이브를 받으세요. ZIP에는 localtonet 파일 하나가 들어 있습니다.
| Mac | 아카이브 |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
다운로드하고 압축 해제하기 #
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 -
선택 사항: PATH로 옮기기 #
이 단계를 건너뛰면 클라이언트를 경로
~/localtonet/localtonet로 시작해야 합니다. 이 단계를 하면 어느 폴더에서든localtonet을 입력할 수 있습니다.터미널sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
클라이언트 시작하기 #
-
토큰으로 시작하기 #
터미널localtonet --authtoken <YOUR_TOKEN>클라이언트는 토큰을 로컬에 저장합니다. 다음부터는
localtonet만으로 시작할 수 있습니다. 저장된 토큰 없이 시작하면Please Enter AuthToken or PIN이라고 묻습니다. -
세션 확인하기 #
터미널에
Session Status: Connected가 표시되고, 그 아래 실행 중인 터널마다 한 행씩 있는 표가 나타납니다. 열은IP/Url,Protocol,Client IP,Client Port,Ping,Status입니다. 대시보드에서 터널을 시작하기 전까지 표는 비어 있습니다. 빠른 시작을 참고하세요.클라이언트를 중지하려면 Ctrl + C를 누르세요. 저장된 토큰을 삭제하고 종료하려면 F12를 누르세요.
launchd 서비스로 실행 #
서비스는 부팅할 때마다 Localtonet을 시작하고, 로그아웃한 뒤에도 계속 실행하며, 열려 있는 터미널이 필요하지 않습니다. 서비스 명령에는 root 권한이 필요하므로 sudo로 실행하세요.
-
서비스 설치 #
터미널sudo localtonet --install-service --authtoken <YOUR_TOKEN>이 명령은 해당 토큰용 시스템 전체 launchd 작업을 등록하고 즉시 시작합니다. 작업 이름을 응답으로 알려 줍니다.
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>는 토큰의 처음 9자입니다. 토큰마다 자체 작업이 생기므로 다른 서비스 명령도 그 작업을 찾으려면 같은--authtoken이 필요합니다. -
실행 중인지 확인하기 #
터미널sudo localtonet --status-service --authtoken <YOUR_TOKEN>실행 중인 작업은
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running이라고 응답합니다. 대시보드의 내 토큰에서 해당 토큰이 온라인으로 표시됩니다.
설치 시 생성되는 항목 #
| 항목 | 위치 |
|---|---|
| launchd 작업 정의 | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| 클라이언트의 표준 출력 | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| 클라이언트의 오류 출력 | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
작업은 Mac이 부팅될 때 시작되며, 클라이언트가 오류로 종료되면 launchd가 다시 시작합니다. 작업은 서비스를 설치할 때의 경로에 있는 localtonet 파일을 실행하며, 토큰이 인수의 일부로 포함됩니다.
서비스 명령 #
각 명령은 sudo로 실행하고 --authtoken <YOUR_TOKEN>을 추가하세요.
| 명령 | 기능 |
|---|---|
--install-service | 작업 정의를 작성하고, 로드한 다음 클라이언트를 시작합니다. |
--start-service | 작업을 시작합니다. 이미 실행 중이면 launchd가 다시 시작합니다. |
--stop-service | 클라이언트를 중지합니다. 작업은 설치된 채로 남아 있으며 다음 부팅 때 다시 시작됩니다. |
--status-service | 상태를 출력합니다. 예: Running, Stopped, NotFound, Error. |
--remove-service | 작업을 중지하고, 언로드하며, 작업 정의를 삭제합니다. |
서비스는 --install-service와 함께 전달한 옵션으로 설치됩니다. 옵션은 CLI 참조에 나와 있습니다.
업그레이드 #
- Homebrew:
brew upgrade localtonet - 수동 설치: 최신 아카이브를 받아
localtonet파일을 교체하세요.
Localtonet이 서비스로 실행 중이라면 Homebrew 업그레이드 후 서비스를 다시 설치하세요. 제거한 다음 같은 토큰으로 설치합니다. 설치하면 서비스도 함께 시작됩니다.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>작업은 설치될 때의 파일 경로를 유지합니다. 수동으로 업그레이드해도 클라이언트가 같은 위치에 있다면 --stop-service로 서비스를 중지하고, 파일을 교체한 다음 --start-service로 서비스를 시작하면 됩니다. 이 명령들은 서비스로 실행에서 설명합니다.
제거 #
- 서비스를 설치했다면 먼저 제거하세요:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - 저장된 토큰을 삭제하려면 클라이언트를 시작하고 F12를 누르세요.
- 클라이언트를 삭제합니다. Homebrew의 경우:
brew uninstall localtonet, tap을 제거하려면brew untap localtonet/tap. 수동 설치의 경우localtonet파일을 삭제하세요.
문제 해결 #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
명령이 root 권한 없이 실행되었습니다. sudo로 다시 실행하세요.
sudo: localtonet: command not found
sudo가 자체 검색 경로에서 클라이언트를 찾지 못합니다. 대신 전체 경로를 지정하세요. command -v localtonet이 경로를 출력해 줍니다. 예:
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>PATH 단계 없이 수동 설치한 경우 경로는 ~/localtonet/localtonet입니다.
Install failed: Plist already exists for 'Localtonet_…'
이 토큰의 서비스가 이미 설치되어 있습니다. --status-service로 확인하세요. 다시 설치하려면 먼저 --remove-service를 실행하세요.
서비스는 설치되었지만 토큰이 계속 오프라인입니다
작업의 오류 로그 /var/log/Localtonet_<TOKEN_PREFIX>.err.log를 읽고, 서비스를 설치할 때의 경로에 localtonet 파일이 아직 있는지 확인하세요.
Wrong Token!
클라이언트는 내 토큰의 33자 AuthToken 또는 만료되지 않은 6자리 PIN을 기대합니다. 토큰을 다시 복사하여 프롬프트에 입력하세요.
This token is used in another localtonet application!
이 Mac에서 다른 Localtonet 클라이언트가 이미 같은 토큰으로 실행 중입니다. 해당 클라이언트를 닫거나, 이 클라이언트를 다른 토큰으로 시작하세요. 토큰당 하나의 클라이언트만 실행하세요.