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

서비스로 Localtonet 실행

이 페이지 도움받기
이 페이지의 내용 섹션 8개
  1. 시작하기 전에
  2. 서비스 설치
  3. Windows
  4. 서비스 이름
  5. 서비스가 실행하는 것
  6. 서비스 관리
  7. Windows
  8. 서비스가 등록되는 위치와 로그 위치
  9. 토큰 변경
  10. 알아 둘 점
  11. 문제 해결
  12. 관련 페이지

Localtonet 클라이언트를 백그라운드 서비스로 설치하면 기기와 함께 시작되고, 로그아웃한 뒤에도 계속 실행되며, 터미널을 열어 둘 필요가 없습니다. 명령 하나로 Windows 서비스, macOS의 launchd, Linux의 systemd에 등록됩니다.

시작하기 전에 #

  • 기기에 콘솔 클라이언트가 설치되어 있어야 합니다. Windows, macOS 또는 Linux.
  • 내 토큰의 이 기기용 AuthToken.
  • 관리자 권한. Windows에서는 관리자 권한으로 실행한 터미널, macOS와 Linux에서는 sudo가 필요합니다.
  • Linux에서는 systemd를 사용하는 배포판이어야 합니다. Termux는 지원되지 않으므로 거기서는 Android 앱을 사용하세요.

DEB 또는 RPM 패키지로 설치했거나, OpenWrt나 Docker를 사용하나요? 이 환경에는 부팅 시 시작하는 고유한 방법이 있습니다. 이 페이지 대신 DEB 및 RPM 패키지, OpenWrt, Docker를 참고하세요.

서비스 설치 #

--install-service와 토큰으로 클라이언트를 한 번 실행하세요. <YOUR_TOKEN>을 사용자의 AuthToken으로 바꾸세요. 서비스는 설치할 때 사용한 토큰으로 연결하므로, 이 명령에는 항상 --authtoken을 넣어야 합니다.

Windows #

localtonet이 들어 있는 폴더에서 명령 프롬프트 또는 PowerShell을 관리자 권한으로 열고 다음을 실행하세요.

명령 프롬프트 또는 PowerShell(관리자)
localtonet --install-service --authtoken <YOUR_TOKEN>

클라이언트가 자동 시작 Windows 서비스를 만들고 시작합니다. 서비스는 services.msc에서 설명 Localtonet Service로 표시됩니다. 서비스가 실패하면 Windows가 1분 뒤에 다시 시작합니다.

macOS

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

클라이언트가 /Library/LaunchDaemons/<SERVICE_NAME>.plist에 launchd 작업을 기록하고, 로드하고, 시작합니다. 작업은 부팅 시 시작되며, 오류로 종료되면 launchd가 다시 시작합니다.

Linux

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

클라이언트가 /etc/systemd/system/<SERVICE_NAME>.service에 systemd 유닛을 기록하고, 활성화하고, 시작합니다. 유닛은 부팅 시 시작되며, 실패하면 systemd가 5초 뒤에 다시 시작합니다.

sudo가 localtonet을 찾지 못하면 경로를 포함해 실행하세요. 예를 들어 파일이 있는 폴더에서 sudo ./localtonet을 실행합니다.

성공하면 클라이언트가 서비스 이름을 출력합니다.

출력
[CLI] Installed service 'Localtonet_AbCdEfGhI'

설치하면 서비스도 함께 시작되므로 별도의 시작 명령은 필요 없습니다. 이제 대시보드에서 이 토큰으로 터널을 만들고 시작할 수 있습니다.

서비스 이름 #

서비스 이름은 Localtonet_ 뒤에 토큰의 처음 아홉 글자가 붙은 형태입니다. 예: Localtonet_AbCdEfGhI. 이 페이지에서는 이를 <SERVICE_NAME>으로 표기합니다. 이름이 토큰에서 만들어지므로 같은 기기에 토큰마다 서비스를 하나씩 설치할 수 있으며, 모든 관리 명령은 해당 서비스를 찾기 위해 같은 토큰이 필요합니다.

서비스가 실행하는 것 #

서비스는 같은 위치의 같은 localtonet 파일을 설치 명령에 지정한 옵션과 함께 시작합니다. 여기서 두 가지가 따라옵니다.

  • 파일을 옮기거나 삭제하지 마세요. 서비스 정의에 파일의 전체 경로가 들어 있습니다. Linux에서 파일이 /root 안에 있으면 설치 프로그램이 /usr/local/lib/<SERVICE_NAME>/로 복사하고 서비스는 그 복사본을 실행합니다.
  • 다른 옵션도 유지됩니다. 설치 명령의 --net과 --ip, --proxy env 같은 옵션은 서비스에 저장되어 매번 시작할 때 사용됩니다. CLI 참조를 확인하세요.

서비스 관리 #

다음 옵션 중 하나를 같은 토큰과 함께 사용하세요. macOS와 Linux에서는 앞에 sudo를 붙입니다. Windows에서는 상태 확인을 제외한 모든 작업에 관리자 터미널을 사용하세요.

명령기능성공 시 출력
localtonet --status-service --authtoken <YOUR_TOKEN>서비스의 상태를 표시합니다.[CLI] Service '<SERVICE_NAME>' status: Running
localtonet --stop-service --authtoken <YOUR_TOKEN>서비스를 중지합니다. 서비스의 터널이 오프라인이 됩니다. 다음 부팅 시 다시 시작됩니다.[CLI] Stopped service '<SERVICE_NAME>'.
localtonet --start-service --authtoken <YOUR_TOKEN>중지된 서비스를 시작합니다.[CLI] Started service '<SERVICE_NAME>'.
localtonet --remove-service --authtoken <YOUR_TOKEN>서비스를 중지하고 등록을 제거합니다. localtonet 파일 자체는 그대로 남습니다.[CLI] Removed service '<SERVICE_NAME>'.

상태는 다음 값 중 하나입니다.

상태의미
Running서비스가 실행 중입니다.
Stopped서비스가 설치되어 있지만 실행 중이 아닙니다.
Installing서비스가 시작되는 중입니다.
NotFound이 토큰에 설치된 서비스가 없습니다.
PausedWindows에만 해당합니다. 서비스가 일시 중지되었습니다.
Error서비스가 실패했거나 상태를 읽을 수 없습니다.
Unknown서비스 관리자가 클라이언트가 인식하지 못하는 상태를 반환했습니다.

서비스 이름과 함께 운영 체제의 도구를 사용할 수도 있습니다.

Windows #

services.msc를 열어 <SERVICE_NAME>을 찾거나, 관리자 터미널에서 sc를 사용하세요.

명령 프롬프트(관리자)
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>

macOS

Bash
sudo launchctl print system/<SERVICE_NAME>

Linux

Bash
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>

서비스가 등록되는 위치와 로그 위치 #

시스템등록로그
Windows이름이 <SERVICE_NAME>인 Windows 서비스이며, 시작 유형은 자동이고 LocalSystem 계정으로 실행됩니다.서비스에는 콘솔 창이 없으며 설치 프로그램은 로그 파일을 만들지 않습니다. 서비스 상태를 확인하고, 대시보드에서 기기와 터널을 확인하세요.
macOS/Library/LaunchDaemons/<SERVICE_NAME>.plist, 시스템 전체 launchd 작업입니다./var/log/<SERVICE_NAME>.out.log 및 /var/log/<SERVICE_NAME>.err.log
Linux/etc/systemd/system/<SERVICE_NAME>.service이며 multi-user.target에 활성화됩니다.systemd 저널: journalctl -u <SERVICE_NAME> -f

서비스는 클라이언트가 터미널에 표시하는 터널 표를 출력하지 않습니다. 기기와 터널의 상태는 대시보드에서 확인하세요.

토큰 변경 #

기기의 토큰을 바꾸려면 이전 토큰으로 서비스를 제거하고 새 토큰으로 다시 설치하세요.

Bash
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>

알아 둘 점 #

  • 토큰당 클라이언트 하나. 서비스가 실행되는 동안에는 이 기기든 다른 기기든 같은 토큰으로 다른 Localtonet 클라이언트를 시작하지 마세요. 같은 토큰으로 두 번째 클라이언트가 연결하면 첫 번째 클라이언트의 연결이 끊어집니다.
  • 클라이언트 업데이트. 서비스는 정의가 가리키는 파일을 계속 실행합니다. 서비스를 중지하고, 그 파일을 새 버전으로 교체한 다음, 서비스를 다시 시작하세요.
  • 프록시 비밀번호는 저장되지 않습니다. 설치 명령은 비밀번호가 포함된 프록시 URL과 --proxy-user 옵션을 거부합니다. --proxy env로 설치하고 프록시 변수를 서비스의 환경에 설정하세요.
  • 기기 터미널. 기기에서 Localtonet을 서비스로 실행한다면 서비스가 결과를 사용할 수 있도록 관리자 터미널에서 또는 sudo로 localtonet --terminal enable을 실행하세요. 기기 터미널을 참고하세요.

문제 해결 #

메시지원인과 해결
[CLI] Install failed: '…' requires elevated (admin/root) privileges.명령이 관리자 권한 없이 실행되었습니다. Windows에서는 터미널을 관리자 권한으로 열고, macOS와 Linux에서는 sudo를 사용하세요. Windows와 Linux에서는 시작, 중지, 제거에도 같은 메시지가 나타납니다.
[CLI] Install failed: 뒤에 Service '<SERVICE_NAME>' already exists.(Windows), Systemd unit already exists for …(Linux) 또는 Plist already exists for …(macOS)이 토큰의 서비스가 이미 설치되어 있습니다. --start-service로 시작하거나, 다시 설치하려면 먼저 --remove-service를 사용하세요.
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment.설치 명령에 --proxy-user 또는 비밀번호가 포함된 프록시 URL이 들어 있었습니다. 대신 --proxy env를 사용하세요.
Windows에서 설치 직후 [CLI] Start failed: …설치하면 서비스가 시작되므로 서비스가 이미 실행 중입니다. --status-service로 확인하세요.
상태가 NotFound입니다전달한 토큰에 해당하는 서비스가 없습니다. 서비스를 설치할 때 사용한 토큰인지 확인하세요.
상태는 Running인데 대시보드에서 기기가 오프라인입니다토큰을 확인하세요. 내 토큰에서 다시 복사하고, 서비스를 제거한 뒤 다시 설치하세요. 다른 클라이언트가 같은 토큰을 사용하고 있지 않은지도 확인하세요.

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

지원