Skip to main content
xkat 플랫폼은 기본적으로 웹 브라우저만으로도 다양한 강의 실습을 지원합니다.
아두이노/임베디드 하드웨어 제어나 독립된 격리 가상머신(Ubuntu Lab VM)이 필요한 강좌에서는 **로컬 에이전트(xkat-cli)**를 통해 브라우저와 사용자의 컴퓨터를 안전하게 연동합니다.
보안 안내: 로컬 에이전트는 외부 인터넷에 포트를 개방하지 않으며, 오직 본인 컴퓨터 내부(localhost:127.0.0.1)에서만 안전하게 통신합니다. 실습에 필요한 명령어는 사용자의 승인 하에 실행됩니다.

​
1. 빠른 시작 (Quick Start)

컴퓨터의 터미널(PowerShell, Terminal, Bash)을 열고 아래 1줄 명령어를 실행하세요:
명령어가 실행되면 몇 초 이내에 xkat 웹 플레이어의 상태가 **[온라인]**으로 자동 전환되며 실습 준비가 완료됩니다.

​
2. OS별 실행 및 환경 가이드

​
Windows 환경 안내

  • 터미널: PowerShell 또는 Windows Terminal (또는 명령 프롬프트 CMD)을 실행합니다.
  • 실행 명령어:
  • 가상머신(Ubuntu Lab VM) 실습 시:
    • Windows 10/11 64비트 환경을 권장합니다.
    • 작업 관리자(Ctrl+Shift+Esc) → [성능] 탭에서 가상화(Virtualization): 사용으로 표시되어 있는지 확인하세요.

​
3. 문제 해결 및 FAQ (Troubleshooting)

실습 환경 연결 중 오류가 발생하거나 정상 작동하지 않을 때는 아래 내용을 확인해 보세요.
컴퓨터에 Node.js 런타임이 설치되어 있지 않을 때 발생합니다.
  • Windows: Node.js 공식 웹사이트에서 LTS 버전을 다운로드하여 설치하거나, PowerShell에서 다음을 실행하세요:
  • macOS: 공식 웹사이트 설치 프로그램을 사용하거나 Homebrew로 설치하세요:
  • Linux (Ubuntu/Debian):
설치 완료 후 터미널 창을 완전히 닫았다가 다시 열고 npx -y xkat-cli@latest up을 실행하세요.
  • 터미널 창 확인: 에이전트를 실행한 터미널 창이 닫히지 않고 계속 켜져 있는지 확인하세요.
  • 포트 점유 프로세스 정리 후 재시작: 이전 세션이 남아있어 포트(38000–38050)가 충돌하는 경우, 터미널에서 다음을 실행하여 에이전트를 재시작하세요:
  • 방화벽 및 백신 프로그램: 회사나 학교 망의 보안 프로그램이 127.0.0.1(로컬 루프백) 통신을 차단하지 않는지 확인하세요.
  • Windows 가상화(VT-x / AMD-V) 확인:
    • 작업 관리자 → [성능] 탭의 ‘가상화’ 항목이 사용 안 함으로 되어 있다면, 컴퓨터 재부팅 시 BIOS/UEFI 설정에서 가상화 기술(Intel VT-x 또는 AMD SVM)을 활성화해야 합니다.
  • 가상머신 완전 초기화 (Reset):
    • 가상머신 상태가 꼬인 경우 아래 명령어로 깨끗하게 재생성할 수 있습니다:
터미널에서 아래 명령어를 실행하면 백그라운드에서 동작 중인 에이전트와 자원이 즉시 정리됩니다: