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

SSH 클라이언트로 터널 시작하기

무료 플랜 HTTP 및 TCP 터널

이 페이지 도움받기
이 페이지의 내용 섹션 11개
  1. 사용하기 좋은 경우
  2. 시작하기 전에
  3. 단계
  4. HTTP 또는 TCP 터널 만들기
  5. SSH 명령어 열기
  6. 재연결 여부 선택하기
  7. 명령어 실행하기
  8. 창을 열어 두세요
  9. 터널 설정 마법사에서 시작하기
  10. 명령어 살펴보기
  11. 자동 재연결
  12. 명령어의 유효 기간
  13. 제한
  14. 대시보드에서 보이는 내용
  15. 문제 해결
  16. 대시보드 메시지
  17. 터미널 메시지
  18. 관련 페이지

Localtonet을 설치하지 않고 로컬 서비스를 온라인에 공개합니다. 대시보드에서 바로 쓸 수 있는 ssh 명령어를 제공하며, 이 명령어가 실행되는 동안 HTTP 또는 TCP 터널이 활성 상태로 유지됩니다.

사용하기 좋은 경우 #

Localtonet 클라이언트를 설치할 수 없거나 설치하고 싶지 않은 컴퓨터에서 제로 설치 SSH를 사용하세요. 예를 들어 잠깐만 접속하는 서버, 제한이 걸린 업무용 컴퓨터, 간단한 시연 상황에 알맞습니다. Windows, macOS, Linux에 기본 포함된 ssh 클라이언트만 있으면 됩니다.

SSH 명령어는 터널 하나에 대해 Localtonet 클라이언트를 대신합니다. 그 밖의 모든 것은 대시보드에 그대로 남습니다. 터널 주소, 설정, 로그, 대역폭이 여기에 해당합니다.

터널 유형SSH 명령어
HTTP / HTTPS사용 가능
TCP사용 가능
UDP, UDP / TCP 혼합, TLS, 파일 서버, 프록시 서버 및 그 밖의 유형사용할 수 없습니다. Localtonet 클라이언트가 필요합니다.

이 페이지는 SSH 서버에 접속하는 방법을 다루지 않습니다. 내 SSH 서버를 터널로 공개하려면 Localtonet과 SSH 함께 사용하기를 참고하세요. 대시보드에서 내 기기의 셸을 열려면 기기 터미널을 참고하세요.

시작하기 전에 #

  • Localtonet 계정과 이미 실행 중인 서비스(예: 3000번 포트의 웹 앱)가 필요합니다.
  • 서비스에 접근할 수 있는 컴퓨터의 ssh 클라이언트가 필요합니다. ssh -V로 확인하세요.
  • 해당 컴퓨터의 네트워크에서 223번 포트로의 아웃바운드 TCP 연결이 허용되어야 합니다.
  • 실행 중인 Localtonet 클라이언트가 사용하지 않는 AuthToken이 필요합니다. 터널은 항상 토큰에 속하지만, SSH에서는 어떤 클라이언트도 그 토큰으로 로그인하지 않습니다. 터널의 토큰으로 클라이언트가 연결되어 있으면 대시보드가 명령어를 발급하지 않습니다.

단계 #

  1. HTTP 또는 TCP 터널 만들기 #

    내 터널 › HTTP 또는 내 터널 › TCP - UDP(프로토콜 TCP)를 열고 평소처럼 터널을 만드세요. 로컬 IP 주소와 로컬 포트는 SSH 클라이언트가 트래픽을 보낼 대상입니다. 서비스와 같은 컴퓨터에서 명령어를 실행한다면 127.0.0.1과 서비스의 포트를 입력합니다. 터널은 중지된 상태로 두세요.

  2. SSH 명령어 열기 #

    터널 목록에서 해당 터널의 설정을 선택한 다음 SSH 명령어 보기를 선택하세요. 이 터널의 명령어가 담긴 SSH 명령어 대화 상자가 열립니다. 명령어를 실행할 수 있는 시간(초)이 안내 문구로 표시되며, 사용하지 않은 명령어는 만료됩니다. 만료되면 같은 방법으로 새 명령어를 요청하세요.

  3. 재연결 여부 선택하기 #

    일반 ssh 명령어를 받으려면 자동으로 재연결을 끈 상태로 두세요. 이 옵션을 켜면 연결이 끊어졌을 때 명령어를 다시 시작하는 루프로 감싸집니다. 이 경우 실행할 환경에서 루프를 작성할 셸을 선택하세요. PowerShell, 명령 프롬프트, macOS 또는 Linux 중에서 고를 수 있습니다.

  4. 명령어 실행하기 #

    명령어 아래의 텍스트를 복사하세요. 서비스가 실행 중인 컴퓨터에서 터미널을 열고 명령어를 붙여넣은 다음 Enter를 누르세요. 비밀번호는 묻지 않습니다. 연결되면 터미널에 터널의 엔드포인트가 표시됩니다.

    터미널
    +--------------------------------------------------------------+
    | Welcome to Localtonet!                                       |
    +--------------------------------------------------------------+
    | Localtonet Tunnel Endpoints                                  |
    +--------------------------------------------------------------+
    | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000               |
    | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000             |
    +--------------------------------------------------------------+
    | Server Time: ...                                             |
    +--------------------------------------------------------------+
    
    You can view your requests and configure your tunnel settings from the Localtonet Dashboard.

    TCP 터널은 대신 한 줄만 표시됩니다. TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>

  5. 창을 열어 두세요 #

    명령어가 연결되면 터널이 자동으로 시작되므로 시작을 선택할 필요가 없습니다. 터널은 명령어가 실행되는 동안에만 온라인 상태입니다. 창을 닫으면 연결이 끊기고 공개 주소가 응답하지 않습니다. 직접 명령어를 종료하려면 exit를 입력하고 Enter를 누르거나 Ctrl + C를 누르세요.

    명령어를 종료해도 대시보드의 터널은 중지되지 않습니다. 같은 명령어로 다시 연결할 수 있도록 터널은 시작된 상태로 남고 연결만 꺼진 상태로 표시됩니다. 터널 사용을 마치면 대시보드에서 해당 터널의 중지를 선택하세요. 대시보드는 중지된 터널에 대해서만 새 SSH 명령어를 발급합니다.

터널 설정 마법사에서 시작하기 #

대시보드의 터널 설정 마법사에서도 같은 명령어를 받을 수 있습니다. 플랫폼을 선택하는 마지막 단계에서 SSH를 선택한 다음 SSH 명령어 받기를 선택하세요. SSH 항목은 HTTP 및 TCP 터널에만 표시됩니다. 명령어가 연결될 때까지 마법사에는 SSH 대기 중이, 연결된 후에는 SSH로 연결됨이 표시됩니다. 자동 재연결은 같은 재연결 루프를 추가하고, 새 명령어 받기는 만료된 명령어를 교체합니다.

명령어 살펴보기 #

명령어는 항상 아래와 같은 형태이며, 값은 대시보드가 터널에 맞게 채워 줍니다.

Bash
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>
부분기능
-p 223Localtonet이 이 SSH 연결을 받는 223번 포트에 연결합니다.
-l <COMMAND_KEY>로그인 이름입니다. 대시보드가 이 터널을 위해 생성하는 키이며, AuthToken도 계정 비밀번호도 아닙니다. 이 키로 Localtonet이 어떤 터널을 시작할지 알 수 있으므로 비밀번호를 묻지 않습니다.
<TUNNEL_ADDRESS>터널의 주소입니다. SSH 연결은 이 터널을 호스팅하는 서버로 향합니다.
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>원격 포워딩입니다. 서버에서 터널로 들어오는 연결이 SSH 연결을 통해 <LOCAL_IP>:<LOCAL_PORT>로 전달됩니다. 마지막 두 값은 터널의 로컬 IP 주소와 로컬 포트입니다. 서버 포트는 Localtonet이 할당하므로 변경하면 안 됩니다.
-o ExitOnForwardFailure=yes포워딩을 설정할 수 없으면 동작하는 터널 없이 연결만 유지하는 대신 ssh가 종료되도록 합니다.
-o ServerAliveInterval=15 -o ServerAliveCountMax=315초마다 keep-alive를 보내고 응답이 없는 상태가 세 번 이어지면 연결을 끊습니다. 따라서 끊어진 연결을 약 45초 안에 알아챌 수 있습니다.
-o ConnectTimeout=15서버에 연결할 수 없으면 15초 후에 포기합니다.
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null호스트 키 확인 질문을 건너뛰며, 서버를 known_hosts 파일에 기록하지 않습니다.
-o LogLevel=ERRORssh의 정보성 메시지를 숨깁니다. 오류는 계속 표시됩니다.

<LOCAL_IP>는 ssh를 실행하는 컴퓨터에서 해석되므로 서비스가 그 컴퓨터에 있지 않아도 됩니다. 192.168.1.20 같은 로컬 주소를 사용하면 같은 네트워크의 다른 기기로 포워딩됩니다.

명령어를 공유하지 마세요. 명령어가 유효한 동안 이를 실행하는 사람이 내 터널의 트래픽에 응답하게 됩니다.

자동 재연결 #

자동으로 재연결을 켜면 대시보드가 같은 ssh 명령어를 선택한 셸에 맞는 작은 스크립트로 감쌉니다. 명령 프롬프트의 경우 스크립트는 powershell -NoProfile -EncodedCommand … 한 줄로 전달됩니다. 스크립트는 어떤 셸에서도 같은 방식으로 동작합니다.

  • ssh가 종료되면 잠시 기다린 뒤 다시 시작합니다. 대기 시간은 약 10초에서 시작해 시도에 실패할 때마다 두 배로 늘어나며 최대 약 2분입니다.
  • 60초 이상 유지된 연결은 성공으로 간주되어 대기 시간이 초기화됩니다.
  • 60초 미만에 끝나는 시도가 연속 8회 이어지면 중지하고 SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel. 메시지를 출력합니다.

재연결은 같은 명령어를 다시 사용합니다. 네트워크가 잠시 끊긴 경우에는 동작하지만, 대시보드에서 터널을 중지했거나 제한에 도달한 경우에는 동작하지 않습니다. 이때는 스크립트가 포기하므로 새 명령어가 필요합니다.

명령어의 유효 기간 #

  • 처음 사용하기 전: 명령어는 대시보드가 발급할 때 표시하는 시간 안에 실행해야 합니다. 그 시간이 지나면 포트 할당이 만료됩니다.
  • 사용 중: 터널 하나당 SSH 세션은 하나입니다. 첫 번째 명령어가 연결된 동안에는 같은 명령어를 한 번 더 실행해도 거부됩니다.
  • 연결이 끊긴 후: 터널을 대시보드에서 중지하지 않았고 제한에 도달하지 않았다면 같은 명령어로 다시 연결할 수 있습니다.
  • 중지된 후: 터널을 대시보드에서 중지했거나 제한 때문에 중지되면 해당 명령어는 더 이상 쓸 수 없습니다. SSH 명령어 보기를 다시 열어 새 명령어를 받으세요.

대시보드는 터널이 중지된 상태에서만 명령어를 발급합니다. 새 명령어에는 다른 서버 포트가 붙을 수 있으며, 무료 플랜에서는 새 명령어마다 새 포트가 할당됩니다. TCP 터널에서는 이 포트가 공개 주소의 일부이므로, 새 명령어를 요청한 후에는 터미널 출력이나 터널 목록에서 주소를 확인하세요. 변경 내용은 터널의 활동 로그에 Server port changed to "…" for SSH.로 기록됩니다.

제한 #

  • 무료 플랜의 세션 제한. SSH로 시작한 터널도 클라이언트로 시작한 터널과 같은 규칙을 따릅니다. 무료 플랜에서는 TCP 터널이 30분 후에 중지되며 다시 시작할 수 있고, HTTP 터널에는 시간 제한이 없습니다. 30분은 명령어가 처음 연결된 시점부터 계산되며, 같은 명령어로 다시 연결해도 초기화되지 않습니다. TCP 세션이 제한에 도달하면 서버가 Session time limit reached. Get a new SSH command from the panel. 메시지와 함께 SSH 연결을 닫습니다. 요금제와 잔액을 참고하세요.
  • 대역폭. 트래픽은 다른 터널 트래픽과 마찬가지로 대역폭에서 차감됩니다. 남은 대역폭이 없으면 명령어가 발급되지 않으며, 실행 중인 세션은 서버가 Bandwidth limit reached. Get a new command after bandwidth is available. 메시지와 함께 닫습니다.
  • 리버스 포워딩만 지원합니다. SSH 엔드포인트는 명령어에 포함된 포워딩 하나만 허용합니다. Localtonet 서버의 셸이나 다른 종류의 포워딩은 제공하지 않습니다.
  • 명령어 하나에 터널 하나. 터널을 여러 개 실행하려면 터널마다 명령어를 요청하고 각각 별도의 터미널에서 실행하세요.

대시보드에서 보이는 내용 #

명령어가 연결된 동안 터널은 시작된 상태로 표시되고, 요청은 평소처럼 로그에 나타납니다. 명령어가 연결되면 터널의 활동 로그에 Tunnel started over SSH.가 기록됩니다. 로그 및 검사를 참고하세요.

문제 해결 #

대시보드 메시지 #

메시지해결 방법
SSH 명령어를 요청하기 전에 터널을 중지하세요.터널이 Localtonet 클라이언트로 실행 중입니다. 클라이언트를 중지한 다음 SSH 명령어 보기를 다시 선택하세요.
새 명령을 요청하기 전에 현재 SSH 터널을 중지하세요.터널이 아직 SSH로 시작된 상태이거나 방금 전까지 터널의 SSH 세션이 활성 상태였습니다. 실행 중인 ssh 명령어를 종료하고 터널의 중지를 선택한 다음 다시 시도하세요.
생성한 AuthToken으로 이 터널에 클라이언트가 연결되어 있습니다. 새 AuthToken을 만드세요.Localtonet 클라이언트가 터널의 토큰으로 로그인되어 있습니다. 해당 클라이언트를 중지하거나 내 토큰에서 다른 토큰을 만들어 이 터널에 사용하세요.
터널을 시작하기에 남은 대역폭이 부족합니다.대역폭을 모두 사용했습니다. 요금제와 잔액을 참고하세요.
이 기능은 이 프로토콜 유형에서 사용할 수 없습니다.HTTP 또는 TCP 터널이 아닙니다.
이 서버에서는 이 기능을 사용할 수 없습니다. 터널을 다른 서버로 옮기세요.이 터널의 서버는 SSH 명령어를 제공하지 않습니다. 다른 서버에서 터널을 만드세요.
터널 작업이 진행 중입니다. 잠시 후 다시 시도하세요.몇 초 기다린 후 다시 시도하세요.
새 서버 포트를 할당할 수 없습니다.다시 시도하세요. 계속 실패하면 다른 서버에서 터널을 만드세요.
SSH 포트를 저장할 수 없습니다. 다시 시도하세요.다시 시도하세요.

터미널 메시지 #

서버가 세션을 닫을 때는 이유로 아래 메시지 중 하나를 보냅니다. 이유가 표시되는 방식은 사용하는 ssh 클라이언트에 따라 다릅니다.

메시지 또는 증상원인과 해결 방법
ssh가 곧바로 종료되며 인증 오류(보통 Permission denied)가 발생합니다Localtonet이 명령어를 받아들이지 않았습니다. 제때 실행하지 않았거나, 발급 후 터널이 중지되었거나 제한에 도달했거나, 같은 명령어의 다른 세션이 이미 연결되어 있거나, 복사하는 중에 텍스트가 바뀐 경우입니다. 대시보드에서 새 명령어를 받아 수정하지 말고 그대로 붙여넣으세요.
Port mismatch. Get a new SSH command from the panel.-R 뒤의 서버 포트가 Localtonet이 할당한 포트가 아닙니다. 명령어를 발급된 그대로 사용하세요.
Session time limit reached. Get a new SSH command from the panel.무료 플랜에서 TCP 터널의 30분 세션이 끝났습니다. 다시 시작하려면 새 명령어를 요청하세요.
Bandwidth limit reached. Get a new command after bandwidth is available.대역폭을 모두 사용했습니다.
Session stopped. Get a new SSH command from the panel.예를 들어 대시보드에서 터널이 중지되었습니다.
연결 시간 초과 또는 Connection refused컴퓨터가 223번 포트의 서버에 접근할 수 없습니다. 방화벽에서 223번 포트로의 아웃바운드 TCP 연결을 허용하거나 다른 네트워크에서 시도하세요.
터널은 활성 상태인데 방문자에게 오류가 표시됩니다ssh는 연결되어 있지만 서비스에 접근할 수 없습니다. 서비스가 실행 중인지, 터널의 로컬 IP 주소와 로컬 포트가 올바른지 확인하세요. 값을 변경한 후에는 이전 명령어에 이전 값이 남아 있으므로 새 명령어를 요청하세요.

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

지원