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

특정 네트워크로 터널 보내기

이 페이지 도움받기
이 페이지의 내용 섹션 10개
  1. 시작하기 전에
  2. 단계
  3. 기기의 네트워크 나열하기
  4. 터널의 인수 설정 열기
  5. 네트워크 입력하기
  6. 저장
  7. 텍스트 형식의 인수
  8. 선택한 네트워크의 용도
  9. 네트워크를 사용할 수 없을 때
  10. 클라이언트 전체에 네트워크 선택하기
  11. 예시: 모뎀 두 개에 프록시 두 개
  12. API로 같은 설정하기
  13. 문제 해결
  14. 관련 페이지

기기에 두 번째 회선이나 USB 모뎀처럼 인터넷 연결이 둘 이상 있으면, 터널 하나를 특정 네트워크로 보낼 수 있습니다. 다른 터널은 계속 기본 연결을 사용합니다. 네트워크는 이름과 그 네트워크에서의 기기 IP 주소, 두 값으로 선택합니다.

시작하기 전에 #

  • 활성 네트워크가 두 개 이상 있고 Localtonet 클라이언트가 설치된 기기. 설치를 참고하세요.
  • 인수 설정이 있는 유형의 터널: HTTP, TCP - UDP, TLS 또는 프록시 서버.
  • Linux에서는 클라이언트를 root 권한으로 실행하거나 비밀번호 없는 sudo로 실행하세요. 클라이언트는 ip 명령으로 선택한 네트워크의 라우팅 규칙을 추가하며, 이 권한이 없으면 트래픽이 기본 경로로 나갈 수 있습니다.

단계 #

  1. 기기의 네트워크 나열하기 #

    기기에서 다음을 실행하세요.

    터미널
    localtonet --network

    이 명령에는 AuthToken이 필요 없습니다. 활성 네트워크를 IP 주소와 함께 모두 나열하고, 각 IPv4 주소의 인터넷 접속 여부를 확인한 뒤 종료합니다.

    출력
    NetworkName: Ethernet 2
    --net Ethernet 2 --ip 192.168.8.100   --> Internet available (public IP 203.0.113.25)
    --------------------------------------------------
    NetworkName: Wi-Fi
    --net Wi-Fi --ip 192.168.1.20   --> Internet available (public IP 198.51.100.7)
    --net Wi-Fi --ip 2001:db8::20   --> IPv6, internet check not available
    --------------------------------------------------

    --net으로 시작하는 각 줄은 네트워크 이름과 IP 주소의 쌍으로, 그대로 사용할 수 있습니다. 사용할 네트워크의 쌍을 기록해 두세요. No internet access로 끝나는 줄은 인터넷 확인에 실패한 주소입니다. 목록 뒤에는 --net과 --ip에 대한 짧은 설명이 출력됩니다.

  2. 터널의 인수 설정 열기 #

    대시보드에서 터널 유형의 페이지를 열고, 터널 행의 설정을 선택한 다음 인수 › 관리를 선택합니다. 네트워크 선택 대화상자가 열립니다.

  3. 네트워크 입력하기 #

    특정 네트워크 사용을 켜고 두 필드를 모두 입력합니다.

    필드입력할 내용예시
    네트워크 이름localtonet --network가 NetworkName: 뒤에 출력하는 이름 그대로입니다.Ethernet 2
    해당 네트워크의 기기 IP그 네트워크에서 기기가 사용하는 IPv4 또는 IPv6 주소이며, 해당 네트워크의 --net 줄에 나온 값입니다.192.168.8.100

    앱으로 전송되는 값에는 결과로 만들어지는 인수가 표시됩니다(예: --net Ethernet 2 --ip 192.168.8.100).

  4. 저장 #

    저장을 선택합니다. 실행 중인 터널은 다시 시작되며 이후 선택한 네트워크를 사용합니다.

텍스트 형식의 인수 #

텍스트로 편집을 선택하면 대화상자가 하나의 인수 필드로 바뀌고, 양식 사용을 선택하면 다시 돌아옵니다. 텍스트 형식은 다음과 같습니다.

--net <NETWORK_NAME> --ip <IP_ADDRESS>
  • --net과 --ip는 함께 지정해야 합니다. 하나만 있으면 터널에 고유한 네트워크가 없는 것으로 처리되어, 기본 네트워크 또는 클라이언트 전체에 선택된 네트워크를 사용합니다.
  • 공백이 있는 네트워크 이름은 그대로 쓰거나 따옴표로 묶어 쓸 수 있습니다. --net Wi-Fi 2 --ip 192.168.1.5와 --net "Wi-Fi 2" --ip 192.168.1.5는 같은 뜻입니다.
  • 이름은 먼저 정확히 일치하는지 확인합니다. 대소문자만 다른 이름은 정확히 하나의 네트워크와 맞을 때 허용됩니다.
  • IP 주소는 기기가 해당 네트워크에서 현재 가지고 있는 주소여야 합니다.

선택한 네트워크의 용도 #

  • 기기에서 Localtonet 서버로 가는 터널의 연결.
  • 프록시 터널의 경우 기기에서 인터넷으로 직접 나가는 트래픽과 그에 대한 DNS 조회. 프록시 터널에 업스트림 설정이 있으면 업스트림 프록시로의 연결은 선택한 네트워크에 바인딩되지 않습니다.
  • 로컬 서비스가 선택한 네트워크로 접근되는 경우 그 서비스로의 연결. 기기 자체의 서비스(127.0.0.1)나 다른 로컬 네트워크의 서비스는 일반적인 방식으로 접속합니다.

네트워크를 사용할 수 없을 때 #

선택한 네트워크가 없으면 터널은 기본 연결로 대체되지 않고 연결을 닫은 상태로 유지합니다. 프록시에서는 이 점이 중요합니다. 트래픽이 선택하지 않은 다른 회선으로 나가서는 안 되기 때문입니다.

  • 터널이 시작될 때 네트워크가 없으면 터널은 네트워크가 생길 때까지 기다립니다.
  • 나중에 네트워크가 사라지면 네트워크 이름과 IP 주소의 쌍을 다시 사용할 수 있을 때까지 터널의 연결이 닫힌 채로 유지됩니다. 클라이언트는 몇 초마다, 그리고 기기의 네트워크가 바뀔 때 다시 확인하며 터널은 스스로 재개됩니다.
  • 기기가 해당 네트워크에서 다른 IP 주소를 받으면 쌍이 더 이상 일치하지 않아 터널이 닫힌 상태로 유지됩니다. 기기에 그 네트워크의 고정 주소를 지정하거나 설정을 업데이트하세요.

토큰과 --debug로 클라이언트를 시작하면(localtonet --authtoken <YOUR_TOKEN> --debug) 오류 출력에서 이유를 확인할 수 있습니다. 이 줄은 타임스탬프와 [debug][proxy]로 시작하며, 이어서 터널의 내부 식별자, 문제, 터널이 기다리는 쌍이 표시됩니다.

클라이언트 출력
[2026-11-14 10:15:30.123 UTC][debug][proxy] Tunnel <TUNNEL_IDENTIFIER>: Network interface 'Ethernet 2' was not found. Run 'localtonet --network' to list the interfaces. Its connections stay closed until --net Ethernet 2 --ip 192.168.8.100 is available.

그 밖에 표시될 수 있는 문제로는 "'192.168.8.100' is not an address of network interface 'Ethernet 2'.", "Network interface 'Ethernet 2' is Down.", "The --ip value is not an IP address."가 있습니다.

클라이언트 전체에 네트워크 선택하기 #

클라이언트 자체의 연결과, 고유한 네트워크가 없는 모든 터널에 네트워크 하나를 선택하려면 클라이언트를 시작할 때 같은 두 옵션을 전달하세요.

터미널
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>
  • 두 옵션이 모두 필요합니다. 하나만 있으면 클라이언트는 "--net and --ip must be given together; the default network is used."라고 출력하고 기본 네트워크로 계속 실행됩니다.
  • 시작할 때 네트워크를 사용할 수 없으면 클라이언트는 최대 30초 동안 기다린 다음, 다른 네트워크에서 실행하는 대신 이유를 표시하며 중지됩니다.
  • 인수에 자체 네트워크가 있는 터널은 그 네트워크를 사용합니다. 클라이언트 옵션은 자체 네트워크가 없는 터널에 적용됩니다.

모든 명령줄 옵션은 CLI 참조에 나와 있습니다.

예시: 모뎀 두 개에 프록시 두 개 #

컴퓨터에 USB 모뎀이 두 개 있습니다. localtonet --network는 --net Modem A --ip 192.168.8.100과 --net Modem B --ip 192.168.9.100을 출력합니다. 기기의 AuthToken으로 프록시 서버 터널을 두 개 만듭니다. 첫 번째 터널에서는 인수 › 관리를 열어 Modem A와 192.168.8.100을 입력하고, 두 번째 터널에서는 Modem B와 192.168.9.100을 입력합니다. 이제 각 프록시는 자신의 모뎀으로 나가며, 모뎀을 뽑으면 해당 프록시는 트래픽 전달을 멈춥니다.

API로 같은 설정하기 #

터널의 인수는 /api/v2/tunnels/<TUNNEL_ID>/arguments에서 읽고(GET) 설정(PATCH)할 수 있습니다. 값을 비워 보내면 인수가 제거됩니다. API로 설정한 값은 터널이 다음에 시작될 때 사용됩니다. API를 참고하세요.

요청 본문
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }

문제 해결 #

“네트워크 이름을 입력하세요.” 또는 “해당 네트워크에서의 기기 IP 주소를 입력하세요.”

특정 네트워크 사용이 켜져 있는 동안에는 두 필드가 모두 필요합니다. 특정 네트워크 사용을 중단하려면 스위치를 끄고 저장하세요.

“192.168.8.100 같은 IP 주소를 입력하세요.”

두 번째 필드에는 네트워크 이름이나 공용 IP 주소가 아니라, 그 네트워크에서의 기기 IP 주소를 입력합니다.

"기기 연결을 확인하세요."

저장하면 실행 중인 터널이 다시 시작되는데, 해당 기기의 Localtonet 앱이 연결되어 있지 않습니다. 앱을 시작하거나, 터널을 중지한 뒤 다시 저장하세요.

터널은 시작되었지만 트래픽이 전달되지 않습니다

선택한 네트워크를 사용할 수 없는 것일 가능성이 큽니다. 기기에서 localtonet --network를 실행해 이름과 IP 주소를 설정과 비교하세요. 설정을 바로잡거나 네트워크를 다시 연결하세요.

Linux에서 트래픽이 여전히 기본 경로로 나갑니다

클라이언트가 라우팅 규칙을 추가하지 못했을 가능성이 큽니다. root 권한으로 실행하거나 ip 명령에 대해 비밀번호 없는 sudo를 허용한 다음 클라이언트를 다시 시작하세요. 게이트웨이가 없다고 보고하는 네트워크에는 규칙을 추가하지 않습니다.

localtonet --network가 "No active network interface with an IP address was found."를 출력합니다

기기에 켜져 있고 주소가 있는 네트워크가 없습니다. 네트워크에 연결한 다음 명령을 다시 실행하세요.

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

지원