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

DEB 또는 RPM 패키지로 Localtonet 설치하기

이 페이지 도움받기
이 페이지의 내용 섹션 9개
  1. 시작하기 전에
  2. 패키지가 설치하는 항목
  3. 단계
  4. 패키지 다운로드 및 설치
  5. AuthToken 설정
  6. 설정 확인
  7. 서비스 활성화
  8. 터널 시작하기
  9. 터널 서비스와 VPN 서비스
  10. 서비스 실행 방식
  11. 로그 읽기
  12. 업그레이드
  13. 제거
  14. 문제 해결
  15. 관련 페이지

DEB 및 RPM 패키지는 Localtonet 클라이언트와 함께 두 개의 systemd 서비스(터널용 하나, 터널과 VPN용 하나)를 설치합니다. 서비스는 파일에서 AuthToken을 읽고 터미널 없이 실행되므로 클라이언트가 부팅할 때마다 시작됩니다.

시작하기 전에 #

  • 64비트 Linux 시스템: 패키지는 x64와 ARM64용이 있습니다.
  • systemd 247 이상과 OpenSSL 3(예: Debian 12, Ubuntu 22.04 이상, RHEL 9).
  • 루트 권한(sudo).
  • AuthToken. 대시보드의 AuthToken 카드에서 복사를 선택하거나 내 토큰에서 토큰을 복사하세요.

다른 배포판, 32비트 ARM, 또는 시스템 패키지를 사용하고 싶지 않은 경우에는 Linux에 설명된 설치 스크립트나 아카이브를 사용하세요.

패키지가 설치하는 항목 #

경로설명
/usr/bin/localtonetlocaltonet 명령입니다.
/usr/lib/localtonet/클라이언트 본체입니다.
/usr/lib/systemd/system/localtonet.service터널 서비스입니다.
/usr/lib/systemd/system/localtonet-vpn.serviceVPN 및 터널 서비스입니다.
/etc/localtonet/auth-token토큰 파일입니다. root만 읽을 수 있습니다. 자리 표시자 DUMMY_AUTH_TOKEN이 들어 있는 상태로 설치됩니다.

패키지 이름은 localtonet입니다. OpenSSL 3, iproute2(RPM에서는 iproute), iptables, kmod 등의 의존성은 패키지 관리자가 설치합니다. 패키지를 설치해도 서비스가 활성화되거나 시작되지는 않습니다. 먼저 토큰을 설정한 다음 필요한 서비스를 활성화하세요.

단계 #

  1. 패키지 다운로드 및 설치 #

    이 페이지 끝의 목록에서 배포판과 CPU에 맞는 패키지를 선택한 다음, 다운로드한 파일을 apt(DEB) 또는 dnf(RPM)로 설치합니다. 각 패키지 아래의 설치 안내에 해당 파일의 정확한 명령이 표시됩니다.

  2. AuthToken 설정 #

    root 권한으로 텍스트 편집기에서 /etc/localtonet/auth-token을 편집하여 DUMMY_AUTH_TOKEN을 한 줄로 된 내 토큰으로 바꿉니다. 그런 다음 root만 파일을 읽을 수 있는지 확인합니다.

    터미널
    sudo chmod 600 /etc/localtonet/auth-token
  3. 설정 확인 #

    터미널
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    이 검사는 연결하지 않고 토큰 파일을 읽습니다. 파일에 공백 없는 33자 토큰이 들어 있으면 Localtonet headless configuration OK.라고 응답합니다. 토큰이 내 계정에서 유효한지는 Localtonet 서버에 확인하지 않습니다.

  4. 서비스 활성화 #

    터널용으로는 터널 서비스를 활성화하고 로그를 확인합니다.

    터미널
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    이 기기가 VPN 네트워크에도 참여한다면 대신 VPN 서비스를 활성화하세요. 터널 서비스와 VPN 서비스를 참고하세요.

  5. 터널 시작하기 #

    이제 토큰이 내 토큰에서 온라인으로 표시됩니다. 대시보드에서 해당 토큰의 터널을 만들고 시작하세요. 빠른 시작을 참고하세요.

터널 서비스와 VPN 서비스 #

두 서비스는 같은 클라이언트를 실행하며 둘 다 터널을 제공합니다. 실행되는 권한이 다릅니다. 둘 중 하나만 활성화하세요. 두 서비스는 충돌하며, 하나를 시작하면 다른 하나가 중지됩니다.

localtonet.servicelocaltonet-vpn.service
용도터널VPN과 터널
실행 계정systemd가 서비스용으로 만드는 권한 없는 사용자root, 네트워크 권한 CAP_NET_ADMIN과 CAP_NET_RAW로 제한
TUN 모듈사용하지 않음클라이언트가 시작되기 전에 modprobe tun으로 로드
작업 디렉터리/var/lib/localtonet/var/lib/localtonet-vpn

기기를 터널 서비스에서 VPN 서비스로 전환하려면:

터미널
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

다시 전환하려면 같은 방법으로 localtonet-vpn.service를 비활성화하고 localtonet.service를 활성화하세요. VPN 네트워크 자체는 대시보드에서 설정합니다. VPN 매니저를 참고하세요.

서비스 실행 방식 #

동작세부 내용
헤드리스 모드두 서비스 모두 localtonet --headless를 시작합니다. 이 모드에서는 클라이언트가 프롬프트를 표시하지 않으며 토큰을 자체 설정에 저장하지 않습니다.
토큰systemd가 /etc/localtonet/auth-token을 서비스에 전달합니다. 이 파일이 없으면 서비스가 시작되지 않습니다.
부팅 시 시작활성화된 서비스는 네트워크가 올라온 후 시작됩니다.
재시작systemd는 실패 후 10초 뒤에 클라이언트를 다시 시작합니다. 토큰 파일이 올바르지 않아 클라이언트가 중지된 경우에는 다시 시작하지 않습니다. 파일을 고친 다음 서비스를 직접 다시 시작하세요.

로그 읽기 #

헤드리스 모드에서 클라이언트는 변경이 있을 때마다 일반 텍스트 한 줄을 저널에 기록합니다.

터미널
sudo journalctl -u localtonet.service -f
줄의미
Connection: Connected세션의 상태입니다. 다른 값으로 Connecting과 Disconnected가 있습니다.
AuthTokenName: …클라이언트가 로그인에 사용한 토큰의 이름입니다.
OPEN …, ADDED …이 기기에서 실행되는 터널이며 공개 주소, 프로토콜, 로컬 대상이 함께 표시됩니다.
STATUS …터널의 상태가 바뀌었습니다.
CLOSED …터널이 중지되었거나 제거되었습니다.
Authentication failed: AuthToken was rejected.파일의 토큰이 수락되지 않았습니다. 내 토큰에서 다시 복사하세요.

이 줄 중 하나에 토큰이 포함될 경우 클라이언트는 그 자리에 [redacted]를 기록합니다.

업그레이드 #

새 패키지를 다운로드하여 처음과 같은 방법으로 설치한 다음 사용 중인 서비스를 다시 시작하세요. 토큰 파일은 유지됩니다.

터널 서비스
sudo systemctl restart localtonet
VPN 서비스
sudo systemctl restart localtonet-vpn.service

내 토큰의 클라이언트 열에는 기기가 마지막으로 보고한 버전이 표시되며, 더 새로운 버전이 있으면 업데이트 필요 배지가 표시됩니다.

제거 #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

패키지를 제거하면 두 서비스가 모두 중지되고 비활성화됩니다. 토큰 파일은 설정 파일이며 패키지 관리자는 이런 파일을 조심스럽게 다룹니다. 제거 후 /etc/localtonet/auth-token이나 그 사본이 아직 남아 있는지 확인하고, 토큰이 컴퓨터에 남아 있기를 원하지 않으면 삭제하세요.

문제 해결 #

Invalid Localtonet headless configuration. Check the token file or environment settings.

토큰 파일을 사용할 수 없습니다. /etc/localtonet/auth-token이 있는지, 자리 표시자 DUMMY_AUTH_TOKEN이 없어졌는지, 파일에 공백 없이 한 줄로 된 33자 토큰만 들어 있는지 확인하세요. 파일은 root만 읽을 수 있으므로 sudo로 검사를 실행하세요.

서비스가 활성화되어 있지만 실행되지 않습니다

systemctl status localtonet.service를 실행하세요. /etc/localtonet/auth-token이 없으면 서비스가 시작되지 않으며, 토큰 파일이 올바르지 않아 중지된 후에는 다시 시작되지 않습니다. 파일을 고치고 설정 확인을 실행한 다음 sudo systemctl restart localtonet.service를 실행하세요.

로그에 Authentication failed: AuthToken was rejected.라고 표시됩니다.

파일 형식은 올바르지만 토큰이 수락되지 않았습니다. 내 토큰에서 토큰을 다시 복사해 토큰 파일에 저장하고 서비스를 다시 시작하세요.

VPN 서비스를 시작하자 터널 서비스가 중지되었습니다

의도된 동작입니다. 두 서비스는 충돌하므로 하나가 시작되면 systemd가 다른 하나를 중지합니다. VPN 서비스도 터널을 제공합니다.

내 배포판에서 패키지가 설치되지 않습니다

패키지에는 systemd 247 이상과 OpenSSL 3이 필요합니다. 이전 릴리스에서는 패키지 관리자가 이 의존성을 충족할 수 없습니다. 대신 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를 다시 시작하세요.

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

지원