aozorae/EdgeSSH

어떤 프로젝트인가요?

핵심 기능

• 01PTY, 창 크기 조정 및 keepalive를 지원하는 브라우저 기반 SSH 터미널
• 02활성 SSH 세션을 공유하는 SFTP 파일 관리자
• 03CPU, 부하, 메모리, 스왑 및 프로세스를 보여주는 서버 모니터
• 04AES-256-GCM으로 암호화해 D1에 저장하는 호스트 및 인증 정보
• 05최초 연결 시 SSH 호스트 키 지문 확인
• 06신뢰 모드와 격리 모드를 지원하는 HTTP 포트 포워딩

활용 사례

• 어떤 브라우저에서든 개인 VPS 또는 홈 서버에 접속해 관리
• 데스크톱 클라이언트를 설치하지 않고 SFTP로 원격 파일 편집
• 원격 localhost에서 실행 중인 개발 웹 서비스를 미리 확인
• 배스천 VM을 운영하지 않고 셀프 호스팅 SSH 진입점 운영

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/aozorae/EdgeSSH.git
2. 2

   프로젝트 폴더로 이동합니다

   cd EdgeSSH
3. 3

   종속 항목을 설치합니다

   npm ci
4. 4

   로컬 개발용 Worker를 시작합니다

   npm run dev

사용 전 알아둘 점

• !Workers, D1, Durable Objects를 사용할 수 있는 Cloudflare 계정과 GitHub OAuth 앱 또는 Cloudflare Access 설정이 필요합니다.
• !종단 간 암호화 게이트웨이가 아닙니다. Worker가 SSH 자격 증명과 세션 데이터를 처리하므로 신뢰할 수 있는 인프라에만 배포해야 합니다.
• !관리자는 한 명만 사용할 수 있으며, 여러 관리자, SCP, ProxyJump, SSH Agent는 지원하지 않습니다.
• !암호화된 개인 키는 지원하지 않으며, 호스트 라이브러리에는 최대 200개 호스트만 등록할 수 있습니다.

토픽

자주 묻는 질문

EdgeSSH은(는) 무엇인가요?

Cloudflare Workers에서 실행되는 셀프 호스팅 브라우저 SSH 작업 공간 EdgeSSH는 Cloudflare Workers에 배포되는 WebSSH 클라이언트로, 별도의 릴레이 서버를 유지 관리하지 않고도 브라우저에서 SSH 세션을 열 수 있습니다. 호스트와 인증 정보는 AES-256-GCM으로 암호화한 뒤 Cloudflare D1에 저장되며, 각 SSH 세션은 Durable Object가 처리하고 Cloudflare TCP Sockets를 통해 대상 서버에 연결합니다.

EdgeSSH은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

EdgeSSH은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

EdgeSSH은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. EdgeSSH의 마지막 커밋은 2026년 10월 18일입니다.

EdgeSSH은(는) 어디에 사용할 수 있나요?

어떤 브라우저에서든 개인 VPS 또는 홈 서버에 접속해 관리 데스크톱 클라이언트를 설치하지 않고 SFTP로 원격 파일 편집 원격 localhost에서 실행 중인 개발 웹 서비스를 미리 확인 배스천 VM을 운영하지 않고 셀프 호스팅 SSH 진입점 운영

EdgeSSH는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/aozorae/EdgeSSH.git 프로젝트 폴더로 이동합니다: cd EdgeSSH 종속 항목을 설치합니다: npm ci 로컬 개발용 Worker를 시작합니다: npm run dev

EdgeSSH은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aozorae/EdgeSSH