서버 접속하기
서버에 접속하려면 작업 세션을 요청하고 필요한 도구를 실행합니다.
세션 기반 접근
서버에서 작업하려면 직접 접속하는 대신 작업 세션을 요청합니다. 세션이 활성 상태가 되면 웹 터미널, 파일 전송, 코드 에디터, 명령 실행 등 허용된 도구를 사용할 수 있습니다.
연결을 처음 클릭하면 이 흐름을 설명하는 짧은 안내가 표시됩니다: “이제 세션 단위로 서버에 접속해요. ‘연결’을 누르면 작업 세션을 요청해요. 승인되면 기존의 서버 접속 기능들을 바로 쓸 수 있어요.”
서버에 접속하기
- Servers 페이지로 이동합니다.
- 작업할 서버를 찾습니다.
- 서버 카드 또는 서버 상세 페이지에서 연결을 클릭합니다.
- 해당 서버가 이미 선택된 상태로 세션 요청 폼이 열립니다.
- 필요한 기능을 선택하고 목적과 사용 시간을 추가한 뒤 제출합니다. 세션 요청하기를 참고하세요.
요청이 허용되고 시작 시각이 되면 세션이 활성 상태가 되어 기능을 실행할 수 있습니다. 승인 여부는 워크스페이스의 접근 규칙에 따라 결정됩니다.
하나의 세션에 여러 서버를 추가할 수도 있습니다. 아무 서버의 연결 버튼으로 시작한 뒤 요청 폼에서 서버를 더 추가하세요.
필요 조건
연결 버튼은 다음 조건에서만 사용할 수 있습니다.
- 서버가 커미션되고 온라인 상태입니다.
- 해당 서버에 할당된 사용자 그룹에 속해 있습니다(또는 워크스페이스 관리자입니다).
- 워크스페이스 멤버입니다.
서버가 오프라인이거나 커미션되지 않은 경우 연결이 비활성화되고, 카드에 서버 주소 대신 연결 없음이 표시됩니다.
세션에서 도구 실행하기
세션이 활성화되면 세션 탭에서 작업할 서버를 찾으세요.
- 세션에 포함된 기능에 따라 해당 서버의 터미널, 파일, 에디터 버튼을 눌러 브라우저에서 엽니다.
- 명령 실행과 포트 포워딩은 세션에 진입한 뒤 Alpacon CLI에서 사용합니다.
Windows 서버에서는 코드 에디터를 사용할 수 없습니다. 웹 터미널, 파일 전송, 명령 실행은 지원되고, 포트 포워딩은 Alpamon 2.5.1 이상에서 사용할 수 있습니다. Windows 서버를 참고하세요.
실행, CLI 진입, 연장, 종료까지 전체 과정은 세션 사용하기를 참고하세요.
계정 선택
기능을 실행하면 원격 서버에서 특정 계정으로 작업하게 됩니다. 이 계정은 세션을 요청할 때 접속 계정에서 고른 계정입니다. 기본값은 본인 계정이며, 권한이 필요한 작업에는 sudo와 MFA를 사용합니다. Linux, macOS, Windows 서버 모두 같은 방식으로 고릅니다. 자세한 내용은 계정 선택을 참고하세요.
sudo가 요청하는 MFA 인증은 대화형 로그인에서만 완료할 수 있습니다. 웹 콘솔이나, API 토큰 없이 alpacon login으로 로그인한 CLI가 여기에 해당합니다. 인증을 완료할 수 있는 로그인 방식을 참고하세요.
Windows에서 선택한 계정은 감사 라벨일 뿐이며, 표시된 계정과 무관하게 기능이 SYSTEM 권한으로 실행됩니다. Windows 서버를 참고하세요.
어떤 계정으로 접속할 수 있나요
세션을 열 수 있는 계정은 해당 서버에서의 역할에 따라 달라집니다.
| 역할 | 접속 가능한 계정 |
|---|---|
| 서버에 할당된 사용자 그룹의 멤버 | 본인 계정만 |
| 할당된 그룹의 소유자(Owner) 또는 관리자(Manager), 서버의 maintainer, Staff 또는 Superuser 역할을 가진 사용자 | 서버에 존재하는 모든 계정(단, root 제외) |
root로 접속하려면 워크스페이스에서 root 직접 로그인이 추가로 켜져 있어야 합니다. 이 설정은 기본적으로 꺼져 있으며, 꺼져 있는 동안에는 root 권한 작업에 sudo와 MFA를 사용하세요. 어떤 경우든 대상 계정이 서버에 존재하고 로그인이 활성화되어 있어야 합니다. 계정 선택을 참고하세요.
문제 해결
연결 버튼이 비활성화됨:
- 서버가 온라인이고 커미션되었는지 확인하세요.
- 해당 서버에 접근 권한이 있는 사용자 그룹에 속해 있는지 확인하세요.
- Alpacon 서비스 상태에서 진행 중인 서비스 장애가 있는지 확인하세요.
기능을 실행할 수 없음:
- 세션이 활성 상태이고 사용 시간 범위 내에 있어야 합니다.
- 코드 에디터와 포트 포워딩은 각 기능이 서버에서 켜져 있어야 합니다. 터널과 코드 에디터를 참고하세요.
브라우저에서 도구가 열리지 않음:
- 브라우저의 팝업 차단을 해제한 뒤 다시 시도하세요.