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

Termux에 Localtonet 설치하기

이 페이지 도움받기
이 페이지의 내용 섹션 8개
  1. 시작하기 전에
  2. 설치
  3. 설치 스크립트 실행하기
  4. 설치 확인하기
  5. 다운로드한 패키지로 대신 설치하기
  6. 클라이언트 시작하기
  7. 토큰으로 시작하기
  8. 출력 읽기
  9. 터널 시작하기
  10. 제한
  11. 업그레이드
  12. 제거
  13. 문제 해결
  14. 관련 페이지

Termux는 Android용 터미널 앱입니다. Termux 패키지는 Localtonet 앱 없이 ARM64 Android 기기에서 Localtonet 콘솔 클라이언트, 즉 Linux와 같은 localtonet 명령을 실행합니다.

시작하기 전에 #

  • ARM64 CPU를 사용하는 Android 기기와 설치된 Termux가 필요합니다. 이 패키지는 ARM64 전용으로 빌드되었습니다.
  • Termux에서 인터넷에 연결되어 있어야 합니다. 이 패키지에는 Termux의 .NET 10 런타임(dotnet-runtime-10.0)이 필요하며, Termux 패키지 관리자가 Localtonet과 함께 자동으로 설치합니다. ASP.NET Core는 필요하지 않습니다.
  • AuthToken이 필요합니다. 대시보드의 AuthToken 카드에서 복사를 선택하거나, 내 토큰에서 토큰을 복사하세요. 기기마다 별도의 토큰을 사용하세요.

Termux와 Android 앱 중 무엇을 쓸까요? Android 앱은 QR 코드나 PIN으로 로그인하며 백그라운드에서 스스로 계속 실행됩니다. 휴대폰에서 명령줄 클라이언트를 쓰고 싶을 때 Termux를 선택하세요.

설치 #

  1. 설치 스크립트 실행하기 #

    Linux용 설치 스크립트는 Termux를 인식합니다. Termux 패키지를 다운로드하고 pkg로 설치하며, 이때 런타임도 함께 설치됩니다.

    Termux
    curl -fsSL https://localtonet.com/install.sh | sh

    curl이 아직 설치되어 있지 않다면 먼저 pkg install curl로 설치하세요.

  2. 설치 확인하기 #

    스크립트는 마지막에 설치된 버전을 출력합니다. 언제든지 다시 출력할 수 있습니다.

    Termux
    localtonet --version

다운로드한 패키지로 대신 설치하기 #

패키지는 이 페이지 끝에 나열되어 있습니다. DEB 파일과, 같은 DEB가 들어 있는 ZIP 아카이브입니다. 둘 중 하나를 Termux에서 다운로드하고, ZIP을 받았다면 압축을 푼 다음 Termux 패키지 관리자로 DEB를 설치하세요. <PACKAGE_FILE>을 DEB 파일 이름으로 바꾸세요.

Termux
pkg install ./<PACKAGE_FILE>.deb

누락된 의존성도 함께 다운로드되도록 이때는 pkg를 사용하세요. 아래 목록의 ZIP 패키지 설치에 실제 파일 이름이 들어간 명령이 있습니다.

클라이언트 시작하기 #

  1. 토큰으로 시작하기 #

    Termux
    localtonet --authtoken <YOUR_TOKEN>

    클라이언트는 토큰을 로컬에 저장합니다. 다음부터는 localtonet만으로 시작할 수 있습니다. 저장된 토큰 없이 시작하면 Please Enter AuthToken or PIN이라고 묻습니다. 이 프롬프트에는 내 토큰에 토큰별로 표시되는 6자리 PIN을 입력할 수도 있습니다. PIN은 1분 동안 유효합니다.

  2. 출력 읽기 #

    Termux에서 클라이언트는 데스크톱 빌드처럼 실시간 표를 그리지 않습니다. 변경 사항마다 일반 텍스트 한 줄을 씁니다.

    줄의미
    Connection: Connected세션의 상태입니다. 다른 값으로 Connecting과 Disconnected가 있습니다.
    AuthTokenName: …클라이언트가 로그인한 토큰의 이름입니다.
    OPEN …, ADDED …이 기기에서 실행되는 터널로, 공개 주소, 프로토콜, 로컬 대상이 표시됩니다.
    STATUS …터널의 상태가 바뀌었습니다.
    CLOSED …터널이 중지되었거나 제거되었습니다.
    Authentication failed: AuthToken was rejected.토큰이 받아들여지지 않았습니다. 내 토큰에서 다시 복사하세요.
  3. 터널 시작하기 #

    이제 내 토큰에서 토큰이 온라인으로 표시됩니다. 대시보드에서 이 토큰용 터널을 만들고 시작하세요. 빠른 시작을 참고하세요. 127.0.0.1로 향하는 터널은 휴대폰 자체에서 실행되는 서비스, 예를 들어 Termux 안의 서비스에 도달합니다.

Ctrl + C를 누르면 클라이언트가 중지됩니다. 다른 토큰으로 로그인하려면 새 --authtoken으로 클라이언트를 다시 시작하세요.

제한 #

항목Termux에서
CPUARM64만 지원합니다.
서비스 모드지원되지 않습니다. --install-service에는 systemd와 root 권한이 필요하며 Termux는 지원되지 않습니다. 클라이언트는 Termux 세션이 열려 있는 동안 실행됩니다. 터미널을 열어 두지 않고 휴대폰을 연결된 상태로 유지하려면 대신 Android 앱을 사용하세요.
백그라운드화면이 꺼져 있는 동안 Android가 Termux를 중지할 수 있습니다. Termux에는 이를 위한 자체 웨이크 락 termux-wake-lock이 있습니다.
로그인명령줄에서 토큰 또는 PIN을 사용합니다. QR 코드는 Android 앱용입니다.

업그레이드 #

설치 스크립트를 다시 실행하거나, 최신 DEB를 다운로드해 이전처럼 pkg install로 설치하세요. 같은 버전을 한 번 더 설치하려면 pkg reinstall ./<PACKAGE_FILE>.deb를 사용하세요.

내 토큰의 클라이언트 열에는 기기가 마지막으로 보고한 버전이 표시되며, 더 새로운 버전이 있으면 업데이트 필요 배지가 표시됩니다.

제거 #

패키지 이름은 termux-localtonet입니다.

Termux
pkg uninstall termux-localtonet

문제 해결 #

Termux .NET runtime bulunamadı. Çalıştırın: pkg install dotnet-runtime-10.0

런처의 이 메시지는 터키어로 되어 있으며, Termux의 .NET 런타임을 찾을 수 없다는 뜻입니다. pkg install dotnet-runtime-10.0으로 설치한 다음 localtonet을 다시 시작하세요. DEB를 의존성을 다운로드하지 않는 dpkg -i로 설치했을 때 나타날 수 있습니다.

localtonet.dll bulunamadı. Localtonet paketini yeniden kurun.

런처가 클라이언트 파일을 찾지 못했습니다. Localtonet 패키지를 다시 설치하세요.

패키지 관리자가 패키지를 설치할 수 없습니다

이 패키지는 ARM64용이며 Termux 저장소의 dotnet-runtime-10.0 10.0.15 이상 버전이 필요합니다. pkg upgrade를 실행해 Termux를 최신 상태로 만든 다음 패키지를 다시 설치하세요. ARM64가 아닌 기기에서는 Android 앱을 사용하세요.

Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.

Termux에서는 서비스 모드가 지원되지 않습니다. Termux 세션에서 클라이언트를 시작하거나 Android 앱을 사용하세요.

Wrong Token!

클라이언트는 내 토큰의 33자 AuthToken 또는 만료되지 않은 6자리 PIN을 요구합니다. 토큰을 다시 복사해 프롬프트에 입력하세요.

Termux 패키지는 아래에 나열되어 있습니다.

Android용 Termux

ARM64 Android 기기의 Termux에서 콘솔 클라이언트를 실행하세요. 필요한 .NET 런타임은 패키지 관리자가 자동으로 설치합니다. ASP.NET Core는 필요하지 않습니다.

ZIP 패키지 설치
curl -fLO https://localtonet.com/download/localtonet-termux.zip
unzip -o localtonet-termux.zip
pkg install ./localtonet.deb
localtonet --authtoken <YOUR_TOKEN>

직접 다운로드한 DEB는 pkg install ./localtonet-termux.deb로 설치할 수 있습니다. 누락된 의존성을 설치하려면 인터넷 연결이 필요합니다.

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

지원