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

기기 터미널

무료 Desktop v8.6+ Windows, Linux, macOS

이 페이지 도움받기
이 페이지의 내용 섹션 13개
  1. 작동 방식
  2. 시작하기 전에
  3. 기기 추가
  4. 기기 추가 열기
  5. 토큰 선택
  6. 컴퓨터에서 명령 실행
  7. 코드 입력 및 승인
  8. 컴퓨터 앞에 아무도 없을 때
  9. 명령 옵션
  10. 기기 목록
  11. 브라우저에서 터미널 열기
  12. 터미널 선택
  13. 인증 앱 코드 입력
  14. ssh로 연결
  15. SSH 키
  16. Localtonet 클라이언트 사용
  17. 스크립트와 AI 에이전트용 액세스 키
  18. Elio
  19. 연결 기록
  20. 기기 이름 변경, 제거 또는 비활성화
  21. 보안 참고 사항
  22. 문제 해결
  23. 관련 페이지

내 기기에서는 컴퓨터 목록과 각 컴퓨터의 CPU, 메모리, 디스크 사용량을 확인하고, 브라우저에서 해당 컴퓨터의 실제 셸을 열 수 있습니다. 컴퓨터에서 명령 하나로 활성화하며, 공개 포트를 열어 둘 필요가 없습니다.

작동 방식 #

컴퓨터에서 localtonet --terminal enable을 실행하고, 출력된 짧은 코드를 대시보드에서 승인합니다. 그 후에는 터미널 버튼으로 해당 컴퓨터의 셸을 브라우저 탭에서 열 수 있습니다. 대시보드에 표시되는 ssh 명령을 사용하면 아무 터미널에서나 같은 셸에 접속할 수도 있습니다.

  • 기기는 아웃바운드 연결만 사용합니다. 열어야 할 인바운드 포트도, 설치해야 할 SSH 서버도 없습니다.
  • 브라우저에서 셸을 열 때마다 인증 앱의 새 코드가 필요합니다.
  • 터미널은 로컬 명령으로만 켤 수 있습니다. 대시보드에서는 켤 수 없습니다.

시작하기 전에 #

  • 컴퓨터에 설치된 Localtonet. 이 기능을 사용하려면 Localtonet 앱 최소 버전 Desktop v8.6이 필요합니다. 다운로드 페이지에서 받으세요.
  • 해당 컴퓨터용 AuthToken. 컴퓨터마다 별도의 토큰을 사용하세요. 하나의 토큰을 두 번째 컴퓨터에서 실행하면 첫 번째 컴퓨터의 연결이 끊어집니다. 터미널은 개인 계정의 토큰에서만 작동하며 팀 토큰에서는 작동하지 않습니다. AuthToken을 참고하세요.
  • 2단계 인증. 셸을 열려면 계정에 인증 앱이 설정되어 있어야 합니다. 아직 설정하지 않았다면 내 기기에 2단계 인증 켜기가 표시됩니다. 계정 및 보안을 참고하세요.

내 기기는 개인 대시보드 메뉴에 있습니다. 팀을 선택한 상태에서는 표시되지 않습니다.

기기 추가 #

  1. 기기 추가 열기 #

    내 기기를 열고 기기 추가를 선택합니다.

  2. 토큰 선택 #

    기존 토큰을 선택하거나, 새 토큰 생성을 선택해 토큰을 만들고 명령에 넣습니다. 이 컴퓨터에서 Localtonet이 이미 실행 중이면 그 토큰을 선택하세요. 목록에는 온라인 상태이거나 이미 다른 기기에서 사용 중인 토큰이 표시됩니다. 현재 연결된 토큰에는 경고가 표시됩니다. Localtonet이 바로 이 컴퓨터에서 실행 중인 경우에만 그 토큰을 사용하세요.

  3. 컴퓨터에서 명령 실행 #

    대화 상자에서 명령을 복사하여 추가하려는 컴퓨터의 터미널에서 실행합니다. 그 컴퓨터에서 Localtonet이 서비스로 실행 중이면 관리자 권한 터미널이나 sudo를 사용하세요.

    컴퓨터에서
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    명령이 승인 코드를 출력하고 대기합니다.

    출력
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    관리자 또는 root로 실행하면 먼저 Run shells as user:를 묻고 사용자의 계정을 제안합니다. 해당 권한이 없으면 셸은 명령을 실행한 계정으로 실행됩니다.

  4. 코드 입력 및 승인 #

    대화 상자로 돌아가 2. 표시된 코드를 입력하세요 아래에 승인 코드를 입력합니다. 대문자와 대시는 자동으로 추가되며, 명령이 출력한 줄 전체를 붙여넣어도 됩니다. 인증 앱의 6자리 코드를 입력하고 기기 승인을 선택합니다.

    그러면 컴퓨터의 명령이 Terminal enabled. Shells will run as …를 출력하고 기기가 목록에 나타납니다. 그 컴퓨터에서 Localtonet이 실행 중인 동안에는 온라인으로 표시됩니다.

승인 코드는 15분 동안 유효합니다. 코드는 8자이며 I, L, O, U, 0, 1은 포함되지 않습니다. 코드가 만료되면 명령이 알려 주므로 다시 실행하세요.

승인 후 콘솔에서 직접 시작한 명령은 일반적인 Localtonet 실행으로 계속됩니다. 스크립트에서 실행했거나 기기에서 Localtonet이 이미 이 토큰으로 실행 중이면 터미널이 활성화된 후 명령이 종료됩니다.

컴퓨터 앞에 아무도 없을 때 #

코드를 확인할 사람이 없는 컴퓨터(예: 스크립트로 설정하는 서버)에서는 승인 코드 대신 일회용 키를 사용하세요.

  1. 기기 추가 대화 상자에서 토큰을 선택하고 인증 앱 코드를 입력합니다.
  2. 그 컴퓨터에서 코드를 확인할 사람이 없나요?를 열고 일회용 키 만들기를 선택합니다. 키는 한 시간 동안 유효하며 한 번만 사용할 수 있습니다.
  3. 명령을 복사하고 ACCOUNT를 그 컴퓨터에서 셸을 실행할 사용자 계정으로 바꿉니다.
컴퓨터에서
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

유효한 키가 있으면 기기가 즉시 승인되며 코드는 표시되지 않습니다.

명령 옵션 #

옵션기능
--terminal enable이 컴퓨터에서 원격 터미널을 켜고 페어링을 시작합니다.
--terminal disable이 컴퓨터에서 터미널을 끄고 계정에서 기기를 제거합니다.
--terminal status터미널이 활성화되어 있는지, 셸이 어떤 계정으로 실행되는지 출력합니다.
--terminal-user <ACCOUNT>root 또는 관리자로 활성화할 때 셸이 실행될 계정입니다. 이 경우 스크립트처럼 콘솔 없이 명령을 실행할 때는 필수입니다.
--pairing-key <PAIRING_KEY>대시보드의 일회용 키입니다. 사용하면 승인 코드가 필요 없습니다.

기기 목록 #

페이지가 열려 있는 동안 목록은 자동으로 새로 고쳐집니다.

열표시 내용
기기컴퓨터 이름, 운영 체제와 아키텍처, 셸이 실행되는 계정입니다.
상태온라인은 컴퓨터에서 Localtonet이 실행 중이며 연결되어 있다는 뜻입니다.
CPU현재 프로세서 부하입니다. 기기가 온라인일 때 표시됩니다.
메모리전체 메모리 중 사용 중인 양입니다. 기기가 온라인일 때 표시됩니다.
디스크전체 디스크 공간 중 사용 중인 양입니다. 기기가 온라인일 때 표시됩니다.
작업터미널, 키, 연결 기록, 이름 변경, 제거입니다.

브라우저에서 터미널 열기 #

  1. 터미널 선택 #

    기기 행에서 터미널을 선택합니다. 이 버튼은 기기가 온라인일 때만 작동합니다. 대화 상자에 셸이 어떤 계정으로 실행되는지 표시됩니다.

  2. 인증 앱 코드 입력 #

    인증 앱의 6자리 코드를 입력하고 터미널 열기를 선택합니다. 셸이 새 브라우저 탭에서 열립니다.

ssh로 연결 #

터미널 대화 상자의 또는 설치 없이 아무 터미널에서나 아래에도 명령이 표시됩니다. ssh 클라이언트가 있는 모든 컴퓨터에서 사용할 수 있습니다. 명령은 다음 형식이며, <DEVICE>는 기기 이름, <NODE>는 기기가 연결된 Localtonet 서버입니다.

아무 터미널
ssh -p 24 <DEVICE>@<NODE>

대화 상자에서 명령을 복사하세요. 사용 중인 기기에 맞는 정확한 명령이 표시됩니다.

  • 대화 상자에는 서버 지문이 표시됩니다. ssh는 처음 연결할 때 지문을 보여 줍니다. 두 지문이 일치하면 Localtonet에 연결된 것입니다.
  • SSH 키를 추가하지 않았다면 ssh가 브라우저에서 승인할 링크를 표시합니다. 연결 승인 페이지에는 기기와 요청이 들어온 IP 주소가 표시됩니다. 인증 앱 코드를 입력하고 연결 허용을 선택한 다음 터미널로 돌아가세요. 요청은 5분 후에 만료됩니다.

방금 직접 ssh 명령을 실행한 경우에만 연결을 승인하세요. 요청을 보낸 사람은 그 컴퓨터의 셸을 얻게 됩니다.

SSH 키 #

자신의 컴퓨터의 SSH 공개 키를 추가하면 ssh, scp, sftp가 브라우저에서 승인하지 않고도 연결됩니다.

  1. 내 기기에서 SSH 키를 선택합니다.
  2. 이름을 입력하고, 공개 키 파일(예: ~/.ssh/id_ed25519.pub)의 한 줄을 공개 키에 붙여넣습니다. 개인 키는 절대 붙여넣지 마세요.
  3. 인증 앱 코드를 입력하고 키 추가를 선택합니다.

허용되는 키 유형은 ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, ssh-rsa입니다. 키는 계정의 모든 기기에 적용됩니다. 키 옆의 제거를 선택하면 해당 키를 더 이상 사용할 수 없습니다. 대화 상자에는 기기 중 하나에 대한 scp 예시도 표시됩니다.

아무 터미널
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

Localtonet 클라이언트 사용 #

접속하는 컴퓨터에 Localtonet이 설치되어 있으면 localtonet ssh로도 연결할 수 있으며, 세션은 기기까지 끝까지 암호화됩니다.

아무 터미널
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

키가 없으면 링크와 함께 Approve this connection in your browser를 출력하고, 승인하면 계속 진행합니다. -- 뒤의 모든 내용은 셸을 여는 대신 기기에서 하나의 명령으로 실행됩니다.

스크립트와 AI 에이전트용 액세스 키 #

액세스 키를 사용하면 스크립트나 AI 에이전트가 브라우저 없이 컴퓨터 한 대에 접속할 수 있습니다. 키를 가진 사람은 누구나 그곳에서 명령을 실행할 수 있으므로 비공개로 보관하세요.

  1. 기기 행에서 키를 선택합니다.
  2. 이름을 입력하고, 유효 기간(일)을 설정하고, 인증 앱 코드를 입력합니다. 키는 해당 일수가 지나면 작동하지 않으며, 최대 3650일입니다.
  3. 키 만들기를 선택하고 지금 키를 복사하세요. 다시 표시되지 않습니다.

키를 사용하는 방법:

  • ssh. 대화 상자에 표시된 ssh 명령을 실행합니다. ssh가 요청하면 키를 붙여넣습니다.
  • Localtonet 클라이언트. 아래 예시처럼 --key 옵션으로 키를 전달합니다.
  • MCP. Localtonet의 MCP 서버에 연결된 AI 에이전트가 RunDeviceCommand 도구에 키를 전달할 수 있습니다.
스크립트
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

대화 상자에는 기기의 키가 만료일과 함께 나열됩니다. 제거를 선택하면 키를 폐기합니다.

Elio #

내 기기의 Elio 버튼은 Localtonet이 만든 무료 오픈 소스 SSH 클라이언트인 Elio에 관한 것입니다. elio.sh에서 다운로드하고, Elio에서 로그인한 다음 대시보드에서 2단계 인증 코드로 요청을 승인합니다. 그러면 Elio에서 기기의 이름과 상태를 볼 수 있습니다. 기기에서 셸을 열려면 여전히 해당 기기의 액세스 키나 승인이 필요합니다. 대화 상자에는 로그인되어 있는 Elio 사본이 나열되며, 하나를 제거하면 로그아웃됩니다.

연결 기록 #

기기 행의 시계 버튼을 선택하면 최근 연결을 볼 수 있습니다. 각 줄에는 연결 시각, 연결 방식, 접속한 IP 주소가 표시됩니다. 연결 방식은 브라우저 터미널, SSH 키를 사용한 ssh, 액세스 키를 사용한 ssh, 브라우저에서 승인한 ssh, 액세스 키 또는 브라우저 승인으로 사용한 localtonet ssh, 액세스 키를 사용해 MCP를 통해 접속한 AI 에이전트 중 하나입니다. 목록에는 최근 연결 50개가 보관됩니다.

Localtonet은 이 기록만 보관합니다. 입력한 명령과 그 출력은 저장되지 않습니다. 이 목록으로 직접 하지 않은 연결을 찾아내세요. 발견하면 더 이상 필요하지 않은 액세스 키와 SSH 키를 제거하세요.

기기 이름 변경, 제거 또는 비활성화 #

작업위치결과
이름 변경행의 연필 버튼입니다.목록에 표시되고 ssh 명령에 사용되는 이름을 바꿉니다. 문자, 숫자, 마침표, 대시, 밑줄을 사용할 수 있습니다.
제거행의 휴지통 버튼입니다.계정에서 컴퓨터를 제거합니다. 해당 키는 작동하지 않게 되며, 다시 사용하려면 다시 승인해야 합니다.
비활성화컴퓨터 자체에서 실행합니다.로컬에서 터미널을 끄고 계정에서 기기를 제거합니다.
컴퓨터에서
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

컴퓨터에서의 비활성화는 대시보드에 접속할 수 없을 때도 항상 작동합니다. 이 경우 명령이 대시보드에서도 기기를 제거하라고 안내합니다.

보안 참고 사항 #

  • 컴퓨터의 셸은 해당 계정이 할 수 있는 모든 작업에 대한 전체 접근 권한입니다. 셸을 실행할 계정은 신중하게 선택하세요. 권한이 없는 계정을 쓰면 세션이 바꿀 수 있는 범위가 제한됩니다.
  • 셸로 이어질 수 있는 모든 작업에는 새 인증 앱 코드가 필요합니다. 기기 승인, 터미널 열기, 액세스 키 만들기, SSH 키 추가, ssh 연결 승인이 여기에 해당합니다.
  • 액세스 키나 추가한 SSH 키는 그 코드 없이 연결됩니다. 키의 유효 기간은 짧게 설정하고, 비밀번호처럼 보관하고, 더 이상 사용하지 않는 키는 제거하세요.
  • 짧은 시간에 너무 많이 시도하면 대시보드가 시도 횟수가 너무 많습니다. 1분 후에 다시 시도하세요.라고 응답합니다.
  • 연결 기록을 가끔 확인하세요. 알 수 없는 연결이 있다면 예상하지 못한 키나 승인이 사용된 것입니다.
  • 기기를 제거하거나 기기에서 --terminal disable을 실행하면 해당 기기의 모든 키에 대한 접근이 종료됩니다.

문제 해결 #

승인 코드가 올바르지 않거나 만료되었습니다.

코드를 명령이 출력한 코드와 비교해 보세요. 코드는 15분 동안 유효하며 명령에 사용한 토큰의 계정에 속합니다. 명령을 다시 실행하면 새 코드를 받을 수 있습니다.

Remote terminal is available on personal tokens only

명령에 사용한 토큰이 팀 소유입니다. 개인 계정에서 토큰을 만들어 그 토큰을 사용하세요.

The pairing key is not valid or has expired

일회용 키는 한 번만, 한 시간 동안만 사용할 수 있습니다. 기기 추가 대화 상자에서 새 키를 만드세요.

Choose the account for shells with --terminal-user

명령이 콘솔 없이 root 또는 관리자로 실행되므로 계정을 물어볼 수 없습니다. --terminal-user <ACCOUNT>를 추가하세요.

터미널 버튼이 비활성화되어 있거나 이 기기는 오프라인입니다.

터미널은 기기가 온라인일 때만 열립니다. 그 컴퓨터에서 같은 토큰으로 Localtonet을 시작하세요.

인증 코드가 올바르지 않습니다.

인증 앱이 Localtonet에 대해 표시하는 6자리 코드를 입력하세요. 비밀번호도, 컴퓨터에 표시된 코드도 아니며 30초마다 바뀝니다.

이 요청이 만료되었습니다. 내 기기에서 다시 시작하세요.

터미널을 열거나 ssh 연결을 승인하는 요청은 유효 시간이 짧습니다. 터미널을 다시 선택하거나 ssh 명령을 다시 실행하세요.

SSH 공개 키가 아닌 것 같습니다.

.pub 파일의 전체 줄을 키 유형부터 시작하여 붙여넣으세요.

The terminal is already enabled on this device

할 일이 없습니다. 컴퓨터를 다시 페어링하려면 먼저 --terminal disable을 실행한 다음 --terminal enable을 실행하세요.

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

지원