다운로드

Localtonet 다운로드

플랫폼을 선택해 Localtonet을 다운로드하고 시작하세요.

플랫폼을 선택하세요

Windows용 Localtonet

앱을 설치하거나 독립 실행형 Windows 빌드를 다운로드하세요.

다운로드

토큰으로 Localtonet 시작하기:
앱을 열고 안내가 나오면 AuthToken을 붙여 넣거나, 명령줄에서 시작하세요.

localtonet이 있는 폴더에서 명령 프롬프트 또는 PowerShell을 열고 다음을 실행하세요:

localtonet --authtoken <YOUR_TOKEN>

토큰이 로컬에 저장됩니다. 인증이 끝나면 Localtonet을 바로 사용할 수 있습니다.

Windows 서비스로 Localtonet 실행(자동 시작):
Localtonet을 Windows 서비스로 설치하면 부팅할 때마다 자동으로 시작되고, 로그아웃 후에도 계속 실행되며, 터미널을 열어 둘 필요가 없습니다. 명령 프롬프트 또는 PowerShell을 관리자 권한으로 실행한 뒤:

localtonet --install-service --authtoken <YOUR_TOKEN>

localtonet --start-service --authtoken <YOUR_TOKEN>

서비스는 services.msc에서 확인할 수 있습니다. --stop-service, --status-service, --remove-service로 서비스를 관리할 수 있습니다.

문서 Windows 문서

macOS용 Localtonet

Intel 또는 Apple Silicon용으로 다운로드하거나 Homebrew로 설치하세요.

다운로드

토큰으로 Localtonet 시작하기:
앱을 열고 안내가 나오면 AuthToken을 붙여 넣거나, 명령줄에서 시작하세요.

localtonet이 있는 폴더에서 터미널을 열고 다음을 실행하세요:

localtonet --authtoken <YOUR_TOKEN>

토큰이 로컬에 저장됩니다. 인증이 끝나면 Localtonet을 바로 사용할 수 있습니다.

Homebrew로 다운로드 및 시작:
공식 tap을 사용해 macOS에 Localtonet을 설치하세요

brew tap localtonet/tap

brew install localtonet

localtonet --version

tap 안내: Homebrew tap은 서드파티 저장소를 추가해 해당 저장소의 formula를 설치하고 업데이트할 수 있게 해 줍니다.

수동 다운로드:
직접 다운로드를 원하시면 Mac에 맞는 압축 파일을 받아 수동으로 설치하세요

curl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip

unzip localtonet-osx-64.zip -d ~/localtonet

chmod 755 ~/localtonet/localtonet

#선택 사항: PATH로 이동(sudo가 필요할 수 있음) # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #인증

localtonet --authtoken <YOUR_TOKEN>

launchd 서비스로 Localtonet 실행(자동 시작):
Localtonet을 백그라운드 서비스로 설치하면 부팅할 때마다 자동으로 시작되고, 로그아웃 후에도 계속 실행되며, 터미널을 열어 둘 필요가 없습니다. 관리자/root 권한이 필요합니다:

sudo localtonet --install-service --authtoken <YOUR_TOKEN>

sudo localtonet --start-service --authtoken <YOUR_TOKEN>

작업은 ~/Library/LaunchAgents/ 아래에 등록됩니다. --stop-service, --status-service, --remove-service로 서비스를 관리할 수 있습니다.

문서 macOS 문서

Linux용 Localtonet

아키텍처에 맞는 빌드를 선택하거나 빠른 설치 스크립트를 사용하세요.

다운로드

토큰으로 Localtonet 시작하기:
앱을 열고 안내가 나오면 AuthToken을 붙여 넣거나, 명령줄에서 시작하세요.

localtonet이 있는 폴더에서 터미널을 열고 다음을 실행하세요:

localtonet --authtoken <YOUR_TOKEN>

토큰이 로컬에 저장됩니다. 인증이 끝나면 Localtonet을 바로 사용할 수 있습니다.

빠른 설치:
이 한 줄 명령이 CPU/OS를 감지해 알맞은 빌드를 다운로드하고 /usr/local/bin/localtonet에 설치합니다

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

sudo를 요구하는 이유: /usr/local/bin에 설치하고 시스템 서비스를 관리하려면 보통 관리자 권한이 필요합니다.

수동 다운로드:
직접 다운로드를 원하시면 Linux에 맞는 압축 파일을 받아 수동으로 설치하세요

wget https://localtonet.com/download/localtonet-linux-x64.zip

unzip localtonet-linux-x64.zip -d ~/localtonet

chmod 755 ~/localtonet/localtonet

#선택 사항: PATH로 이동(sudo 필요) # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #인증

~/localtonet/localtonet --authtoken <YOUR_TOKEN>

systemd 서비스로 Localtonet 실행(자동 시작):
Localtonet을 systemd 서비스로 설치하면 재부팅할 때마다 자동으로 시작되고, 로그아웃 후에도 계속 실행되며, 터미널을 열어 둘 필요가 없습니다. root 권한이 필요합니다(systemd 필수, Termux는 지원되지 않으므로 Android 앱을 사용하세요):

sudo localtonet --install-service --authtoken <YOUR_TOKEN>

sudo localtonet --start-service --authtoken <YOUR_TOKEN>

유닛 파일은 /etc/systemd/system/localtonet.service에 생성됩니다. 상태는 systemctl status localtonet으로 확인하고, 실시간 로그는 journalctl -u localtonet -f로 볼 수 있습니다. --stop-service, --status-service, --remove-service로 서비스를 관리할 수 있습니다.

문서 Linux 문서

Linux 패키지

x64 및 ARM64용으로 설치 가능한 DEB, RPM 패키지입니다. systemd 247 이상과 OpenSSL 3이 필요합니다(예: Debian 12, Ubuntu 22.04 이상, RHEL 9).

Debian / Ubuntu · x64
설치 안내

1. 다운로드한 패키지를 설치하세요. localtonet-linux-x64.deb이 있는 디렉터리에서 터미널을 여세요.
```
sudo apt install ./localtonet-linux-x64.deb
```
2. AuthToken을 설정하세요. root로 /etc/localtonet/auth-token을 편집해 DUMMY_AUTH_TOKEN을 한 줄로 된 내 토큰으로 바꾸세요. 그런 다음 파일을 보호하고 설정을 확인하세요:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 서비스를 시작하세요. 설정 확인이 성공하면:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
VPN을 사용하려면 VPN 서비스로 전환하세요:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
업그레이드하려면 새 패키지를 설치하고 sudo systemctl restart localtonet을 실행하세요. 설정은 그대로 유지됩니다.

VPN을 사용하는 경우 대신 localtonet-vpn.service를 다시 시작하세요.
Debian / Ubuntu · ARM64
설치 안내

1. 다운로드한 패키지를 설치하세요. localtonet-linux-arm64.deb이 있는 디렉터리에서 터미널을 여세요.
```
sudo apt install ./localtonet-linux-arm64.deb
```
2. AuthToken을 설정하세요. root로 /etc/localtonet/auth-token을 편집해 DUMMY_AUTH_TOKEN을 한 줄로 된 내 토큰으로 바꾸세요. 그런 다음 파일을 보호하고 설정을 확인하세요:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 서비스를 시작하세요. 설정 확인이 성공하면:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
VPN을 사용하려면 VPN 서비스로 전환하세요:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
업그레이드하려면 새 패키지를 설치하고 sudo systemctl restart localtonet을 실행하세요. 설정은 그대로 유지됩니다.

VPN을 사용하는 경우 대신 localtonet-vpn.service를 다시 시작하세요.
Fedora / RHEL · x64
설치 안내

1. 다운로드한 패키지를 설치하세요. localtonet-linux-x64.rpm이 있는 디렉터리에서 터미널을 여세요.
```
sudo dnf install ./localtonet-linux-x64.rpm
```
2. AuthToken을 설정하세요. root로 /etc/localtonet/auth-token을 편집해 DUMMY_AUTH_TOKEN을 한 줄로 된 내 토큰으로 바꾸세요. 그런 다음 파일을 보호하고 설정을 확인하세요:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 서비스를 시작하세요. 설정 확인이 성공하면:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
VPN을 사용하려면 VPN 서비스로 전환하세요:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
업그레이드하려면 새 패키지를 설치하고 sudo systemctl restart localtonet을 실행하세요. 설정은 그대로 유지됩니다.

VPN을 사용하는 경우 대신 localtonet-vpn.service를 다시 시작하세요.
Fedora / RHEL · ARM64
설치 안내

1. 다운로드한 패키지를 설치하세요. localtonet-linux-arm64.rpm이 있는 디렉터리에서 터미널을 여세요.
```
sudo dnf install ./localtonet-linux-arm64.rpm
```
2. AuthToken을 설정하세요. root로 /etc/localtonet/auth-token을 편집해 DUMMY_AUTH_TOKEN을 한 줄로 된 내 토큰으로 바꾸세요. 그런 다음 파일을 보호하고 설정을 확인하세요:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 서비스를 시작하세요. 설정 확인이 성공하면:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
VPN을 사용하려면 VPN 서비스로 전환하세요:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
업그레이드하려면 새 패키지를 설치하고 sudo systemctl restart localtonet을 실행하세요. 설정은 그대로 유지됩니다.

VPN을 사용하는 경우 대신 localtonet-vpn.service를 다시 시작하세요.

OpenWrt용 Localtonet

실험적

펌웨어와 아키텍처에 맞는 패키지로 라우터에서 Localtonet을 실행하세요.

다운로드

OpenWrt 24.10용 IPK · 25.12 이상용 APK v3 · x64 및 ARM64

설치 전에 라우터를 확인하세요. 패키지를 펌웨어 아키텍처에 맞추고 사용 가능한 저장 공간과 RAM을 확인하세요. MIPS, MIPSEL, ARMv7은 지원되지 않습니다. 이 APK 파일은 Android 앱이 아니라 OpenWrt 패키지입니다.

패키지 설치

다운로드한 파일을 라우터로 옮긴 뒤 해당 디렉터리에서 root SSH 세션을 여세요. 설치 전에 아키텍처를 확인하세요.

opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk
AuthToken 추가

root로 /etc/localtonet/auth-token을 편집하세요. DUMMY_AUTH_TOKEN을 한 줄로 된 내 토큰으로 바꾼 뒤 파일을 보호하고 설정을 확인하세요.

chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
자동 시작 활성화

설정 확인이 성공하면 서비스를 활성화하고 로그를 확인하세요.

uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonet

업그레이드하려면 새 패키지를 설치하고 서비스를 다시 시작하세요. 설정은 그대로 유지됩니다.

문서 패키지 설치 안내

패키지는 서명되지 않은 실험적 버전입니다. 기기에서 펌웨어 호환성, 터널, VPN을 검증하세요. 아키텍처가 맞지 않는 패키지를 강제로 설치하지 마세요.

NAS / Home Assistant용 Localtonet

설정 템플릿

바로 설정할 수 있는 배포 템플릿으로 NAS나 Home Assistant를 연결하세요.

배포 템플릿 ZIP · AMD64 / ARM64

다운로드

Synology Container Manager · QNAP Container Station · Home Assistant

기기에 맞는 설정을 선택하세요. Docker를 지원하는 NAS나 Home Assistant Container / Core 호스트에서는 Docker Compose를 사용하세요. Home Assistant OS / Supervised는 포함된 로컬 앱 템플릿을 사용합니다.

템플릿 압축 해제

ZIP을 다운로드해 압축을 풀고 전체 설정 안내가 담긴 README.txt를 여세요. 압축 파일에는 NAS 템플릿과 Home Assistant 템플릿이 모두 들어 있습니다.
기기 설정

NAS / Docker Compose

nas/auth-token.example을 nas/auth-token으로 복사하고 AuthToken을 입력한 뒤 파일을 비공개로 유지하세요. nas/compose.yaml의 이미지 태그가 레지스트리에 있는지 확인하세요.

컨테이너 관리자에서 Compose 파일을 프로젝트로 가져오거나 nas 디렉터리에서 다음 명령어를 실행하세요:

docker compose up -d

Home Assistant OS / Supervised

README.txt의 로컬 앱 설치 단계를 따른 뒤 앱 설정에 AuthToken을 입력하세요.

문서 전체 설정 가이드는 README.txt에 포함되어 있습니다

이것은 설정 템플릿이며 SPK / QPKG 설치 파일이나 공식 Home Assistant 스토어 등록 앱이 아닙니다. LAN 접근을 위해 Linux 호스트 네트워킹을 사용하며 VPN 권한은 활성화하지 않습니다.

Docker용 Localtonet

공식 Docker 이미지로 컨테이너에서 Localtonet을 실행하세요.

Docker Hub로 이동

토큰으로 Localtonet 시작하기:
이렇게 하면 항상 최신 버전의 Localtonet을 사용할 수 있습니다

docker pull localtonet/localtonet

컨테이너를 시작하고 토큰을 전달하세요.

docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

토큰이 로컬에 저장됩니다. 인증이 끝나면 Localtonet을 바로 사용할 수 있습니다.

문서 Docker 문서

Localtonet 다운로드

Windows용 Localtonet

macOS용 Localtonet

Linux용 Localtonet

Linux 패키지

OpenWrt용 Localtonet

패키지 설치

AuthToken 추가

자동 시작 활성화

NAS / Home Assistant용 Localtonet

템플릿 압축 해제

기기 설정

NAS / Docker Compose

Home Assistant OS / Supervised

Android용 Localtonet

Docker용 Localtonet

설치 없는 SSH