서버 접속하기

Alpacon은 세션 기반 접근을 사용합니다. 서버에서 작업하려면 직접 접속하는 대신 작업 세션을 요청합니다. 세션이 승인되면 웹 터미널, 파일 전송, 코드 에디터, 명령 실행 등 필요한 도구를 실행합니다.

참고: 연결을 처음 클릭하면 이 흐름을 설명하는 짧은 안내가 표시됩니다: “이제 세션 단위로 서버에 접속해요. ‘연결’을 누르면 작업 세션을 요청해요. 승인되면 기존의 서버 접속 기능들을 바로 쓸 수 있어요.”

서버에 접속하기

1. Servers 페이지로 이동합니다.
2. 작업할 서버를 찾습니다.
3. 서버 카드 또는 서버 상세 페이지에서 연결을 클릭합니다.
4. 해당 서버가 이미 선택된 상태로 세션 요청 폼이 열립니다.
5. 필요한 기능을 선택하고 목적과 사용 시간을 추가한 뒤 제출합니다. 세션 요청하기를 참고하세요.

Superuser 역할을 가진 사용자가 요청을 승인하면 세션이 활성 상태가 되고 기능을 실행할 수 있습니다.

참고: 하나의 세션에 여러 서버를 추가할 수도 있습니다. 아무 서버의 연결 버튼으로 시작한 뒤 요청 폼에서 서버를 더 추가하세요.

필요 조건

연결 버튼은 다음 조건에서만 사용할 수 있습니다.

• 서버가 커미션되고 온라인 상태입니다.
• 해당 서버에 할당된 사용자 그룹에 속해 있습니다(또는 워크스페이스 관리자입니다).
• 워크스페이스 멤버입니다.

서버가 오프라인이거나 커미션되지 않은 경우 연결이 비활성화되고, 카드에 서버 주소 대신 연결 없음이 표시됩니다.

세션에서 도구 실행하기

세션이 활성화되면 세션을 열고 사용 가능한 기능 카드를 사용합니다.

• 웹 터미널, 파일 전송, 코드 에디터는 실행 버튼으로 브라우저에서 열립니다.
• 명령 실행과 포트 포워딩은 세션에 진입한 뒤 Alpacon CLI에서 사용합니다.

Windows 서버에서는 코드 에디터와 포트 포워딩을 사용할 수 없습니다. 웹 터미널, 파일 전송, 명령 실행은 지원됩니다. Windows 서버를 참고하세요.

실행, CLI 진입, 연장, 종료까지 전체 과정은 세션 사용하기를 참고하세요.

계정 선택

기능을 실행하면 원격 서버에서 특정 계정으로 작업하게 됩니다. Linux 서버에서는 본인 IAM 계정으로 접속하고 권한이 필요한 작업은 sudo와 MFA를 사용합니다. Windows·macOS 서버에서는 시스템 계정을 선택할 수도 있습니다. 자세한 내용은 계정 선택을 참고하세요.

Windows에서 선택한 계정은 감사 라벨일 뿐이며, 표시된 계정과 무관하게 기능이 SYSTEM 권한으로 실행됩니다. Windows 서버를 참고하세요.

어떤 계정으로 접속할 수 있나요

세션을 열 수 있는 계정은 해당 서버에서의 역할에 따라 달라집니다.

root로 접속하려면 워크스페이스에서 root 직접 접속 허용이 추가로 켜져 있어야 합니다. 이 설정은 기본적으로 꺼져 있으며, 꺼져 있는 동안에는 root 권한 작업에 sudo와 MFA를 사용하세요. 어떤 경우든 대상 계정이 서버에 존재하고 로그인이 활성화되어 있어야 합니다. 웹 연결 대화상자의 시스템 계정 선택은 Windows·macOS 서버에서 제공됩니다. 계정 선택을 참고하세요.

참고: 개인 API 접근 토큰이나 서비스 토큰으로 접근하면 작업 세션 요청 흐름을 거치지 않습니다. 이 토큰들이 접근할 수 있는 범위는 각 토큰에 설정된 Server ACL(허용 서버 목록)로 제어됩니다.

문제 해결

연결 버튼이 비활성화됨:

• 서버가 온라인이고 커미션되었는지 확인하세요.
• 해당 서버에 접근 권한이 있는 사용자 그룹에 속해 있는지 확인하세요.

기능을 실행할 수 없음:

• 세션이 활성(승인되고 시간 범위 내) 상태여야 합니다.
• 코드 에디터와 포트 포워딩은 해당 기능이 서버에서 활성화되어 있어야 합니다. 서버 관리하기를 참고하세요.

브라우저에서 도구가 열리지 않음:

• 브라우저의 팝업 차단을 해제한 뒤 다시 시도하세요.

관련 문서

• 작업 세션 개요
• 세션 요청하기
• 세션 기능
• 계정 선택