기기 터미널
무료 Desktop v8.6+ Windows, Linux, macOS
이 페이지의 내용 섹션 13개
내 기기에서는 컴퓨터 목록과 각 컴퓨터의 CPU, 메모리, 디스크 사용량을 확인하고, 브라우저에서 해당 컴퓨터의 실제 셸을 열 수 있습니다. 컴퓨터에서 명령 하나로 활성화하며, 공개 포트를 열어 둘 필요가 없습니다.
작동 방식 #
컴퓨터에서 localtonet --terminal enable을 실행하고, 출력된 짧은 코드를 대시보드에서 승인합니다. 그 후에는 터미널 버튼으로 해당 컴퓨터의 셸을 브라우저 탭에서 열 수 있습니다. 대시보드에 표시되는 ssh 명령을 사용하면 아무 터미널에서나 같은 셸에 접속할 수도 있습니다.
- 기기는 아웃바운드 연결만 사용합니다. 열어야 할 인바운드 포트도, 설치해야 할 SSH 서버도 없습니다.
- 브라우저에서 셸을 열 때마다 인증 앱의 새 코드가 필요합니다.
- 터미널은 로컬 명령으로만 켤 수 있습니다. 대시보드에서는 켤 수 없습니다.
시작하기 전에 #
- 컴퓨터에 설치된 Localtonet. 이 기능을 사용하려면 Localtonet 앱 최소 버전 Desktop v8.6이 필요합니다. 다운로드 페이지에서 받으세요.
- 해당 컴퓨터용 AuthToken. 컴퓨터마다 별도의 토큰을 사용하세요. 하나의 토큰을 두 번째 컴퓨터에서 실행하면 첫 번째 컴퓨터의 연결이 끊어집니다. 터미널은 개인 계정의 토큰에서만 작동하며 팀 토큰에서는 작동하지 않습니다. AuthToken을 참고하세요.
- 2단계 인증. 셸을 열려면 계정에 인증 앱이 설정되어 있어야 합니다. 아직 설정하지 않았다면 내 기기에 2단계 인증 켜기가 표시됩니다. 계정 및 보안을 참고하세요.
내 기기는 개인 대시보드 메뉴에 있습니다. 팀을 선택한 상태에서는 표시되지 않습니다.
기기 추가 #
-
기기 추가 열기 #
내 기기를 열고 기기 추가를 선택합니다.
-
토큰 선택 #
기존 토큰을 선택하거나, 새 토큰 생성을 선택해 토큰을 만들고 명령에 넣습니다. 이 컴퓨터에서 Localtonet이 이미 실행 중이면 그 토큰을 선택하세요. 목록에는 온라인 상태이거나 이미 다른 기기에서 사용 중인 토큰이 표시됩니다. 현재 연결된 토큰에는 경고가 표시됩니다. Localtonet이 바로 이 컴퓨터에서 실행 중인 경우에만 그 토큰을 사용하세요.
-
컴퓨터에서 명령 실행 #
대화 상자에서 명령을 복사하여 추가하려는 컴퓨터의 터미널에서 실행합니다. 그 컴퓨터에서 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:를 묻고 사용자의 계정을 제안합니다. 해당 권한이 없으면 셸은 명령을 실행한 계정으로 실행됩니다.
-
코드 입력 및 승인 #
대화 상자로 돌아가 2. 표시된 코드를 입력하세요 아래에 승인 코드를 입력합니다. 대문자와 대시는 자동으로 추가되며, 명령이 출력한 줄 전체를 붙여넣어도 됩니다. 인증 앱의 6자리 코드를 입력하고 기기 승인을 선택합니다.
그러면 컴퓨터의 명령이 Terminal enabled. Shells will run as …를 출력하고 기기가 목록에 나타납니다. 그 컴퓨터에서 Localtonet이 실행 중인 동안에는 온라인으로 표시됩니다.
승인 코드는 15분 동안 유효합니다. 코드는 8자이며 I, L, O, U, 0, 1은 포함되지 않습니다. 코드가 만료되면 명령이 알려 주므로 다시 실행하세요.
승인 후 콘솔에서 직접 시작한 명령은 일반적인 Localtonet 실행으로 계속됩니다. 스크립트에서 실행했거나 기기에서 Localtonet이 이미 이 토큰으로 실행 중이면 터미널이 활성화된 후 명령이 종료됩니다.
컴퓨터 앞에 아무도 없을 때 #
코드를 확인할 사람이 없는 컴퓨터(예: 스크립트로 설정하는 서버)에서는 승인 코드 대신 일회용 키를 사용하세요.
- 기기 추가 대화 상자에서 토큰을 선택하고 인증 앱 코드를 입력합니다.
- 그 컴퓨터에서 코드를 확인할 사람이 없나요?를 열고 일회용 키 만들기를 선택합니다. 키는 한 시간 동안 유효하며 한 번만 사용할 수 있습니다.
- 명령을 복사하고
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 | 현재 프로세서 부하입니다. 기기가 온라인일 때 표시됩니다. |
| 메모리 | 전체 메모리 중 사용 중인 양입니다. 기기가 온라인일 때 표시됩니다. |
| 디스크 | 전체 디스크 공간 중 사용 중인 양입니다. 기기가 온라인일 때 표시됩니다. |
| 작업 | 터미널, 키, 연결 기록, 이름 변경, 제거입니다. |
브라우저에서 터미널 열기 #
-
터미널 선택 #
기기 행에서 터미널을 선택합니다. 이 버튼은 기기가 온라인일 때만 작동합니다. 대화 상자에 셸이 어떤 계정으로 실행되는지 표시됩니다.
-
인증 앱 코드 입력 #
인증 앱의 6자리 코드를 입력하고 터미널 열기를 선택합니다. 셸이 새 브라우저 탭에서 열립니다.
ssh로 연결 #
터미널 대화 상자의 또는 설치 없이 아무 터미널에서나 아래에도 명령이 표시됩니다. ssh 클라이언트가 있는 모든 컴퓨터에서 사용할 수 있습니다. 명령은 다음 형식이며, <DEVICE>는 기기 이름, <NODE>는 기기가 연결된 Localtonet 서버입니다.
ssh -p 24 <DEVICE>@<NODE>대화 상자에서 명령을 복사하세요. 사용 중인 기기에 맞는 정확한 명령이 표시됩니다.
- 대화 상자에는 서버 지문이 표시됩니다. ssh는 처음 연결할 때 지문을 보여 줍니다. 두 지문이 일치하면 Localtonet에 연결된 것입니다.
- SSH 키를 추가하지 않았다면 ssh가 브라우저에서 승인할 링크를 표시합니다. 연결 승인 페이지에는 기기와 요청이 들어온 IP 주소가 표시됩니다. 인증 앱 코드를 입력하고 연결 허용을 선택한 다음 터미널로 돌아가세요. 요청은 5분 후에 만료됩니다.
방금 직접 ssh 명령을 실행한 경우에만 연결을 승인하세요. 요청을 보낸 사람은 그 컴퓨터의 셸을 얻게 됩니다.
SSH 키 #
자신의 컴퓨터의 SSH 공개 키를 추가하면 ssh, scp, sftp가 브라우저에서 승인하지 않고도 연결됩니다.
- 내 기기에서 SSH 키를 선택합니다.
- 이름을 입력하고, 공개 키 파일(예:
~/.ssh/id_ed25519.pub)의 한 줄을 공개 키에 붙여넣습니다. 개인 키는 절대 붙여넣지 마세요. - 인증 앱 코드를 입력하고 키 추가를 선택합니다.
허용되는 키 유형은 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 에이전트가 브라우저 없이 컴퓨터 한 대에 접속할 수 있습니다. 키를 가진 사람은 누구나 그곳에서 명령을 실행할 수 있으므로 비공개로 보관하세요.
- 기기 행에서 키를 선택합니다.
- 이름을 입력하고, 유효 기간(일)을 설정하고, 인증 앱 코드를 입력합니다. 키는 해당 일수가 지나면 작동하지 않으며, 최대 3650일입니다.
- 키 만들기를 선택하고 지금 키를 복사하세요. 다시 표시되지 않습니다.
키를 사용하는 방법:
- 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을 실행하세요.