CLI/헤드리스 운영 가이드

1. 구성품

A 헤드리스 배포는 데몬 + roamswitch CLI(원하는 경우 roamswitch-mcp 추가)에서 실행됩니다. 모든 자율 방어 메커니즘은 GUI 없이 작동합니다.

2. 데몬(시스템 서비스)

클라이언트 에디션

sudo systemctl status  roamswitch.service      # 가동 상태
sudo systemctl enable  roamswitch.service      # 부팅 시 자동 시작(설치 시 활성화)
sudo systemctl restart roamswitch.service      # 재시작
journalctl -u roamswitch.service -f            # 로그 추적
journalctl -u roamswitch.service --since "1h ago"

클라이언트 데몬이 시작 시 및 매 주기(3초)마다 자율적으로 수행하는 작업은 다음과 같습니다.

• 연결된 게이트웨이 MAC을 식별하고 trusted_networks에 대해 nftables 프로필(open / balanced / lockdown)을 적용합니다.
• 행동 기반 랜섬웨어 탐지(fanotify + Shannon 엔트로피 + 카나리아)
• 온액세스 악성 코드 검사(fanotify, 선택적으로 ClamAV)
• ARP 스푸핑 모니터링 및 신뢰할 수 없는 네트워크에 대한 예방 게이트웨이 ARP/NDP 고정
• 프로필당 커널 강화(sysctl / Yama / 코어 덤프 / /tmp noexec)
• 위협 방지 DNS 적용(dns_enabled + dns_scope)
• 피싱 차단을 위한 링크 가드(NFQUEUE)
• /run/roamswitch/state.json에 대한 런타임 상태 출력

서버 에디션

sudo systemctl status  roamswitch-server.service      # 가동 상태
sudo systemctl restart roamswitch-server.service      # 재시작
sudo systemctl reload  roamswitch-server.service      # 설정 파일 재로드
journalctl -u roamswitch-server.service -f            # 로그 추적

3. CLI 명령 참조

기본 구문: roamswitch <command> [options]. 인수 없이 실행하면 기본값은 status입니다. 출력 언어는 자동으로 OS 로케일(LC_ALL / LC_MESSAGES / LANG)을 따릅니다.

예

sudo roamswitch status                 # 클라이언트 종합 진단(24개 항목)
sudo roamswitch status --server        # 서버판 종합 진단(30개 항목)
sudo roamswitch ports -a               # 전체 리스닝 포트
roamswitch guards                      # 가드 가동 상태
roamswitch audit-url https://examp1e-login.com
roamswitch audit-secrets ./deploy.env
roamswitch audit-secrets .                          # 현재 디렉터리 재귀 스캔
roamswitch audit-logs 72               # 최근 72시간 로그 분석
sudo roamswitch sharing on             # 미신뢰 네트워크에서 SSH/Samba/RDP 자동 중지
sudo roamswitch fim verify             # FIM 파일 무결성 검증
sudo roamswitch fim update             # FIM 기준선 업데이트
sudo roamswitch emergency-restore      # 긴급 차단 전체 해제 및 복구
sudo roamswitch airgap enable          # 긴급 차단
sudo roamswitch airgap disable         # 해제
sudo roamswitch server ack             # 세이프티 타이머 확인 응답(자동 복귀 중지)
roamswitch canary                      # 카나리아 인시던트 기록
roamswitch port-anomaly                # 미확인 포트 노출 가드 인시던트 기록
roamswitch server ebpf                 # eBPF 가드의 격리 상태와 인시던트 기록
roamswitch notifications               # 최근 1주일간의 알림 기록
roamswitch frozen                      # 동결 중인 프로세스 목록
sudo roamswitch frozen resume 12345    # 오탐 프로세스를 해제
sudo roamswitch sensor pair --addr 192.168.1.50 --code AB3DFGH2  # 페어링 코드로 Sensor와 페어링
sudo roamswitch sensor key             # 자신의 공개 키/주소를 표시
roamswitch port-scan                   # 포트 스캔 탐지 이력

서버 에디션 데몬은 root 권한으로 실행되므로, nftables 규칙 세트를 읽거나 프로세스 소유자를 확인해야 하는 명령(status / status --server / ports -a)은 sudo 없이 실행하면 부정확한 결과(잘못된 '비활성' 판정이나 프로세스 정보 누락)를 반환합니다. 설정을 변경하는 명령(sharing / fim update / airgap / emergency-restore 등)도 마찬가지로 sudo가 필요합니다. 그 외의 읽기 전용 명령은 sudo 없이도 정확하게 동작합니다.

4. 구성 파일

클라이언트 에디션(~/.config/roamswitch/config.json)

데몬은 루트로 실행되며 찾은 첫 번째 유효한 파일(또는 루트 전용 환경에서는 /root/.config/roamswitch/config.json)을 사용하여 /home/*/.config/roamswitch/config.json을 검색합니다.

서버 에디션(/etc/roamswitch/server.conf)

Server Edition은 엄격한 권한(0600, 루트 전용)이 있는 INI 형식 구성 파일을 사용합니다. Server Edition 운영 설명서를 참조하세요.

외부 네트워크 통신을 사용하지 않고 로컬로 데몬 소켓에 연결하거나 roamswitch-core을 호출합니다. MCP 설정 가이드를 참조하세요.

• Linux용 RoamSwitch 제품 페이지
• 클라이언트 보안 백서
• 서버 보안 백서
• 서버 운영 매뉴얼
• AI 도우미 및 MCP 통합 가이드
• FAQ