세션 관리하기
작업 세션에서 Websh 터미널에 다시 접속하고, 지원 플랜에서는 팀원과 공유합니다.
터미널 연결 유지
터미널은 작업 세션을 통해 열리며, 브라우저 탭을 닫아도 연결이 유지됩니다. 세션이 활성 상태인 동안 다시 접속할 수 있으며, 지원 플랜에서는 팀원과 세션을 공유해 함께 작업할 수 있습니다.
세션 재접속
터미널 세션은 백그라운드에서 유지됩니다. 돌아가려면 작업 세션의 이어하기 탭에서 돌아갈 터미널의 다시 연결을 누르세요. 자세한 내용은 열린 터미널과 에디터를 참고하세요. 활성 세션은 접근 > Sessions에 표시되며, 슈퍼유저는 다른 사용자의 활성 세션도 볼 수 있습니다.
터미널을 끝내려면 exit를 입력하거나 세션에서 종료하세요.
연결 상태
터미널 헤더에는 현재 연결 상태가 표시됩니다.
| 상태 | 의미 |
|---|---|
| 연결 중 | Alpacon이 연결을 여는 중입니다. |
| 연결됨 | 연결되어 바로 입력할 수 있는 상태입니다. |
| 재연결 중 | 연결이 끊어져 자동으로 재시도하고 있습니다. 이 동안 입력한 내용은 순서대로 대기했다가 연결이 돌아오면 전달됩니다. 다만 한도가 있어서, 한도를 넘으면 그 이후 입력은 전송되지 않고 알림이 표시됩니다. |
| 오프라인 | 브라우저의 네트워크 연결이 끊긴 상태입니다. 연결이 돌아오면 터미널이 자동으로 재접속합니다. |
| 연결 끊김 | 자동 재접속이 더 이상 시도되지 않는 상태입니다. 재시도를 클릭하거나, 다른 브라우저 탭으로 이동했다가 돌아오면 재접속을 다시 시도합니다. |
| 연결 해제됨 | 세션에서 제외되었거나, Alpacon이 원인을 알 수 없는 이유로 연결이 종료된 상태입니다. 자동으로 재접속하지 않으므로 재시도를 클릭해 다시 참여하세요. |
| 세션 종료됨 | 세션이 끝난 상태입니다. 세션 종료 사유에서 원인과 해결 방법을 확인하세요. |
본인이 세션을 직접 종료했거나 셸이 종료되어 세션이 끝난 경우, 터미널 자동 닫기가 켜져 있으면 브라우저 탭도 자동으로 닫힙니다(Websh 설정 참고). 그 외의 종료(제한 시간 초과, 관리자 종료, 연결 끊김 등)는 이유를 확인할 수 있도록 탭이 열린 채로 남습니다.
세션 종료 사유
콘솔에 표시된 안내를 찾아 종료 사유와 해결 방법을 확인하세요. 사용자가 터미널을 닫았거나, 에이전트가 재시작되었거나, 승인된 계정이 바뀌었을 때는 세션이 종료됐어요. 안내가 표시됩니다. 구체적인 종료 사유를 알 수 없을 때도 같은 안내가 표시됩니다.
| 코드 | 의미 | 조치 |
|---|---|---|
세션 종료# | "세션이 종료됐어요." 사용자가 터미널을 닫았거나, 에이전트가 재시작되었거나, 승인된 계정이 바뀐 경우입니다. 구체적인 종료 사유를 알 수 없을 때도 표시됩니다. | 작업 세션이 활성 상태이면 사용할 수 있는 계정으로 터미널을 다시 여세요. 작업 세션이 끝났으면 다른 작업 세션을 요청하세요. |
관리자 종료# | "관리자가 세션을 종료했어요." 관리자가 터미널을 종료했습니다. | 관리자에게 사유를 확인한 뒤, 작업 세션이 활성 상태이면 터미널을 다시 여세요. |
제한 시간 초과# | "세션 제한 시간이 지나 종료됐어요." 터미널을 연 뒤 제한 시간이 지났습니다. 명령어를 입력하거나 출력이 계속되는 중에도 종료됩니다. | 터미널을 다시 여세요. 개인 세션 유지 시간은 워크스페이스 한도까지 늘릴 수 있습니다. |
셸 종료# | "셸이 종료되어 세션이 끝났어요." exit나 Ctrl-D를 입력했거나 셸이 멈추어 종료된 경우입니다. | 작업 세션에서 터미널을 다시 여세요. |
에이전트 연결 끊김# | "에이전트 연결이 끊겨 세션이 종료됐어요." 서버 에이전트의 연결이 끊긴 뒤 터미널 연결을 복구하지 못했습니다. | 서버가 연결 상태인지 확인한 뒤 터미널을 다시 여세요. |
터미널 서비스 재시작# | "터미널 서비스가 재시작되어 세션이 종료됐어요." 터미널 서비스가 재시작된 뒤 이 터미널을 다시 연결하지 못했습니다. | 터미널을 다시 여세요. |
작업 세션 만료# | "작업 세션이 만료되어 세션이 끝났어요." 작업 세션이 만료되었습니다. | 다른 작업 세션을 요청하세요. 같은 작업 세션에서 계속 작업하려면 만료되기 전에 연장하세요. |
작업 세션 완료# | "작업 세션이 완료되어 세션이 끝났어요." 작업 세션이 완료되었습니다. | 다른 작업 세션을 시작하세요. |
작업 세션 철회# | "관리자가 작업 세션을 철회해 세션이 끝났어요." 관리자가 작업 세션을 철회했습니다. | 관리자에게 사유를 확인하고 필요한 경우 다른 작업 세션을 요청하세요. |
계정 비활성화# | "계정이 비활성화되어 세션이 끝났어요." 워크스페이스 계정이 비활성화되었습니다. | 워크스페이스 관리자에게 문의하세요. |
다른 사람에게 계정 연결# | "이 계정이 다른 사람에게 연결돼 이 세션을 닫았어요." 서버 계정이 다른 사람에게 연결되었습니다. | 본인 계정이나 공유 계정으로 다시 접속하세요. |
연결 종료# | "이 세션과의 연결이 끊어졌어요." 터미널에서 제외되었거나, 구체적인 사유 없이 연결이 끊겼습니다. 자동으로 다시 연결하지 않습니다. | 연결을 다시 시도하세요. 공유 링크로 참여했다면 소유자에게 다른 링크를 요청하세요. |
이 세션과의 연결이 끊어졌어요. 안내가 표시되면 재시도를 선택하세요. 공유 링크로 참여한 사람에게 연결이 종료됐어요 안내가 표시되면 소유자에게 다른 링크를 받아야 합니다. 세션이 이미 종료되었어요.는 터미널이 끝났다는 뜻이고, 해당 URL은 더 이상 유효하지 않아요.는 공유 링크가 유효하지 않다는 뜻입니다.
사용 제한
| 제한 항목 | 적용 내용 |
|---|---|
| 세션 유지 시간 | 기본값은 터미널을 연 시점부터 1일입니다. 개인 설정으로 줄일 수 있으며, 워크스페이스 한도를 넘길 수 없습니다. |
| 공유 링크 만료 시간 | 5~180분이며 기본값은 30분입니다. 링크는 한 번만 사용할 수 있습니다. |
| 이메일 초대 | 한 번에 이메일 주소를 20개까지 입력할 수 있습니다. 중복 입력한 주소도 개수에 포함됩니다. |
| 월간 Websh 사용량과 공유 | 워크스페이스 플랜에 따라 제공 여부와 한도가 달라집니다. |
| 터미널 녹화 재생 | Free에서는 녹화를 재생할 수 없습니다. 아래 안내가 표시되며, 유료 플랜에서는 플랜에 따라 녹화를 볼 수 있습니다. |
Free에서는 터미널 녹화는 Essentials 요금제부터 볼 수 있어요. 안내가 표시됩니다. 플랜별 제공 범위는 플랜과 결제를, 재생 방법은 터미널 녹화를 참고하세요.
키 입력, 터미널 출력, 브라우저 재접속으로는 제한 시간이 초기화되지 않습니다. 작업 세션의 이어하기 탭에서 다시 연결해도 같습니다. 에이전트의 터미널 연결이 다시 맺어질 때만 이 시간이 초기화됩니다. 제한 시간 전이라도 작업 세션이 끝나면 터미널이 종료될 수 있습니다.
Websh 설정에서 세션 유지 시간을 조정하세요. 최소 10분이며 워크스페이스의 Websh 세션 유지 시간을 넘길 수 없습니다. 관리자는 워크스페이스 한도를 10분부터 1일까지 설정할 수 있습니다.
세션 공유
터미널은 세션 소유자만 공유할 수 있습니다. 워크스페이스 멤버나 외부 협업자를 초대해 화면을 함께 보거나 명령어를 입력할 수 있습니다.
세션 공유는 Essentials 플랜 이상에서 제공됩니다. Free 플랜에서는 공유 시 업그레이드 안내가 표시됩니다. 플랜과 결제를 참고하세요.
세션에서 공유를 클릭하고 다음 중 하나를 선택합니다.
- 이메일로 초대: 이메일 주소를 20개까지 입력해 직접 초대합니다.
- 1회용 액세스 링크: 공유할 링크를 만듭니다.
1회용 액세스 링크
링크 생성 시 다음을 설정합니다.
- 사용자 권한: 읽기 전용(보기만) 또는 읽기 & 쓰기(명령 입력) 중에서 선택합니다. 링크는 기본적으로 읽기 전용입니다.
- 링크 만료: 5분부터 180분까지 5분 단위로 설정하며, 기본값은 30분입니다. 링크는 1회용이라 한 번 접속하면 즉시 만료됩니다.
소유자가 접속해 있는 동안에는 링크와 비밀번호를 가진 사람 누구나 참여할 수 있습니다. 로그인하지 않은 사람은 닉네임을 입력해야 합니다. 사용했거나 만료된 링크는 다시 쓸 수 없으므로 소유자에게 다른 링크를 요청하세요.
참여자
터미널 헤더의 참여자 아이콘을 선택하면 참여자 패널이 열립니다. 아이콘에는 세션에 있는 인원 수가 표시되고, 패널이 열려 있는 동안 목록이 자동으로 갱신됩니다. 소유자는 참여자를 선택해 다음을 할 수 있습니다.
- 참여자 권한을 읽기 전용과 입력 가능 사이에서 변경합니다. 변경은 바로 적용됩니다.
- 세션에서 내보내기로 참여자를 내보냅니다.
공유 링크 없이 다른 사용자의 세션을 열 수 있는 사람은 관리자뿐이며, 읽기 전용으로만 참여할 수 있습니다. 슈퍼유저는 세션 목록에서 다른 사용자의 세션에 강제 종료를 사용할 수 있습니다.
공유 활용 사례
- 함께 디버깅: 팀원이 동일한 화면을 보고 명령을 제안하거나 실행합니다.
- 안전한 교육: 읽기 전용으로 공유해 입력 없이 관찰하게 합니다.
- 도움 받기: 시니어 엔지니어를 초대해 실시간 출력을 함께 확인합니다.