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

OpenWrt에 Localtonet 설치하기

실험적 OpenWrt 24.10 및 25.12+ x64 및 ARM64

이 페이지 도움받기
이 페이지의 내용 섹션 12개
  1. 시작하기 전에
  2. 지원되는 버전과 아키텍처
  3. 지원되지 않는 경우
  4. 아키텍처 확인
  5. OpenWrt 24.10 (opkg)
  6. 저장 공간과 메모리
  7. 패키지가 설치하는 것
  8. 토큰 파일과 구성
  9. 토큰 파일
  10. UCI 구성
  11. 서비스
  12. 로그
  13. 업그레이드와 제거
  14. OpenWrt 24.10 (opkg)
  15. OpenWrt에서의 VPN
  16. 문제 해결
  17. 관련 페이지

OpenWrt 라우터에서 Localtonet 클라이언트를 직접 실행합니다. 패키지는 클라이언트, 토큰 파일, UCI 구성, 그리고 라우터와 함께 시작되는 서비스를 설치합니다.

OpenWrt 패키지는 실험적입니다. 서명된 OpenWrt 피드의 패키지가 아니라 직접 설치하는 서명되지 않은 파일입니다. 사용하기 전에 펌웨어 호환성, 터널, VPN을 직접 사용하는 기기에서 확인하세요.

시작하기 전에 #

  • 지원되는 OpenWrt 버전과 CPU 아키텍처를 사용하는 라우터(다음 섹션 참고).
  • SSH로 라우터에 root 권한으로 접속할 수 있어야 합니다.
  • 설치하는 동안 라우터가 인터넷에 접속할 수 있어야 합니다. 패키지 관리자가 펌웨어 자체의 패키지 피드에서 종속성을 내려받습니다.
  • 충분한 여유 저장 공간과 메모리(저장 공간과 메모리 참고).
  • 내 토큰에서 발급한, 다른 기기에서 사용하지 않는 AuthToken.

지원되는 버전과 아키텍처 #

OpenWrt는 릴리스 사이에 패키지 관리자를 변경했기 때문에 패키지 형식이 두 가지입니다. 펌웨어에 맞는 형식을 고르세요.

OpenWrt 버전패키지 형식패키지 관리자아키텍처
24.10IPKopkgx64, ARM64
25.12 이상APK v3apkx64, ARM64

여기서 APK는 OpenWrt 패키지를 뜻합니다. 이 .apk 파일은 Android 앱이 아니며 휴대폰에 설치할 수 없습니다. Android는 Android를 참고하세요.

지원되지 않는 경우 #

  • MIPS, MIPSEL, ARMv7 라우터. 이 아키텍처용 패키지는 없습니다.
  • 패키지 피드에서 설치하는 것. 패키지는 로컬 파일이며, 라우터가 opkg update나 apk update로 패키지를 찾거나 업데이트하지 않습니다.
  • 다른 아키텍처의 패키지를 강제로 설치하는 것. 패키지 관리자의 아키텍처 검사를 절대 무시하지 마세요.

아키텍처 확인 #

패키지 아키텍처는 펌웨어와 일치해야 합니다. 라우터에 어떤 아키텍처를 허용하는지 물어보세요.

OpenWrt 24.10 (opkg) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

x64 라우터는 x86_64를 보고합니다. ARM64 라우터는 aarch64_로 시작하는 이름을 보고하며, 이 이름은 펌웨어 빌드마다 다릅니다. 모든 패키지에는 해당 패키지가 빌드된 정확한 패키지 아키텍처(예: x86_64 또는 aarch64_generic)가 적힌 짧은 안내 파일이 함께 제공됩니다. 다운로드 페이지의 OpenWrt에서 패키지를 선택하고 패키지 설치 안내를 열어 확인하세요. 그 아키텍처를 라우터가 보고한 값과 비교하세요. 일치하지 않으면 패키지를 설치하지 마세요.

저장 공간과 메모리 #

패키지에는 클라이언트와 전용 런타임이 함께 들어 있어 일반적인 OpenWrt 패키지보다 훨씬 큽니다. 설치하기 전에 라우터를 확인하세요.

Bash
df -h
free
  • 플래시(오버레이). 프로그램 파일은 /usr/lib/localtonet 아래에 설치됩니다. 플래시 칩이 작은 라우터는 이를 담으려면 extroot(루트 오버레이로 쓰는 외부 저장소)가 필요할 수 있습니다.
  • RAM과 /tmp. 클라이언트는 시작할 때 네이티브 라이브러리를 /tmp/localtonet/bundle에 풉니다. OpenWrt에서 /tmp는 RAM에 있으므로 이 공간은 라우터의 메모리에서 차지합니다.

패키지가 설치하는 것 #

경로설명
/usr/bin/localtonetlocaltonet 명령.
/usr/lib/localtonet프로그램 파일.
/etc/localtonet/auth-token토큰 파일. 교체하기 전까지는 자리 표시자 DUMMY_AUTH_TOKEN이 들어 있습니다. root만 읽을 수 있습니다.
/etc/config/localtonet서비스의 UCI 구성.
/etc/init.d/localtonet서비스 스크립트(procd).

패키지는 libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft, ip6tables-nft에 의존합니다. 패키지 관리자가 없는 항목을 펌웨어의 피드에서 설치하며, 설치 안내가 먼저 패키지 목록을 새로 고치는 이유가 이것입니다. kmod-tun은 설치된 펌웨어의 커널과 일치해야 하므로 항상 그 펌웨어 자체의 피드에서 받으세요.

토큰 파일과 구성 #

패키지를 설치해도 아무것도 연결되지 않습니다. 서비스는 두 가지를 마칠 때까지 꺼져 있습니다. 토큰 파일에 토큰을 넣는 것과, UCI에서 서비스를 활성화하는 것입니다. 패키지별 정확한 명령은 이 페이지 끝의 설치 안내에 있으며, 이 섹션에서는 그 명령이 하는 일을 설명합니다.

토큰 파일 #

/etc/localtonet/auth-token에는 AuthToken이 한 줄로만 들어 있고 다른 내용은 없습니다. 자리 표시자 DUMMY_AUTH_TOKEN을 내 토큰으로 바꾸세요. 예를 들어 vi를 사용할 수 있습니다. 파일은 root만 읽을 수 있게(모드 600) 유지하세요.

그다음 설치 안내는 --headless --authtoken-file /etc/localtonet/auth-token --check-config로 클라이언트를 한 번 실행합니다. 이 명령은 Localtonet에 연결하지 않고 파일만 확인합니다.

출력의미
Localtonet headless configuration OK.파일에 올바른 형식의 토큰이 들어 있습니다. 33자이며 공백이 없습니다. 이 검사는 토큰이 내 계정에서 유효한지까지는 확인하지 않습니다.
Invalid Localtonet headless configuration. Check the token file or environment settings.파일이 없거나, 아직 자리 표시자가 들어 있거나, 토큰이 33자가 아닙니다.

UCI 구성 #

서비스는 /etc/config/localtonet에서 설정을 읽습니다. 새로 설치하면 다음 내용이 들어 있습니다.

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
옵션기능값
enabled서비스가 클라이언트를 시작할지 여부입니다. 0인 동안에는 서비스를 시작해도 아무 일도 일어나지 않습니다.0(기본값) 또는 1
token_file클라이언트가 토큰을 읽는 파일의 경로입니다.기본값 /etc/localtonet/auth-token

현재 값은 언제든지 다음으로 확인할 수 있습니다.

Bash
uci show localtonet

서비스 #

클라이언트는 localtonet이라는 procd 서비스로 실행됩니다. 패키지를 설치하면 부팅 시 시작되도록 등록되지만, enabled가 1이고 토큰 파일이 비어 있지 않을 때만 클라이언트를 시작합니다. enabled를 1로 설정하고 변경 사항을 커밋한 뒤 서비스를 한 번 다시 시작하세요. 그다음부터는 라우터와 함께 시작됩니다.

명령기능
/etc/init.d/localtonet restart클라이언트를 중지했다가 시작합니다. 토큰 파일이나 구성을 변경한 후에 실행하세요.
/etc/init.d/localtonet stop다음 재시작 또는 재부팅까지 클라이언트를 중지합니다.
/etc/init.d/localtonet disable부팅 시 서비스를 시작하지 않도록 합니다.
/etc/init.d/localtonet enable부팅 시 서비스를 다시 시작하도록 합니다.

패키지는 설치해 둔 채 클라이언트만 끄려면:

Bash
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restart

클라이언트가 예기치 않게 중지되면 procd가 다시 시작합니다.

클라이언트가 연결되면 대시보드에서 라우터의 토큰으로 터널을 만들고 시작하세요. 터널의 로컬 IP 주소는 라우터 자체의 서비스라면 127.0.0.1, 라우터 뒤에 있는 기기라면 그 기기의 LAN 주소(예: 192.168.1.20)로 지정할 수 있습니다.

로그 #

클라이언트는 OpenWrt 시스템 로그에 기록합니다. 해당 줄을 표시하거나 실시간으로 따라가 보세요.

Bash
logread -e localtonet
logread -f -e localtonet
로그 줄의미
Localtonet - headless log클라이언트가 시작되었습니다.
Connection: …Localtonet과의 연결 상태입니다.
AuthTokenName: …라우터가 로그인한 토큰의 이름입니다.
OPEN …, ADDED …, STATUS …, CLOSED …이 토큰의 터널이 발견되었거나, 추가되었거나, 상태가 바뀌었거나, 제거되었습니다.
Authentication failed: AuthToken was rejected.Localtonet이 토큰 파일의 토큰을 받아들이지 않았습니다.
AuthToken file missing서비스는 활성화되어 있지만 토큰 파일이 없거나 비어 있습니다.

업그레이드와 제거 #

업그레이드하려면 기존 패키지 위에 새 패키지를 설치하고 서비스를 다시 시작하세요. 토큰 파일과 UCI 구성은 유지됩니다. 두 파일은 OpenWrt가 펌웨어 업그레이드 중에 보존하는 파일 목록에도 있지만, 새 펌웨어를 플래시한 뒤에는 패키지 자체를 다시 설치해야 합니다.

클라이언트를 제거하려면:

OpenWrt 24.10 (opkg) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

패키지를 제거하면 서비스가 중지되고 부팅 순서에서 빠집니다.

OpenWrt에서의 VPN #

패키지는 라우터에서 VPN 기능에 필요한 kmod-tun, ip-full, bash, iptables-nft, ip6tables-nft를 함께 가져옵니다. 라우팅과 방화벽 동작은 펌웨어와 직접 설정한 방화벽 규칙에 따라 다르므로, 의존하기 전에 기기에서 VPN을 테스트하세요. 기능 자체는 VPN 매니저를 참고하세요.

문제 해결 #

패키지 관리자가 아키텍처 때문에 패키지를 거부합니다

패키지가 펌웨어와 다른 아키텍처용으로 빌드되었습니다. opkg print-architecture 또는 apk --print-arch의 출력을 패키지 안내 파일(다운로드 페이지의 패키지 설치 안내)에 적힌 아키텍처와 비교하세요. 설치를 강제하지 마세요. MIPS, MIPSEL, ARMv7 라우터는 지원되지 않습니다.

apk가 파일을 신뢰할 수 없다며 설치를 거부합니다

APK 패키지는 서명되지 않은 로컬 파일입니다. 설치하려면 패키지의 설치 안내에 나와 있듯이 --allow-untrusted 옵션이 필요합니다.

종속성을 찾을 수 없어 설치에 실패합니다

먼저 패키지 목록을 새로 고치고(opkg update 또는 apk update) 라우터가 인터넷에 접속할 수 있는지 확인하세요. 종속성은 펌웨어 자체의 피드에서 가져옵니다.

서비스는 활성화되어 있는데 로그에 아무것도 나타나지 않습니다

uci show localtonet을 확인하세요. enabled가 아직 0이면 1로 설정하고 커밋한 뒤 서비스를 다시 시작하세요. 로그에 AuthToken file missing이 나오면 token_file이 가리키는 파일에 토큰을 넣으세요.

클라이언트가 시작되지 않거나 라우터의 메모리가 부족합니다

df -h와 free로 여유 플래시 공간과 메모리를 확인하세요. 클라이언트는 /usr/lib/localtonet과 /tmp에 공간이 필요합니다.

OpenWrt

실험적 기능입니다. OpenWrt 24.10은 IPK를, 25.12 이상은 APK v3를 선택하세요. 이 APK 파일은 Android 앱이 아니라 OpenWrt 패키지입니다.

x64 및 ARM64만 지원합니다. 패키지 아키텍처가 펌웨어와 일치해야 합니다. 패키지 설치 안내와 opkg print-architecture 또는 apk --print-arch로 확인하세요. 이 패키지는 MIPS, MIPSEL, ARMv7을 지원하지 않습니다. 설치 전에 사용 가능한 저장 공간과 RAM을 확인하세요.

  • OpenWrt 24.10 · x64 · IPK
    설치 안내

    1. 다운로드한 패키지를 설치하세요. localtonet-openwrt-24.10-x64.ipk이 있는 디렉터리에서 터미널을 여세요.

    라우터에서 root로 다음 명령어를 실행하세요. 설치 전에 패키지 아키텍처가 펌웨어와 일치하는지 확인하세요.

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

    2. 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

    3. 서비스를 시작하세요. 설정 확인이 성공하면:

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

    업그레이드하려면 새 패키지를 설치하고 /etc/init.d/localtonet restart를 실행하세요. 설정은 그대로 유지됩니다.

  • OpenWrt 24.10 · ARM64 · IPK
    설치 안내

    1. 다운로드한 패키지를 설치하세요. localtonet-openwrt-24.10-arm64.ipk이 있는 디렉터리에서 터미널을 여세요.

    라우터에서 root로 다음 명령어를 실행하세요. 설치 전에 패키지 아키텍처가 펌웨어와 일치하는지 확인하세요.

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-arm64.ipk

    2. 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

    3. 서비스를 시작하세요. 설정 확인이 성공하면:

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

    업그레이드하려면 새 패키지를 설치하고 /etc/init.d/localtonet restart를 실행하세요. 설정은 그대로 유지됩니다.

  • OpenWrt 25.12+ · x64 · APK v3
    설치 안내

    1. 다운로드한 패키지를 설치하세요. localtonet-openwrt-25.12-x64.apk이 있는 디렉터리에서 터미널을 여세요.

    라우터에서 root로 다음 명령어를 실행하세요. 설치 전에 패키지 아키텍처가 펌웨어와 일치하는지 확인하세요.

    이 로컬 APK 패키지는 서명되지 않았으므로 설치하려면 --allow-untrusted가 필요합니다.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk

    2. 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

    3. 서비스를 시작하세요. 설정 확인이 성공하면:

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

    업그레이드하려면 새 패키지를 설치하고 /etc/init.d/localtonet restart를 실행하세요. 설정은 그대로 유지됩니다.

  • OpenWrt 25.12+ · ARM64 · APK v3
    설치 안내

    1. 다운로드한 패키지를 설치하세요. localtonet-openwrt-25.12-arm64.apk이 있는 디렉터리에서 터미널을 여세요.

    라우터에서 root로 다음 명령어를 실행하세요. 설치 전에 패키지 아키텍처가 펌웨어와 일치하는지 확인하세요.

    이 로컬 APK 패키지는 서명되지 않았으므로 설치하려면 --allow-untrusted가 필요합니다.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk

    2. 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

    3. 서비스를 시작하세요. 설정 확인이 성공하면:

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

    업그레이드하려면 새 패키지를 설치하고 /etc/init.d/localtonet restart를 실행하세요. 설정은 그대로 유지됩니다.

설치 전에 해당 패키지의 설치 안내를 읽으세요. 패키지는 서명되지 않았으며, 펌웨어 호환성, 터널, VPN은 사용할 기기에서 검증해야 합니다. 아키텍처가 맞지 않는 패키지를 강제로 설치하지 마세요.

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

지원