에디터 접속하기
브라우저에서 바로 코드 에디터에 접속하여 원격 서버의 파일을 편집할 수 있습니다.
빠른 접속
에디터는 세 곳에서 열 수 있습니다:
서버 목록에서:
- Servers 페이지로 이동
- 연결된 서버 찾기
- 서버 행의 Editor 버튼 클릭
- 계정을 선택하고 Connect 클릭
- 새 탭에서 에디터가 열림
서버 상세에서:
- 서버 이름을 클릭하여 상세 페이지 열기
- Editor 버튼 클릭
- 계정을 선택하고 Connect 클릭
대시보드 (즐겨찾기 서버)에서:
- Dashboard로 이동
- 즐겨찾기 서버 찾기
- Editor 링크 클릭
- 계정을 선택하고 Connect 클릭
접속 요구사항
- 서버 상태: Connected
- 서버: Commissioned (등록 완료)
- 사용자: 서버에 할당된 그룹에 소속
- 활성 세션이 있는 워크스페이스 멤버
계정 선택
접속 시 원격 서버에서 사용할 계정을 선택합니다:
내 계정: Alpacon 사용자 이름이 원격 사용자로 사용됩니다. 기본 선택입니다.
시스템 계정: 서버에서 사용 가능한 시스템 계정 중 선택합니다. sudo 권한이 있는 경우에만 표시됩니다. 워크스페이스 보안 설정에 따라 MFA 인증이 필요할 수 있습니다.
시스템 계정 접근 시 MFA 인증
워크스페이스 보안 설정에서 권한 있는 접근에 MFA를 요구하는 경우:
- 시스템 계정을 선택하고 Connect 클릭
- MFA가 필요하다는 알림이 표시됨
- MFA 인증 페이지로 리다이렉트
- 인증 완료 (TOTP, 이메일, 전화, 또는 WebAuthn)
- 인증 성공 후 자동으로 에디터로 리다이렉트
- 연결이 설정되고 에디터가 열림
MFA 인증은 워크스페이스 설정에서 구성된 기간 동안 유효합니다. 이 기간 내 후속 시스템 접속에는 재인증이 필요하지 않습니다.
최초 접속
에디터를 통해 서버에 처음 접속하면 에디터 환경이 자동으로 설치됩니다. 이 과정은 몇 분 정도 소요될 수 있습니다.
접속 단계:
- “에디터 터널을 생성하고 있어요…”: 연결 설정 중
- “에디터 환경을 설치하는 중…”: 서버에 에디터 설치 중
- “에디터를 시작하는 중…”: 에디터 시작 중
- “에디터 준비 완료”: 에디터 인터페이스가 표시됨
같은 서버에 이후 접속할 때는 환경이 이미 설치되어 있으므로 더 빠르게 연결됩니다.
문제 해결
에디터에 “연결 오류”가 표시되는 경우:
- 서버가 연결되어 있고 온라인 상태인지 확인
- Retry를 클릭하여 재접속 시도
- Back to Servers를 클릭하여 서버 목록으로 돌아가기
에디터가 “설치 중”에서 멈추는 경우:
- 최초 설치에는 몇 분이 걸릴 수 있음
- 약 2~3분 후 자동으로 타임아웃됨
- 설치에 실패하면 Retry 클릭
MFA 인증이 실패하는 경우:
- 워크스페이스에서 허용하는 MFA 방식을 등록했는지 확인
- MFA 장치가 사용 가능한지 확인
- 문제가 지속되면 워크스페이스 관리자에게 문의