Linux에 Localtonet 설치하기
이 페이지의 내용 섹션 9개
Linux에서 Localtonet 클라이언트는 단일 콘솔 프로그램입니다. 설치 스크립트나 ZIP 아카이브로 설치하고, AuthToken으로 시작하며, 재부팅할 때마다 시작되어야 한다면 systemd 서비스로 설치하세요.
시작하기 전에 #
- Localtonet 계정이 필요합니다. 없다면 무료로 만드세요.
- AuthToken이 필요합니다. 대시보드의 AuthToken 카드에서 복사를 선택하거나, 내 토큰에서 토큰을 복사하세요.
curl또는wget, 그리고unzip.- systemd 서비스의 경우: root 권한, 그리고 systemd를 사용하는 배포판이 필요합니다.
Linux에서 Localtonet을 실행하는 다른 방법. Debian, Ubuntu, Fedora, RHEL에서는 자체 서비스가 포함된 DEB 또는 RPM 패키지를 설치할 수 있습니다. Docker, OpenWrt 라우터, Android의 Termux용 가이드는 따로 있습니다.
스크립트로 설치하기 #
-
설치 스크립트 실행하기 #
터미널curl -fsSL https://localtonet.com/install.sh | sh스크립트는 CPU(x64, ARM64 또는 ARM)와 시스템이 glibc를 쓰는지 musl을 쓰는지 감지하고, 맞는 빌드를 다운로드해
/usr/local/bin/localtonet에 설치합니다. 또한/usr/bin/localtonet링크도 만들어,sudo가/usr/local/bin을 검색하지 않는 배포판에서도sudo localtonet이 작동하게 합니다.스크립트는 현재 사용자가 설치 폴더에 쓸 수 없을 때
sudo를 사용하므로 비밀번호를 물을 수 있습니다.unzip이 없으면 배포판의 패키지 관리자로 설치를 시도합니다. -
설치 확인하기 #
스크립트는 마지막에 설치된 버전을 출력합니다. 언제든지 다시 출력할 수 있습니다.
터미널localtonet --version
수동으로 설치하기 #
직접 다운로드하려면 내 시스템에 맞는 아카이브를 받으세요. 각 ZIP에는 localtonet 파일 하나가 들어 있습니다.
| CPU | glibc (Debian, Ubuntu, Fedora, RHEL 및 대부분의 배포판) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32비트) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m은 CPU 유형을 출력합니다. x86_64는 x64, aarch64는 ARM64, armv7l은 ARM입니다.
-
다운로드하고 압축 해제하기 #
예제는 x64 glibc 빌드를 사용합니다. 파일 이름을 내 시스템에 맞는 아카이브로 바꾸세요.
터미널wget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
선택 사항: PATH로 옮기기 #
이 단계를 건너뛰면 클라이언트를 경로로 시작해야 합니다.
~/localtonet/localtonet. 옮겨 두면 어느 폴더에서든localtonet을 입력할 수 있습니다.터미널sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
클라이언트 시작하기 #
-
토큰으로 시작하기 #
터미널localtonet --authtoken <YOUR_TOKEN>클라이언트는 토큰을 현재 사용자용으로 로컬에 저장합니다. 다음부터는
localtonet만으로 시작할 수 있습니다. 저장된 토큰 없이 시작하면Please Enter AuthToken or PIN이라고 묻습니다. -
세션 확인하기 #
터미널에는
Session Status: Connected가 표시되고, 그 아래 표에 실행 중인 터널마다 한 행씩 나타납니다. 열은IP/Url,Protocol,Client IP,Client Port,Ping,Status입니다. 대시보드에서 터널을 시작하기 전에는 표가 비어 있습니다. 빠른 시작을 참고하세요.Ctrl + C를 누르면 클라이언트가 중지됩니다. F12를 누르면 저장된 토큰을 제거하고 종료합니다.
출력이 터미널이 아닐 때(예: 파일로 리디렉션할 때) 클라이언트는 표 대신 변경 사항마다 일반 텍스트 한 줄을 씁니다.
VPN에는 root가 필요합니다. 기기가 VPN 매니저 네트워크에 속해 있는데 클라이언트가 root 없이 실행되면, 표의 VPN 행에 Admin rights required.가 표시됩니다. 이 경우 클라이언트를 sudo로 또는 서비스로 시작하세요.
systemd 서비스로 실행하기 #
서비스는 재부팅할 때마다 Localtonet을 시작하고, 로그아웃한 뒤에도 계속 실행하며, 열린 터미널이 필요하지 않습니다. 서비스 명령에는 root가 필요합니다.
-
서비스 설치하기 #
터미널sudo localtonet --install-service --authtoken <YOUR_TOKEN>이 명령은 이 토큰용 systemd 유닛을 작성하고, 활성화하고, 즉시 시작합니다. 유닛 이름이 응답으로 표시됩니다.
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>는 토큰의 처음 9자입니다. 토큰마다 고유한 유닛이 생기므로, 다른 서비스 명령도 유닛을 찾으려면 같은--authtoken이 필요합니다. -
실행 중인지 확인하기 #
터미널sudo localtonet --status-service --authtoken <YOUR_TOKEN>실행 중인 서비스는
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running이라고 응답합니다. 대시보드의 내 토큰에서 해당 토큰이 온라인으로 표시됩니다.
서비스 명령 #
각 명령을 sudo로 실행하고 --authtoken <YOUR_TOKEN>을 추가하세요.
| 명령 | 기능 |
|---|---|
--install-service | 유닛 파일을 작성하고, 유닛을 활성화하고, 시작합니다. |
--start-service | 유닛을 시작합니다. 예를 들어 유닛을 중지한 뒤에 사용합니다. |
--stop-service | 유닛을 중지합니다. 유닛은 활성화된 상태로 남아 있으며 재부팅 후 다시 시작됩니다. |
--status-service | 상태를 출력합니다. 예를 들어 Running, Stopped, 유닛이 실패했을 때는 Error입니다. |
--remove-service | 유닛을 중지하고 비활성화한 다음 유닛 파일을 삭제합니다. |
서비스는 --install-service와 함께 전달한 옵션으로 설치됩니다. 옵션은 CLI 참조에 나와 있습니다.
유닛과 로그 #
유닛 파일은 /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service입니다. systemd는 실패 후 5초 뒤에 클라이언트를 다시 시작합니다. 일반적인 systemd 유닛이므로 systemctl로 관리하고 journalctl로 출력을 확인할 수도 있습니다.
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f유닛은 서비스를 설치할 때의 경로에 있던 localtonet 파일을 시작합니다. 예외가 하나 있습니다. 그 경로가 /root/ 아래라면 설치 명령이 파일을 /usr/local/lib/Localtonet_<TOKEN_PREFIX>/로 복사하고 서비스는 그 복사본을 실행합니다.
업그레이드 #
-
클라이언트 교체하기 #
설치 스크립트를 다시 실행하세요. 다시 실행해도 안전하며, 설치된 클라이언트를 최신 버전으로 덮어씁니다. 수동으로 설치한 경우에는 최신 아카이브를 다운로드해
localtonet파일을 교체하세요.터미널curl -fsSL https://localtonet.com/install.sh | sh -
서비스 다시 시작하기 #
실행 중인 서비스는 다시 시작하기 전까지 이전 버전을 계속 사용합니다.
터미널sudo systemctl restart Localtonet_<TOKEN_PREFIX>서비스가
/usr/local/lib/아래의 복사본을 실행한다면, 서비스를 제거한 다음 새 클라이언트로 다시 설치하세요.
내 토큰의 클라이언트 열에는 기기가 마지막으로 보고한 버전이 표시되며, 더 새로운 버전이 있으면 업데이트 필요 배지가 표시됩니다.
제거하기 #
- 서비스를 설치했다면 제거하세요:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - 저장된 토큰을 제거하려면 클라이언트를 시작하고 F12를 누르세요.
- 클라이언트 삭제: 스크립트로 설치했다면
sudo rm /usr/local/bin/localtonet /usr/bin/localtonet, 아카이브로 설치했다면 아카이브를 압축 해제한 폴더를 삭제하세요.
문제 해결 #
설치 스크립트: Unsupported architecture
스크립트에는 x64(x86_64), ARM64(aarch64), 32비트 ARM(armv7l)용 빌드가 있습니다. 그 외의 CPU 유형은 Linux 빌드에서 지원되지 않습니다.
설치 스크립트: Neither curl nor wget found
패키지 관리자로 curl 또는 wget을 설치한 다음 스크립트를 다시 실행하세요.
설치 스크립트: Failed to install 'unzip'
스크립트가 unzip을 스스로 설치하지 못했습니다. 패키지 관리자로 설치한 다음 스크립트를 다시 실행하세요.
설치되었지만 PATH에서 찾을 수 없음
새 셸을 열거나 전체 경로 /usr/local/bin/localtonet으로 클라이언트를 시작하세요.
sudo: localtonet: command not found
수동으로 설치한 뒤에는 클라이언트가 sudo의 검색 경로에 없습니다. 전체 경로를 사용하세요. 예: sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>. 또는 먼저 파일을 /usr/local/bin으로 옮기세요.
Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.
명령이 root 권한 없이 실행되었습니다. sudo로 다시 실행하세요. --start-service, --stop-service, --remove-service도 마찬가지입니다.
Install failed: Systemd unit already exists for 'Localtonet_…'
이 토큰용 서비스가 이미 설치되어 있습니다. --status-service로 확인하세요. 다시 설치하려면 먼저 --remove-service를 실행하세요.
systemd가 없는 시스템에서는 서비스 명령이 실패합니다
서비스 모드는 systemd를 사용합니다. systemd가 없는 시스템에서는 클라이언트를 다른 방법으로 시작하세요. 예를 들어 Docker 컨테이너에서 실행합니다. 콘솔 클라이언트에는 이를 위한 헤드리스 모드가 있습니다. --headless는 프롬프트 없이 실행되며 --authtoken-file로 지정한 파일에서 토큰을 읽습니다. CLI 참조를 참고하세요.
Wrong Token!
클라이언트는 내 토큰의 33자 AuthToken 또는 만료되지 않은 6자리 PIN을 요구합니다. 토큰을 다시 복사해 프롬프트에 입력하세요.
This token is used in another localtonet application!
이 컴퓨터의 다른 Localtonet 클라이언트가 이미 같은 토큰으로 실행 중입니다. 그 클라이언트를 닫거나 이 클라이언트를 다른 토큰으로 시작하세요. 토큰 하나당 실행 중인 클라이언트는 하나만 사용하세요.