소개
XXTLanControl은 LAN에서 XXTouch 기기를 일괄 관리하고 제어하는 중앙 제어 플랫폼입니다. 주로 다음 구성 요소로 이루어져 있습니다.
- 백엔드 서비스: HTTP API를 제공하며 기기 통신, 파일 관리, 데이터 저장 등의 핵심 로직을 담당합니다.
- Web 프런트엔드: 브라우저 기반 관리 화면으로, 기기 목록, 스크립트 관리, 원격 제어, 파일 관리, KVDB, TableDB, 샘플 작업대 등의 기능을 제공합니다.
- 트레이 프로그램(선택 사항): Windows/macOS에서 백엔드를 빠르게 시작하거나 중지하고 브라우저를 열 수 있는 시스템 트레이 프로그램입니다.
- Lua 모듈
XXTLanControl.lua: 기기에서 실행되는 스크립트 라이브러리로, 중앙 제어 서버 연결, 로그 보고, KVDB, TableDB, 파일 작업 등의 API를 제공합니다.
배포 패키지 구조
운영체제에 따라 배포 패키지 이름이 조금씩 다르며, 일반적인 구성은 다음과 같습니다.
Windows
| 경로/파일 | 설명 |
|---|---|
XXTLanControl-tray-windows-amd64.exe | 트레이 실행 프로그램입니다. 두 번 클릭하면 백엔드를 시작하고 시스템 트레이에 상주합니다. |
bin/XXTLanControl-backend-windows-amd64.exe | 중앙 제어 백엔드 서비스입니다. |
bin/xxtlancontrol-mcpserver.exe | MCP 서비스 프로그램입니다. |
dist/ | 런타임 리소스 루트입니다. web/에는 Web 콘솔 페이지가, 그 밖의 위치에는 패키지 리소스가 있습니다. |
start-backend.cmd | 명령줄 모드 실행 스크립트로, 문제를 진단할 때 사용하기 좋습니다. |
XXTLanControl.lua | 기기 측에서 중앙 제어 기능을 호출할 때 사용하는 Lua 모듈입니다. |
macOS
| 경로/파일 | 설명 |
|---|---|
XXTLanControl.app | 기본 앱 번들입니다. 두 번 클릭하면 트레이와 백엔드가 시작됩니다. |
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver | MCP 서비스 프로그램입니다. |
XXTLanControl.app/Contents/Resources/dist/ | 런타임 리소스 루트입니다. web/에는 Web 콘솔 페이지가, 그 밖의 위치에는 패키지 리소스가 있습니다. |
start-backend.command | 터미널 모드 실행 스크립트로, 문제를 진단할 때 사용하기 좋습니다. |
XXTLanControl.lua | 기기 측에서 중앙 제어 기능을 호출할 때 사용하는 Lua 모듈입니다. |
Linux
| 경로/파일 | 설명 |
|---|---|
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64 | 아키텍처별 백엔드 바이너리입니다. |
xxtlancontrol-mcpserver | 아키텍처에 맞는 MCP 바이너리를 자동으로 선택하는 MCP 실행 스크립트입니다. |
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64 | 아키텍처별 MCP 바이너리입니다. |
dist/ | 런타임 리소스 루트입니다. web/에는 Web 콘솔 페이지가, 그 밖의 위치에는 패키지 리소스가 있습니다. |
start-backend.sh | 명령줄 모드 실행 스크립트입니다. |
XXTLanControl.lua | 기기 측에서 중앙 제어 기능을 호출할 때 사용하는 Lua 모듈입니다. |
주요 기능
- 기기 관리: LAN의 XXTouch 기기를 검색하고 가져오며, 그룹별로 통합 관리할 수 있습니다.
- 스크립트 실행: 스크립트를 기기에 업로드하고 언제든지 시작, 중지 또는 일시 정지할 수 있습니다.
- 원격 제어: 기기 화면을 실시간으로 보고 터치와 키 입력을 보낼 수 있으며, 여러 기기를 동시에 원격 제어할 수도 있습니다.
- 파일 관리: 중앙 제어 서버의 스크립트, 리소스, 보고서 등의 파일을 관리하고 업로드, 다운로드 및 온라인 편집을 지원합니다.
- 데이터 관리: KVDB(큐 + 사전)와 TableDB(구조화된 테이블)가 내장되어 있어 스크립트 간 상태 공유와 업무 데이터 저장에 사용할 수 있습니다.
- 예약 작업: 예약, 간격, 일회성, 사용자 트리거, KVDB 큐 소비 등 다양한 트리거를 지원하며 단계 구성과 시각적 워크플로를 제공합니다.
- 샘플 작업대: 스크린샷 색상 추출, 선택 영역 자르기, 도트 매트릭스 글꼴, 텍스트 요소 캡처 등 스크립트 개발 보조 도구를 제공합니다.
- 일괄 작업: 일괄 라이선스 활성화, 새 XXTouch 버전 일괄 설치, 일괄 이름 변경, 일괄 스크린샷, 일괄 화면 잠금/잠금 해제 등을 지원합니다.
사용 조건
- 기기에 XXTouch를 설치하고
원격 접근을 활성화해야 합니다. - 기기와 중앙 제어 서버가 같은 LAN에 있어야 하며, 중앙 제어 서버의 방화벽에서 HTTP 포트(기본값
46990)를 허용해야 합니다.
처음 시작하기
- Windows:
XXTLanControl-tray-windows-amd64.exe를 두 번 클릭합니다. 일반적으로 브라우저가 자동으로 열리고 콘솔이 표시됩니다. - macOS:
XXTLanControl.app을 엽니다. 일반적으로 브라우저가 자동으로 열리고 콘솔이 표시됩니다. - Linux:
start-backend.sh를 실행한 다음http://127.0.0.1:46990/에 직접 접속합니다.
더 자세한 사용법은 이어지는 장을 참조하세요.