본문으로 건너뛰기
Localtonet Localtonet 대시보드

macOS에 Localtonet 설치하기

이 페이지 도움받기
이 페이지의 내용 섹션 9개
  1. 시작하기 전에
  2. Homebrew로 설치
  3. Localtonet tap 추가 및 설치
  4. 설치 확인하기
  5. 수동 설치
  6. 다운로드하고 압축 해제하기
  7. 선택 사항: PATH로 옮기기
  8. 클라이언트 시작하기
  9. 토큰으로 시작하기
  10. 세션 확인하기
  11. launchd 서비스로 실행
  12. 서비스 설치
  13. 실행 중인지 확인하기
  14. 설치 시 생성되는 항목
  15. 서비스 명령
  16. 업그레이드
  17. 제거
  18. 문제 해결
  19. 관련 페이지

macOS에서 Localtonet 클라이언트는 Intel 및 Apple Silicon Mac용 콘솔 프로그램입니다. Homebrew 또는 ZIP 아카이브로 설치하고 AuthToken으로 시작하며, 부팅할 때마다 시작되어야 한다면 launchd 서비스로 설치하세요.

시작하기 전에 #

  • Localtonet 계정. 없다면 무료로 만드세요.
  • AuthToken. 대시보드의 AuthToken 카드에서 복사를 선택하거나 내 토큰에서 토큰을 복사하세요.
  • Homebrew로 설치하려면: Homebrew.
  • launchd 서비스를 쓰려면: sudo를 사용할 수 있는 계정.

Homebrew로 설치 #

  1. Localtonet tap 추가 및 설치 #

    tap은 Homebrew에 서드파티 저장소를 추가하여 그곳의 formula를 설치하고 업데이트할 수 있게 합니다.

    터미널
    brew tap localtonet/tap
    brew install localtonet
  2. 설치 확인하기 #

    터미널
    localtonet --version

    명령이 클라이언트의 버전을 출력합니다.

수동 설치 #

직접 다운로드하려면 내 Mac에 맞는 아카이브를 받으세요. ZIP에는 localtonet 파일 하나가 들어 있습니다.

Mac아카이브
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. 다운로드하고 압축 해제하기 #

    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. 선택 사항: PATH로 옮기기 #

    이 단계를 건너뛰면 클라이언트를 경로 ~/localtonet/localtonet로 시작해야 합니다. 이 단계를 하면 어느 폴더에서든 localtonet을 입력할 수 있습니다.

    터미널
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

클라이언트 시작하기 #

  1. 토큰으로 시작하기 #

    터미널
    localtonet --authtoken <YOUR_TOKEN>

    클라이언트는 토큰을 로컬에 저장합니다. 다음부터는 localtonet만으로 시작할 수 있습니다. 저장된 토큰 없이 시작하면 Please Enter AuthToken or PIN이라고 묻습니다.

  2. 세션 확인하기 #

    터미널에 Session Status: Connected가 표시되고, 그 아래 실행 중인 터널마다 한 행씩 있는 표가 나타납니다. 열은 IP/Url, Protocol, Client IP, Client Port, Ping, Status입니다. 대시보드에서 터널을 시작하기 전까지 표는 비어 있습니다. 빠른 시작을 참고하세요.

    클라이언트를 중지하려면 Ctrl + C를 누르세요. 저장된 토큰을 삭제하고 종료하려면 F12를 누르세요.

launchd 서비스로 실행 #

서비스는 부팅할 때마다 Localtonet을 시작하고, 로그아웃한 뒤에도 계속 실행하며, 열려 있는 터미널이 필요하지 않습니다. 서비스 명령에는 root 권한이 필요하므로 sudo로 실행하세요.

  1. 서비스 설치 #

    터미널
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    이 명령은 해당 토큰용 시스템 전체 launchd 작업을 등록하고 즉시 시작합니다. 작업 이름을 응답으로 알려 줍니다.

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX>는 토큰의 처음 9자입니다. 토큰마다 자체 작업이 생기므로 다른 서비스 명령도 그 작업을 찾으려면 같은 --authtoken이 필요합니다.

  2. 실행 중인지 확인하기 #

    터미널
    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로 서비스를 시작하면 됩니다. 이 명령들은 서비스로 실행에서 설명합니다.

제거 #

  1. 서비스를 설치했다면 먼저 제거하세요: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. 저장된 토큰을 삭제하려면 클라이언트를 시작하고 F12를 누르세요.
  3. 클라이언트를 삭제합니다. 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이 경로를 출력해 줍니다. 예:

Bash
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 클라이언트가 이미 같은 토큰으로 실행 중입니다. 해당 클라이언트를 닫거나, 이 클라이언트를 다른 토큰으로 시작하세요. 토큰당 하나의 클라이언트만 실행하세요.

이 페이지에 도움이 필요하신가요? 커뮤니티에 질문하거나 지원 티켓을 만들어 주세요.

지원