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

AuthToken

이 페이지 도움받기
이 페이지의 내용 섹션 8개
  1. AuthToken이란
  2. 토큰 만들기
  3. 내 토큰 열기
  4. 기기 이름 지정
  5. 앱에 토큰 복사
  6. 내 터널에서 기기 선택
  7. 토큰 목록
  8. IP 기록
  9. 토큰 설정
  10. 토큰 삭제
  11. QR 코드 또는 PIN으로 Android 기기 연결
  12. 기기 연결 열기
  13. 코드를 스캔하거나 PIN 입력
  14. 토큰 그룹
  15. 그룹 만들기
  16. 그룹의 토큰 선택
  17. 토큰이 사용되는 곳
  18. 문제 해결
  19. 관련 페이지

AuthToken은 기기 한 대의 Localtonet 앱을 계정에 연결합니다. 내 토큰에서 기기마다 토큰을 만들고, 그 토큰으로 기기에 로그인한 다음 터널을 만들 때 해당 토큰을 선택하세요.

AuthToken이란 #

Localtonet 앱은 이메일과 비밀번호 대신 AuthToken으로 로그인합니다. 대시보드에서 토큰은 그 토큰을 사용하는 기기를 나타냅니다. 터널은 토큰에 대해 만들어지며, 해당 토큰을 사용하는 앱이 연결되어 있는 동안 작동합니다.

  • 기기마다 별도의 토큰을 사용하세요. 같은 토큰을 사용하는 새 연결은 이전 연결을 대체합니다.
  • 토큰 이름은 단순한 라벨입니다. 토큰 자체는 Localtonet이 생성합니다.
  • AuthToken은 기기를 로그인시킵니다. 방문자로부터 터널을 보호하지는 않습니다. 그 용도로는 접근 제어를 참고하세요.

토큰을 비공개로 유지하세요. 토큰을 가진 사람은 누구나 그 토큰으로 앱에 로그인할 수 있습니다. 토큰의 QR 코드와 PIN도 마찬가지입니다.

토큰 만들기 #

  1. 내 토큰 열기 #

    내 토큰을 열고 토큰 생성을 펼칩니다.

  2. 기기 이름 지정 #

    토큰 이름에 알아보기 쉬운 이름(예: Office-PC)을 입력하고 토큰 생성을 선택합니다.

    규칙세부 내용
    필수이름이 비어 있으면 사용자 지정 이름은 필수입니다!라고 표시됩니다.
    길이최대 30자입니다.
    공백허용되지 않습니다. 입력란에 공백을 입력할 수 없으며, 붙여넣은 이름의 공백은 제거됩니다.
    고유성토큰 두 개가 같은 이름을 가질 수 없습니다.
  3. 앱에 토큰 복사 #

    새 토큰은 내 토큰 아래에 나타납니다. 토큰을 선택해 전체 토큰을 복사한 다음, 그 토큰으로 Localtonet 앱을 시작합니다.

    터미널
    localtonet --authtoken <YOUR_TOKEN>

    Android에서는 QR 코드나 PIN을 대신 사용하세요. 아래의 Android 기기 연결을 참고하세요.

  4. 내 터널에서 기기 선택 #

    터널을 만들 때 기기 토큰에서 이 토큰을 선택합니다. 전체 과정은 빠른 시작에서 볼 수 있습니다.

토큰 목록 #

내 토큰에는 현재 작업 중인 계정의 모든 토큰이 나열됩니다. 토큰 검색으로 이름이나 토큰으로 필터링하고, 새로고침으로 목록을 다시 불러옵니다. 화면이 좁으면 일부 열이 각 행의 세부 정보 버튼 뒤로 이동합니다.

열표시 내용할 수 있는 작업
이름토큰에 지정한 이름입니다.이름을 선택하면 토큰 이름을 바꿀 수 있습니다. 새 이름의 규칙이 적용됩니다.
상태온라인은 Localtonet 앱이 연결되어 있다는 뜻입니다. 오프라인은 터널이 계속 설정되어 있더라도 기기의 연결이 끊어졌다는 뜻입니다.
토큰가운데 부분이 가려진 토큰입니다.선택하면 전체 토큰이 복사됩니다. QR 버튼은 기기 연결을 엽니다.
터널이 토큰에 연결된 활성 터널 수 / 전체 터널 수입니다. 온라인 기기에 활성 터널이 있다고는 할 수 없습니다.
클라이언트마지막으로 보고된 앱 버전과 업데이트 상태입니다.업데이트 필요 배지는 다운로드 페이지로 연결되므로 최신 Localtonet 앱을 설치할 수 있습니다. 이 정보를 새로 고치려면 기기를 연결하세요.
기기기기가 마지막으로 보고한 스레드 사용량, 배터리 잔량, 배터리 온도입니다.Android 기기의 경우 Android 기기 설정, 지원되는 경우 SMS 설정, 기기 작업 로그를 사용할 수 있습니다. 프록시 매니저에서는 기기 전체에 같은 제어 기능을 제공합니다.
작업IP 기록, 토큰 설정, 토큰 삭제.

IP 기록 #

IP 기록은 토큰에 기록된 공인 IP 주소를 날짜와 함께 나열합니다. 목록 위에는 총 반복 횟수, 총 반복 IP, 최근 1시간 반복 IP, 최근 1시간 총 IP의 네 가지 카운터가 표시됩니다. 새로고침을 선택하면 카운터가 업데이트됩니다. 모바일 IP가 바뀌는 휴대폰처럼 IP가 변하는 기기에서 특히 유용합니다.

토큰 설정 #

토큰 설정은 전체 토큰, 토큰 복사 버튼, QR / PIN 버튼, 그리고 두 가지 설정이 있는 패널을 엽니다.

설정기능값
USB 기기 모드토큰이 USB 기기를 연결할 때 이 모드를 사용합니다. 해당 기기는 내 USB 기기에서 관리합니다.예 또는 아니요. 변경할 때 확인을 요청합니다.
클라이언트 인수클라이언트 옵션을 토큰과 함께 저장합니다. 관리를 선택하고 활성을 켠 다음 인수를 입력하세요. Localtonet 클라이언트는 여기에 저장된 인수를 적용하지 않고, 터널에 설정된 인수를 적용합니다. 네트워크 인터페이스나 로컬 IP 주소를 선택하려면 각 터널에서 설정하세요.활성을 켜면 입력란을 비워 둘 수 없습니다. 네트워크 선택을 참고하세요.

토큰 삭제 #

토큰 삭제를 선택하고 확인합니다. 대시보드가 먼저 경고를 표시합니다.

이 토큰을 사용하는 터널은 중지되고 삭제됩니다. 해당 토큰을 아직 사용하는 기기는 더 이상 그 토큰으로 연결할 수 없습니다. 그 기기가 다시 필요하면 새 토큰을 만드세요.

QR 코드 또는 PIN으로 Android 기기 연결 #

휴대폰에서 토큰을 직접 입력할 필요는 없습니다. 모든 토큰에는 QR 코드와 짧은 PIN이 있습니다.

  1. 기기 연결 열기 #

    내 토큰에서 토큰 옆의 QR 버튼을 선택합니다. 기기 연결 대화 상자가 열립니다.

  2. 코드를 스캔하거나 PIN 입력 #

    Android용 Localtonet을 엽니다. QR 코드 스캔 아래의 코드를 스캔하거나, 대신 PIN 입력 아래에 표시된 6자리 PIN을 앱의 로그인 필드에 입력하고 Connect를 선택합니다.

  • PIN은 1분 동안 유효합니다. 대화 상자에 카운트다운이 표시되고 이후 PIN이 만료되었습니다. 계속하려면 새 PIN을 생성하세요.라고 표시됩니다.
  • PIN은 한 번만 사용할 수 있습니다. 다른 기기에 사용하거나 다시 시도하려면 새 PIN 생성을 선택하세요.
  • QR 코드는 만료되지 않습니다. 토큰 자체가 들어 있으므로 QR 코드 사진도 토큰처럼 취급하세요.
  • 토큰을 앱에 직접 붙여넣을 수도 있습니다. 대화 상자에 복사 버튼과 함께 토큰이 표시됩니다.

토큰 그룹 #

토큰 그룹에는 기기 토큰이 들어 있습니다. 그룹은 기기를 풀(pool)로 묶습니다. 로테이팅 프록시는 선택한 그룹의 기기를 사용하며, 토큰 웹훅은 그룹에 대해 만듭니다.

  1. 그룹 만들기 #

    내 토큰에서 토큰 그룹을 펼치고 그룹 이름을 입력한 다음 그룹 생성을 선택합니다. 이름은 최대 30자이며 공백을 포함할 수 없고 내 그룹 중에서 고유해야 합니다.

  2. 그룹의 토큰 선택 #

    토큰 그룹 관리 대화 상자가 열리고 모든 토큰의 목록이 표시됩니다. 그룹에 속할 기기 토큰을 선택하고 변경 사항 저장을 선택합니다.

나중에 그룹을 변경하려면 해당 행에서 관리를 선택합니다. 이 대화 상자는 긴 목록을 다루도록 만들어져 있습니다.

  • 이름으로 검색합니다. 여러 이름은 쉼표로 구분합니다.
  • 기기 상태로 필터링합니다: 모든 상태, 온라인, 오프라인.
  • 전체, 그룹에 포함, 그룹에 미포함 사이를 전환합니다.
  • 모두 선택을 사용하면 표시된 모든 토큰이 선택되며, 제외할 토큰은 선택을 해제합니다. Shift+클릭으로 범위를 선택할 수 있습니다.
  • 하단에는 변경될 내용이 표시됩니다(예: +3개 추가 예정). 초기화는 변경 사항을 취소합니다.

그룹에서 토큰을 제거하면 대화 상자가 확인을 요청합니다. 그룹을 사용하는 로테이팅 프록시가 해당 기기에서 중지되기 때문입니다. 한 번 저장할 때 최대 5000개의 토큰을 변경할 수 있습니다.

그룹 삭제는 그룹과 그 구성원 정보를 제거합니다. 토큰 자체는 그대로 남습니다.

토큰이 사용되는 곳 #

위치토큰 사용 방식
터널 생성 양식기기 토큰은 터널을 제공하는 기기를 선택합니다. 기존 터널을 다른 기기로 옮기려면 터널의 AuthToken 변경을 사용하세요. 실행 중인 터널은 중지되고 2초 기다린 뒤 선택한 토큰으로 다시 시작됩니다.
로테이팅 프록시단일 토큰 대신 토큰 그룹을 사용합니다. 선택한 그룹에서 연결된 모든 기기가 공유 엔드포인트의 출구가 됩니다.
웹훅토큰 웹훅은 AuthToken 그룹에 대해 설정합니다.
VPN 매니저네트워크에 기기를 추가할 때 그 기기에서 Localtonet에 로그인하는 데 사용할 토큰을 선택합니다. 기기마다 별도의 토큰이 필요합니다.
기기 터미널토큰은 내 기기에서 컴퓨터를 계정에 연결합니다.
USB 기기USB 기기 모드의 토큰은 USB 모뎀이나 휴대폰이 연결된 컴퓨터를 연결합니다.
프록시 매니저모든 Android 휴대폰은 각자의 토큰으로 로그인합니다.

API와 MCP 서버로도 토큰과 토큰 그룹을 조회, 생성, 삭제할 수 있습니다.

대시보드에서 팀을 선택한 동안에는 내 토큰이 해당 팀의 토큰을 표시하고 생성합니다. 팀 관리를 참고하세요.

문제 해결 #

… 이름의 토큰이 이미 존재합니다

토큰 이름은 고유해야 합니다. 다른 이름을 선택하거나 기존 토큰의 이름을 먼저 바꾸세요.

이름은 30자를 초과할 수 없습니다

토큰 이름이나 그룹 이름을 30자 이하로 줄이세요.

토큰이 오프라인으로 표시됩니다

기기의 연결이 끊어졌습니다. 기기에서 Localtonet 앱을 열어 연결하세요. 같은 토큰으로 다른 기기를 시작했다면 그 기기가 이 연결을 대체한 것입니다. 기기마다 별도의 토큰을 만드세요.

클라이언트가 Wrong Token!이라고 표시합니다

입력한 값이 완전한 토큰이 아닙니다. 내 토큰에서 전체 토큰을 다시 복사하세요. 목록은 가운데 부분을 가리므로 보이는 텍스트를 선택하지 말고 복사 버튼을 사용하세요.

PIN이 만료되었습니다

PIN은 1분 동안 유효하며 한 번만 사용할 수 있습니다. 새 PIN 생성을 선택하거나 대신 QR 코드를 스캔하세요.

QR 코드와 PIN을 불러올 수 없습니다

대화 상자에서 다시 시도를 선택하세요. 계속 실패하면 토큰을 복사해 앱에 붙여넣으세요.

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

지원