newbietan/CloudSSH

해결하는 문제

CloudSSH는 로컬 SSH 클라이언트를 설치할 필요 없이 웹 브라우저를 통해 원격 서버에 접속하고 관리할 수 있는 방법을 제공합니다. 전용 백엔드 서버가 필요 없이 서버리스 인프라를 활용함으로써, 어떤 기기에서든 원격 접속이 필요한 사용자에게 비용과 설정 복잡성을 줄입니다.

작동 방식

이 프로젝트는 Cloudflare Workers 기반으로, Cloudflare의 TCP 소켓 지원을 활용해 네트워크 엣지에서 SSH 프로토콜을 분석하고 전달합니다. Web Crypto API를 사용한 순수 TypeScript로 구현된 완전한 SSH-2.0 프로토콜 스택을 사용합니다.

주요 아키텍처 구성 요소:

• Durable Objects: 독립적인 터미널 세션과 사용자 데이터를 관리하는 데 사용.
• WebSocket: 브라우저와 워커 간 실시간 I/O를 가능하게 함.
• 엣지 네트워크: 가장 가까운 Cloudflare 데이터 센터를 통해 트래픽을 라우팅하여 낮은 지연 시간 연결을 보장.

대상 사용자

• 시스템 관리자: 다양한 브라우저에서 여러 서버를 가볍고 안전하게 관리하고 싶은 사람.
• 개발자: 원격 관리 도구를 위한 제로 비용, 서버리스 배포를 원하는 사람.
• 고급 사용자: SSH 점프 호스트(버스터 서버) 및 웹 인터페이스를 통한 SFTP 파일 관리와 같은 고급 기능이 필요한 사람.

주요 기능

• 완전한 SSH-2.0 구현: 여러 키 교환 알고리즘과 인증 방식(비밀번호, 개인 키, 키보드 상호작용)을 지원하는 커스텀 TypeScript 프로토콜 스택.
• SFTP 통합: CodeMirror를 사용해 원격 파일 탐색, 업로드, 다운로드, 편집이 가능한 그래픽 파일 매니저.
• SSH 점프 호스트: 내부 네트워크 서버에 도달하기 위한 최대 3단계의 중첩된 SSH 터널 지원.
• AI 에이전트 어시스턴트: 사이드패널에 탑재된 AI 어시스턴트(BYOK)는 터미널 오류 분석, Docker 컨테이너 관리, 시스템 명령 실행이 가능.
• 보안 기능: TOFU(처음 사용 시 신뢰) 호스트 키 검증, AES-256-GCM 암호화된 자격 증명 저장, 선택적 Cloudflare Turnstile CAPTCHA.
• 서버리스 배포: GitHub를 통해 Cloudflare Workers로 원클릭 배포 가능. 서버 유지보수 비용은 0.