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

Windows에 Localtonet 설치하기

이 페이지 도움받기
이 페이지의 내용 섹션 9개
  1. 시작하기 전에
  2. 빌드 선택하기
  3. 앱 사용하기
  4. 앱 설치하고 열기
  5. 토큰으로 로그인하기
  6. 터널 시작하기
  7. 콘솔 클라이언트 사용하기
  8. 다운로드하고 압축 해제하기
  9. 토큰으로 시작하기
  10. 세션 확인하기
  11. Windows 서비스로 실행하기
  12. 서비스 설치하기
  13. 실행 중인지 확인하기
  14. 서비스 명령
  15. 업데이트
  16. 제거하기
  17. 문제 해결
  18. 관련 페이지

Windows에서는 Microsoft Store의 Localtonet 앱, 같은 앱의 포터블 빌드, 또는 콘솔 클라이언트를 사용할 수 있습니다. 콘솔 클라이언트는 부팅할 때마다 시작되는 Windows 서비스로 스스로 설치할 수도 있습니다.

시작하기 전에 #

  • Localtonet 계정이 필요합니다. 없다면 무료로 만드세요.
  • AuthToken이 필요합니다. 대시보드의 AuthToken 카드에서 복사를 선택하거나, 내 토큰에서 토큰을 복사하세요.
  • Windows 서비스의 경우: 관리자 권한으로 실행한 명령 프롬프트 또는 PowerShell 창이 필요합니다.

빌드 선택하기 #

빌드다운로드참고
Microsoft Store 앱Microsoft Store의 Localtonet로그인 화면이 있는 앱 창입니다. Windows 10 버전 1809(빌드 17763) 이상이 필요합니다.
데스크톱 앱, 포터블 ZIPx64, x86, ARM64Store 없이 쓰는 같은 앱입니다. ZIP을 압축 해제한 다음 압축을 푼 폴더에서 앱을 시작하세요.
콘솔 클라이언트64비트, 32비트, ARM64파일 하나, localtonet.exe가 들어 있는 ZIP입니다. 서비스 명령을 제공하는 빌드입니다.

다운로드 페이지에서는 바이너리 아래에 Microsoft Store 앱과 콘솔 빌드 세 가지가 제공됩니다.

앱 사용하기 #

  1. 앱 설치하고 열기 #

    Microsoft Store에서 Localtonet을 설치하거나, 포터블 ZIP을 압축 해제한 다음 앱을 시작하세요. 앱은 Sign in to Localtonet 화면으로 열립니다.

  2. 토큰으로 로그인하기 #

    AuthToken을 Authtoken or PIN 입력란에 붙여 넣고 Connect를 선택합니다. 화면이 열릴 때 토큰이 클립보드에 있으면 앱이 자동으로 채워 줍니다. 토큰 대신 내 토큰에 토큰별로 표시되는 6자리 PIN을 입력할 수도 있습니다. PIN은 1분 동안 유효합니다.

    앱이 Pin or authtoken is not valid.라고 응답하면 토큰을 다시 복사하고 33자가 모두 들어 있는지 확인하세요.

  3. 터널 시작하기 #

    로그인하면 앱에 이 기기에서 실행 중인 터널이 나열됩니다. 목록에 No active tunnels라고 표시되는 동안에는 대시보드에서 터널을 만들고 시작하세요. 빠른 시작을 참고하세요. Sign Out은 앱에서 토큰을 제거하고, Quit Localtonet은 앱을 닫습니다.

콘솔 클라이언트 사용하기 #

  1. 다운로드하고 압축 해제하기 #

    내 CPU에 맞는 ZIP을 다운로드해 위치가 바뀌지 않는 폴더(예: C:\Localtonet)에 압축 해제하세요. 나중에 설치하는 서비스는 이 폴더에서 localtonet.exe를 시작합니다.

  2. 토큰으로 시작하기 #

    해당 폴더에서 명령 프롬프트 또는 PowerShell을 열고 다음을 실행합니다.

    명령 프롬프트
    localtonet --authtoken <YOUR_TOKEN>

    PowerShell은 경로를 써야만 현재 폴더의 프로그램을 실행하므로, PowerShell에서는 명령이 다음과 같습니다.

    PowerShell
    .\localtonet --authtoken <YOUR_TOKEN>

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

  3. 세션 확인하기 #

    창에는 Session Status: Connected가 표시되고, 그 아래 표에 실행 중인 터널마다 한 행씩 나타납니다. 열은 IP/Url, Protocol, Client IP, Client Port, Ping, Status입니다. 대시보드에서 터널을 시작하기 전에는 표가 비어 있습니다. 토큰 이름은 표 아래에 표시됩니다.

    Ctrl + C를 누르면 클라이언트가 중지됩니다. F12를 누르면 저장된 토큰을 제거하고 종료합니다.

Windows 서비스로 실행하기 #

서비스는 부팅할 때마다 Localtonet을 시작하고, 로그아웃한 뒤에도 계속 실행하며, 열린 터미널이 필요하지 않습니다. 이 명령은 콘솔 클라이언트로, 관리자 권한으로 실행한 명령 프롬프트 또는 PowerShell에서 실행하세요.

  1. 서비스 설치하기 #

    명령 프롬프트 (관리자)
    localtonet --install-service --authtoken <YOUR_TOKEN>

    이 명령은 이 토큰용 Windows 서비스를 등록하고, 시작 유형을 자동으로 설정하고, 즉시 시작합니다. 서비스 이름이 응답으로 표시됩니다.

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX>는 토큰의 처음 9자입니다. 토큰마다 고유한 서비스가 생기므로, 다른 서비스 명령도 서비스를 찾으려면 같은 --authtoken이 필요합니다.

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

    명령 프롬프트 (관리자)
    localtonet --status-service --authtoken <YOUR_TOKEN>

    실행 중인 서비스는 [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running이라고 응답합니다. 서비스는 services.msc에서도 같은 이름으로 보이며 설명은 Localtonet Service입니다. 대시보드의 내 토큰에서 해당 토큰이 온라인으로 표시됩니다.

서비스 명령 #

각 명령에 --authtoken <YOUR_TOKEN>을 추가하세요.

명령기능관리자 권한 필요
--install-service자동 시작으로 서비스를 만들고 시작합니다. Windows는 실패 후 1분 뒤에 서비스를 다시 시작합니다.예
--start-service설치된 서비스를 시작합니다. 예를 들어 서비스를 중지한 뒤에 사용합니다.예
--stop-service서비스를 중지합니다. 다음 부팅 때 다시 시작됩니다.예
--status-service상태를 출력합니다. Running, Stopped, 서비스가 시작되는 동안의 Installing, Paused, 이 토큰용 서비스가 없을 때의 NotFound, Error, Unknown 중 하나입니다.아니요
--remove-service서비스를 중지하고 삭제합니다.예

서비스는 --install-service와 함께 전달한 옵션으로 설치되므로, --net, --ip 같은 클라이언트 옵션은 해당 명령에 추가하세요. 옵션은 CLI 참조에 나와 있습니다.

서비스는 서비스를 설치할 때 파일이 있던 폴더의 localtonet.exe를 실행하며, 토큰이 시작 명령의 일부로 들어갑니다. 서비스가 설치되어 있는 동안에는 이 파일을 옮기거나 삭제하지 마세요.

업데이트 #

  • Microsoft Store 앱: Microsoft Store가 앱을 업데이트합니다.
  • 콘솔 클라이언트와 포터블 앱: 다운로드 페이지에서 최신 ZIP을 내려받아 이전 파일을 교체하세요. Windows는 실행 중인 localtonet.exe를 교체할 수 없으므로 먼저 클라이언트를 닫아야 합니다. 서비스로 실행 중이라면 --stop-service를 실행하고, 파일을 교체한 다음 --start-service를 실행하세요.

localtonet --version은 설치된 버전을 출력합니다. 내 토큰의 클라이언트 열에는 기기가 마지막으로 보고한 버전이 표시되며, 더 새로운 버전이 있으면 업데이트 필요 배지가 표시됩니다.

제거하기 #

  1. 서비스를 설치했다면 관리자 권한으로 localtonet --remove-service --authtoken <YOUR_TOKEN>을 실행해 제거하세요.
  2. 저장된 토큰을 제거하려면 콘솔 클라이언트를 시작하고 F12를 누르세요.
  3. localtonet.exe가 있는 폴더를 삭제하거나 Windows 설정에서 Store 앱을 제거하세요.

문제 해결 #

'localtonet' is not recognized

터미널이 localtonet.exe가 있는 폴더에 있지 않거나 PowerShell을 사용 중입니다. 먼저 해당 폴더로 이동하세요. PowerShell에서는 클라이언트를 .\localtonet으로 시작하세요.

Install failed: 'Windows service installation' requires elevated (admin/root) privileges.

터미널이 관리자 권한으로 실행되고 있지 않습니다. 관리자 권한으로 실행으로 명령 프롬프트 또는 PowerShell을 열고 명령을 다시 실행하세요. --start-service, --stop-service, --remove-service도 같은 종류의 메시지로 응답합니다.

Install failed: Service 'Localtonet_…' already exists.

이 토큰용 서비스가 이미 설치되어 있습니다. --status-service로 확인하세요. 다른 옵션으로 또는 다른 폴더에서 다시 설치하려면 먼저 --remove-service를 실행하세요.

Start failed: Service could not be started

이 메시지에는 Windows sc 도구의 응답이 포함됩니다. 오류 1056은 서비스가 이미 실행 중이라는 뜻입니다. --install-service 직후 --start-service를 직접 실행하면 설치 명령이 이미 서비스를 시작하므로 이런 오류가 나는 것이 정상입니다. 오류 1060은 이 토큰용 서비스가 없다는 뜻입니다.

상태가 NotFound인데 서비스를 설치했습니다

서비스 이름은 토큰으로 만들어집니다. 서비스를 설치할 때 사용한 토큰과 다른 토큰을 전달하면 클라이언트는 다른 서비스를 찾습니다. 같은 토큰을 사용하거나, services.msc에서 Localtonet_로 시작하는 서비스를 찾아보세요.

Service installation cannot persist proxy passwords.

--install-service를 --proxy-user 또는 비밀번호가 포함된 프록시 URL과 함께 사용했습니다. 서비스는 프록시 비밀번호와 함께 설치되지 않습니다. --proxy env를 사용하고 인증 정보는 서비스의 환경에서 제공하세요. CLI 참조를 참고하세요.

Wrong Token!

클라이언트는 내 토큰의 33자 AuthToken 또는 만료되지 않은 6자리 PIN을 요구합니다. 토큰을 다시 복사해 프롬프트에 입력하세요.

This token is used in another localtonet application!

이 컴퓨터의 다른 Localtonet 창이 이미 같은 토큰으로 실행 중입니다. 그 창을 닫거나 이 창을 다른 토큰으로 시작하세요. 토큰 하나당 실행 중인 클라이언트는 하나만 사용하세요.

대시보드에서 토큰이 계속 오프라인으로 표시됩니다

오프라인은 기기의 연결이 끊어졌다는 뜻입니다. 클라이언트 창이 아직 열려 있는지 또는 서비스 상태가 Running인지, 그리고 지금 보고 있는 토큰으로 클라이언트를 시작했는지 확인하세요.

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

지원