웹 터미널 서비스 대표 이미지
BROWSER TERMINAL

브라우저에서
서버 관리.

웹 터미널을 HTTPS로 제공하고 WebSocket 프록시를 통해 SSH 세션을 연결하는 구성입니다.

HTTPS · 443 웹 터미널 → SSH 대기
BROWSER TERMINAL ROUTE PREVIEW
YOU 사용자 기기 Client
NET HTTPS · 443 연결 중계
WEB 웹 터미널 → SSH Nginx + WebSocket
ttyd 또는 Apache Guacamole 같은 터미널 게이트웨이와 로그인 보호가 필요합니다. PACKET FLOW
DEPLOYMENT & OPERATIONS

웹 터미널 설치·연동 가이드

05 IMPLEMENTATION STEPS

웹 터미널은 브라우저와 서버 사이에 터미널 게이트웨이를 두는 관리 도구입니다. HTTPS와 WebSocket 프록시만 연결해도 로그인 보호가 없으면 서버 셸이 공개될 수 있습니다.

시작 전 준비사항

  • 유지보수되는 터미널 게이트웨이와 SSH 대상
  • SSO/MFA 또는 강한 인증 및 운영자별 계정
  • 접근 허용 IP/VPN, 세션 로그와 비상 차단 방법

설치 및 연결 순서

  1. 게이트웨이 선택

    ttyd, Guacamole 등 프로젝트의 유지보수 상태, 인증 플러그인, WebSocket 지원과 세션 감사 기능을 검토합니다. 컨테이너나 서비스 계정은 필요한 SSH 대상에만 연결합니다.

  2. 접근 인증 설계

    운영자 계정별 MFA·SSO 또는 강한 별도 인증을 적용하고 공유 관리자 비밀번호는 피합니다. 로그인 시도 제한, 자동 유휴 종료, 역할별 호스트 허용 목록을 준비합니다.

  3. SSH 대상 제한

    게이트웨이가 사용할 전용 SSH 계정과 공개키를 발급하고 명령 실행·파일 접근 범위를 최소화합니다. 개인키는 브라우저나 HTML에 포함하지 말고, 분실·퇴사 때 즉시 회수합니다.

  4. HTTPS·WebSocket 프록시

    Nginx에서 전용 호스트의 HTTPS를 구성하고 업그레이드 헤더, 타임아웃, 원래 호스트 전달을 게이트웨이 문서와 맞춥니다. 일반 방문자가 게이트웨이 내부 포트로 직접 접근하지 못하도록 방화벽을 제한합니다.

  5. 운영 점검

    허가된 계정으로 로그인·재접속·세션 종료·동시 접속을 확인하고 비인가 계정이 403/로그인 거부되는지 시험합니다. 운영 로그에서 작업자와 시각을 추적하되 키와 세션 비밀을 기록하지 않습니다.

운영 전 확인 목록

  • 로그아웃 후 기존 WebSocket 세션이 종료되는가
  • 허용된 운영자 외 접속과 다른 호스트 연결이 차단되는가
  • 비상시 게이트웨이 접근을 즉시 중지할 수 있는가