Termux에 Localtonet 설치하기
이 페이지의 내용 섹션 8개
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를 선택하세요.
설치 #
-
설치 스크립트 실행하기 #
Linux용 설치 스크립트는 Termux를 인식합니다. Termux 패키지를 다운로드하고
pkg로 설치하며, 이때 런타임도 함께 설치됩니다.Termuxcurl -fsSL https://localtonet.com/install.sh | shcurl이 아직 설치되어 있지 않다면 먼저pkg install curl로 설치하세요. -
설치 확인하기 #
스크립트는 마지막에 설치된 버전을 출력합니다. 언제든지 다시 출력할 수 있습니다.
Termuxlocaltonet --version
다운로드한 패키지로 대신 설치하기 #
패키지는 이 페이지 끝에 나열되어 있습니다. DEB 파일과, 같은 DEB가 들어 있는 ZIP 아카이브입니다. 둘 중 하나를 Termux에서 다운로드하고, ZIP을 받았다면 압축을 푼 다음 Termux 패키지 관리자로 DEB를 설치하세요. <PACKAGE_FILE>을 DEB 파일 이름으로 바꾸세요.
pkg install ./<PACKAGE_FILE>.deb누락된 의존성도 함께 다운로드되도록 이때는 pkg를 사용하세요. 아래 목록의 ZIP 패키지 설치에 실제 파일 이름이 들어간 명령이 있습니다.
클라이언트 시작하기 #
-
토큰으로 시작하기 #
Termuxlocaltonet --authtoken <YOUR_TOKEN>클라이언트는 토큰을 로컬에 저장합니다. 다음부터는
localtonet만으로 시작할 수 있습니다. 저장된 토큰 없이 시작하면Please Enter AuthToken or PIN이라고 묻습니다. 이 프롬프트에는 내 토큰에 토큰별로 표시되는 6자리 PIN을 입력할 수도 있습니다. PIN은 1분 동안 유효합니다. -
출력 읽기 #
Termux에서 클라이언트는 데스크톱 빌드처럼 실시간 표를 그리지 않습니다. 변경 사항마다 일반 텍스트 한 줄을 씁니다.
줄 의미 Connection: Connected세션의 상태입니다. 다른 값으로 Connecting과Disconnected가 있습니다.AuthTokenName: …클라이언트가 로그인한 토큰의 이름입니다. OPEN …,ADDED …이 기기에서 실행되는 터널로, 공개 주소, 프로토콜, 로컬 대상이 표시됩니다. STATUS …터널의 상태가 바뀌었습니다. CLOSED …터널이 중지되었거나 제거되었습니다. Authentication failed: AuthToken was rejected.토큰이 받아들여지지 않았습니다. 내 토큰에서 다시 복사하세요. -
터널 시작하기 #
이제 내 토큰에서 토큰이 온라인으로 표시됩니다. 대시보드에서 이 토큰용 터널을 만들고 시작하세요. 빠른 시작을 참고하세요.
127.0.0.1로 향하는 터널은 휴대폰 자체에서 실행되는 서비스, 예를 들어 Termux 안의 서비스에 도달합니다.
Ctrl + C를 누르면 클라이언트가 중지됩니다. 다른 토큰으로 로그인하려면 새 --authtoken으로 클라이언트를 다시 시작하세요.
제한 #
| 항목 | Termux에서 |
|---|---|
| CPU | ARM64만 지원합니다. |
| 서비스 모드 | 지원되지 않습니다. --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입니다.
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로 설치할 수 있습니다. 누락된 의존성을 설치하려면 인터넷 연결이 필요합니다.