Localtonet 클라이언트 설치
이 페이지의 내용 섹션 5개
Localtonet 클라이언트는 서비스를 호스팅하는 기기에서 실행되며 Localtonet으로 연결되는 터널을 열어 둡니다. 이 페이지에서는 지원하는 플랫폼을 소개하고, 알맞은 설치 방식을 고르도록 돕고, 각 방식의 가이드로 안내합니다.
지원하는 플랫폼 #
모든 다운로드는 다운로드 페이지에 있습니다.
| 플랫폼 | 설치할 수 있는 것 | 아키텍처 |
|---|---|---|
| Windows | Microsoft Store 앱, 포터블 데스크톱 앱, 콘솔 클라이언트 | 64비트(x64), 32비트(x86), ARM64 |
| macOS | 콘솔 클라이언트(Homebrew 또는 ZIP 아카이브) | Intel(x64), Apple Silicon(ARM64) |
| Linux | 콘솔 클라이언트(설치 스크립트 또는 ZIP 아카이브) | x64, ARM, ARM64, 각각 glibc용과 musl용 |
| Linux 패키지 | systemd 서비스가 포함된 DEB 및 RPM 패키지 | x64, ARM64 |
| Android | Google Play 또는 APK 파일로 설치하는 Android 앱 | 앱의 최소 Android 버전은 5.0입니다. |
| Termux | Termux 패키지로 설치하는 콘솔 클라이언트 | ARM64 |
| Docker | 공식 이미지 localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | OpenWrt 24.10 및 25.12+용 라우터 패키지(실험적) | x64, ARM64 |
| NAS 및 Home Assistant | Docker Compose 및 Home Assistant 설정 템플릿 | AMD64, ARM64 |
| 설치 없는 SSH | 없음. 이미 가지고 있는 SSH 클라이언트를 사용합니다. | SSH 클라이언트가 있는 모든 기기 |
설치 방식 선택 #
| 옵션 | 설명 | 이럴 때 선택하세요 |
|---|---|---|
| 콘솔 클라이언트 | Windows, macOS, Linux용 localtonet 프로그램입니다. 터미널에서 AuthToken으로 시작하며, 터널을 실시간 표로 보여 주고 스스로 서비스로 설치할 수도 있습니다. | 터미널에서 작업하거나, 기기가 데스크톱이 없는 서버일 때. |
| 데스크톱 앱 | 로그인 창이 있는 Windows용 Localtonet 앱으로, Microsoft Store 또는 포터블 ZIP으로 받을 수 있습니다. | Windows에서 터미널보다 앱 창을 선호할 때. |
| 모바일 앱 | Android용 Localtonet 앱입니다. QR 코드, PIN 또는 토큰으로 로그인합니다. | 모바일 프록시처럼 기기가 Android 휴대폰이나 태블릿일 때. |
| 패키지 | Linux용 DEB 및 RPM 패키지, Android용 Termux 패키지, OpenWrt용 실험적 패키지입니다. Linux와 OpenWrt 패키지에는 파일에서 토큰을 읽는 서비스가 함께 제공됩니다. | 시스템의 패키지 관리자로 클라이언트를 설치하고 제거하며, 부팅 시 시작되는 서비스를 원할 때. |
| 컨테이너 | 공식 Docker 이미지와, 이를 사용하는 NAS 기기 및 Home Assistant용 설정 템플릿입니다. | 서비스가 이미 컨테이너에서 실행되거나 기기가 NAS일 때. |
| 설치 없는 SSH | 대시보드가 터널을 여는 ssh 명령을 생성합니다. 다운로드가 필요 없습니다. HTTP와 TCP 터널에서 제공됩니다. | 기기에 아무것도 설치할 수 없거나 설치하고 싶지 않을 때. |
모든 설치의 공통점 #
-
클라이언트는 AuthToken으로 로그인합니다 #
AuthToken은 기기 하나를 내 계정에 연결합니다. 대시보드의 AuthToken 카드에서 복사로 복사하거나, 내 토큰에서 기기마다 이름을 붙인 토큰을 만드세요. 토큰은 AuthToken에서 설명합니다.
토큰을 비공개로 유지하세요. 토큰이 있으면 누구든 앱에 로그인할 수 있습니다.
-
그 토큰으로 클라이언트를 시작합니다 #
<YOUR_TOKEN>을 사용자의 토큰으로 바꾸세요.Windows
Localtonet 앱을 열고 AuthToken을 붙여넣거나,
localtonet.exe가 들어 있는 폴더에서 명령 프롬프트로 콘솔 클라이언트를 실행하세요.명령 프롬프트localtonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker pull localtonet/localtonet docker run localtonet/localtonet --authtoken <YOUR_TOKEN>Android
Localtonet 앱을 연 다음 토큰의 QR 코드를 스캔하거나, PIN을 입력하거나, 토큰을 붙여넣고 Connect를 선택하세요. QR 코드와 PIN은 내 토큰에 있습니다.
콘솔 클라이언트는 토큰을 로컬에 저장하므로 다음부터는
localtonet만으로 시작할 수 있습니다. 저장된 토큰 없이 시작하면Please Enter AuthToken or PIN이라고 묻습니다. -
터널은 대시보드에서 만들고 시작합니다 #
클라이언트가 터널을 미리 알아야 할 필요는 없습니다. 내 터널에서 터널을 만들고 기기 토큰을 선택하면, 그 토큰으로 로그인한 클라이언트가 해당 터널을 제공합니다. 빠른 시작에서 첫 터널을 만드는 과정을 안내합니다.
-
클라이언트는 계속 실행 중이어야 합니다 #
클라이언트가 AuthToken으로 실행 중이고 터널이 시작되면 터널이 활성화됩니다. 내 토큰에는 각 기기가 온라인 또는 오프라인으로 표시됩니다. 오프라인은 터널이 설정되어 있더라도 기기의 연결이 끊어졌다는 뜻입니다.
터미널을 닫거나, 로그아웃하거나, 기기를 다시 시작한 뒤에도 클라이언트가 계속 실행되게 하려면 서비스로 설치하세요.
플랫폼 방법 Windows 관리자 권한으로 실행한 터미널에서 localtonet --install-service --authtoken <YOUR_TOKEN>macOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>DEB, RPM, OpenWrt 패키지 패키지에 서비스가 포함되어 있습니다. 토큰을 설정한 뒤 서비스를 활성화하세요. Android 앱은 백그라운드에서 계속 실행되며 휴대폰을 다시 시작하면 자동으로 다시 열립니다. 자세한 내용은 서비스로 실행과 각 플랫폼 페이지에 있습니다.
클라이언트를 최신 상태로 유지하세요 #
내 토큰의 클라이언트 열에는 각 기기가 마지막으로 보고한 버전이 표시됩니다. 더 새로운 버전이 있으면 업데이트 필요 배지가 다운로드 페이지로 연결됩니다. 콘솔 클라이언트도 터널 표 아래에 New Version available을 표시하며, localtonet --version은 설치된 버전을 출력합니다.