Websh 시작하기
전제 조건
Websh를 사용하여 원격 서버에 접속하려면 다음 조건이 충족되어야 합니다:
- 대상 원격 서버가 Alpacon에 등록되어 있어야 합니다.
Server페이지에서 서버를 등록할 수 있으며, 등록 과정에서 생성된 설치 스크립트를 서버에서 실행하여Alpamon agent를 설치해야 합니다. 자세한 단계는 설치 가이드를 참조하세요.
Server페이지에서 서버의 Status가Connected상태여야 합니다.
세션 생성 및 서버 접속
- Websh 페이지 우측 상단의 새 세션 버튼을 클릭합니다.
- 서버 선택 창에서 원하는 서버를 찾은 후, Websh 또는 Websh as root 버튼을 클릭합니다. Websh as root를 선택할 경우, 추가 인증 절차가 필요합니다.
- 세션이 생성되며, 새로운 탭에서 터미널 화면이 자동으로 열립니다.
- 터미널에 쉘 입력창이 표시되면 명령어를 입력하여 서버를 제어할 수 있습니다.
세션 종료
진행 중인 세션을 종료하려면 다음 방법 중 하나를 사용합니다:
- Websh 메인 페이지의 세션 카드에서 세션 종료 버튼 클릭
- 터미널 탭 우측 상단의 세션 종료 버튼 클릭
세션 재연결
예기치 않게 연결이 끊긴 세션에 대해 재접속을 통해 이전 작업을 이어갈 수 있습니다.
세션 연결이 끊기는 일반적인 상황:
- 브라우저 종료
- 터미널 탭을 실수로 닫음
- 페이지 새로고침(F5)
재연결 방법
- Websh 페이지의 세션 카드에서 접속하기 버튼을 클릭합니다.
- 새로운 탭에서 해당 세션으로 다시 접속됩니다.
- 쉘 입력창이 활성화되면, 이전과 동일하게 명령어를 실행할 수 있습니다.
세션 공유
Websh는 생성된 세션을 다른 사용자와 안전하게 공유할 수 있는 기능을 제공합니다.
공유자는 세션 접속 정보를 직접 전달하거나, 초대 이메일을 통해 공유할 수 있으며, 공유 대상자는 권한 설정에 따라 세션에 접속할 수 있습니다.
세션 공유 방식은 다음 두 가지입니다:
▸ 방법 1: URL과 비밀번호를 직접 공유
▸ 공유자
- Websh 페이지의 세션 카드 또는 터미널 화면 우측 상단의 공유 아이콘(화살표)을 클릭합니다.
- 1회용 액세스 링크 버튼을 클릭하여 세션 공유 정보를 생성합니다.
- 공유 정보 생성 창에서 다음을 설정합니다:
- 읽기 전용(Read-only) 여부 선택
- 체크 시 대상자는 터미널 내용을 보기만 할 수 있으며, 명령 실행은 제한됩니다.
- 읽기 전용(Read-only) 여부 선택
- 생성된 공유 URL과 비밀번호를 복사하여 대상자에게 전달합니다.
⚠️ 공유 정보는 한 번만 표시되며, 저장되지 않습니다.
공유 세션의 유효 시간은 기본적으로 30분이며 (180분까지 연장 가능), 만료되면 새로 생성해야 합니다.
▸ 공유 대상자
- 전달받은 공유 URL에 접속합니다.
- 비밀번호를 입력하여 인증을 완료합니다.
- 인증 후 터미널 화면이 열리며, 공유자의 세션에 실시간 접속됩니다.
- 읽기 전용 권한일 경우, 터미널에 명령을 입력할 수 없습니다.
▸ 방법 2: 이메일 초대를 통한 공유
▸ 공유자
- 세션 카드 또는 터미널 화면에서 공유 아이콘을 클릭합니다.
- 표시되는 공유 모달에서 이메일로 초대를 선택합니다.
- 초대할 사용자의 이메일 주소를 입력합니다. (복수 입력 가능)
- 초대 버튼을 클릭하면, 입력한 이메일로 초대 메일이 발송됩니다.
초대 메일에는 공유 URL과 비밀번호가 함께 포함되어 있으며,
이메일 수신자는 이 정보를 통해 세션에 접속할 수 있습니다.
▸ 공유 대상자
- 이메일로 받은 공유 URL을 브라우저에서 엽니다.
- 메일에 포함된 비밀번호를 입력하여 세션에 접속합니다.
- 공유자의 권한 설정에 따라, 실시간 협업 또는 읽기 전용 모드로 터미널에 접근할 수 있습니다.