DEB 또는 RPM 패키지로 Localtonet 설치하기
이 페이지의 내용 섹션 9개
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/localtonet | localtonet 명령입니다. |
/usr/lib/localtonet/ | 클라이언트 본체입니다. |
/usr/lib/systemd/system/localtonet.service | 터널 서비스입니다. |
/usr/lib/systemd/system/localtonet-vpn.service | VPN 및 터널 서비스입니다. |
/etc/localtonet/auth-token | 토큰 파일입니다. root만 읽을 수 있습니다. 자리 표시자 DUMMY_AUTH_TOKEN이 들어 있는 상태로 설치됩니다. |
패키지 이름은 localtonet입니다. OpenSSL 3, iproute2(RPM에서는 iproute), iptables, kmod 등의 의존성은 패키지 관리자가 설치합니다. 패키지를 설치해도 서비스가 활성화되거나 시작되지는 않습니다. 먼저 토큰을 설정한 다음 필요한 서비스를 활성화하세요.
단계 #
-
패키지 다운로드 및 설치 #
이 페이지 끝의 목록에서 배포판과 CPU에 맞는 패키지를 선택한 다음, 다운로드한 파일을
apt(DEB) 또는dnf(RPM)로 설치합니다. 각 패키지 아래의 설치 안내에 해당 파일의 정확한 명령이 표시됩니다. -
AuthToken 설정 #
root 권한으로 텍스트 편집기에서
/etc/localtonet/auth-token을 편집하여DUMMY_AUTH_TOKEN을 한 줄로 된 내 토큰으로 바꿉니다. 그런 다음 root만 파일을 읽을 수 있는지 확인합니다.터미널sudo chmod 600 /etc/localtonet/auth-token -
설정 확인 #
터미널sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config이 검사는 연결하지 않고 토큰 파일을 읽습니다. 파일에 공백 없는 33자 토큰이 들어 있으면
Localtonet headless configuration OK.라고 응답합니다. 토큰이 내 계정에서 유효한지는 Localtonet 서버에 확인하지 않습니다. -
서비스 활성화 #
터널용으로는 터널 서비스를 활성화하고 로그를 확인합니다.
터미널sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.service이 기기가 VPN 네트워크에도 참여한다면 대신 VPN 서비스를 활성화하세요. 터널 서비스와 VPN 서비스를 참고하세요.
-
터널 시작하기 #
이제 토큰이 내 토큰에서 온라인으로 표시됩니다. 대시보드에서 해당 토큰의 터널을 만들고 시작하세요. 빠른 시작을 참고하세요.
터널 서비스와 VPN 서비스 #
두 서비스는 같은 클라이언트를 실행하며 둘 다 터널을 제공합니다. 실행되는 권한이 다릅니다. 둘 중 하나만 활성화하세요. 두 서비스는 충돌하며, 하나를 시작하면 다른 하나가 중지됩니다.
localtonet.service | localtonet-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 localtonetsudo systemctl restart localtonet-vpn.service내 토큰의 클라이언트 열에는 기기가 마지막으로 보고한 버전이 표시되며, 더 새로운 버전이 있으면 업데이트 필요 배지가 표시됩니다.
제거 #
sudo apt remove localtonetsudo 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.deb2. 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-config3. 서비스를 시작하세요. 설정 확인이 성공하면:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN을 사용하려면 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.deb2. 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-config3. 서비스를 시작하세요. 설정 확인이 성공하면:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN을 사용하려면 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.rpm2. 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-config3. 서비스를 시작하세요. 설정 확인이 성공하면:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN을 사용하려면 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.rpm2. 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-config3. 서비스를 시작하세요. 설정 확인이 성공하면:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN을 사용하려면 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를 다시 시작하세요.