에디터 접속하기

브라우저에서 바로 코드 에디터에 접속하여 원격 서버의 파일을 편집할 수 있습니다.

에디터 열기

에디터는 작업 세션을 통해 열립니다. 코드 에디터 기능을 포함해 세션을 요청하고, 승인되면 세션에서 에디터를 실행합니다.

  1. 서버 카드나 상세 페이지에서 연결을 클릭합니다(또는 Sessions를 열어 새 세션을 만듭니다).
  2. 요청에 코드 에디터 기능을 포함해 제출합니다. 세션 요청하기를 참고하세요.
  3. 세션이 활성 상태가 되면 세션을 열고 코드 에디터 기능의 실행을 클릭합니다. 세션에 에디터가 활성화된 서버가 여러 대면 서버를 선택합니다.
  4. 새 브라우저 탭에서 에디터가 열립니다.

Dashboard의 활성 세션에서도 에디터를 실행할 수 있습니다.

접속 요구사항

  • 서버가 커미션되고 온라인 상태여야 합니다
  • 서버 설정에서 에디터 활성화가 켜져 있어야 합니다(서버 소유자가 설정, 서버 관리하기 참고)
  • 해당 서버에 대해 코드 에디터 기능을 포함한 활성 작업 세션이 있어야 합니다
  • 해당 서버에 할당된 그룹에 속해 있어야 합니다(또는 워크스페이스 관리자)

계정 선택

접속하는 계정은 서버의 운영체제에 따라 다릅니다.

Linux 서버: 항상 본인 계정으로 접속합니다. Alpacon 사용자 이름이 원격 사용자로 사용됩니다. 시스템 계정 선택은 제공되지 않습니다. 권한이 필요한 작업은 sudo와 MFA를 사용하세요.

macOS 서버: sudo 권한이 있는 사용자는 서버에서 사용 가능한 시스템 계정 중 선택할 수도 있습니다. 시스템 계정으로 접속하면 워크스페이스 보안 설정에 따라 MFA 인증이 필요할 수 있습니다.

에디터는 Windows 서버에서는 사용할 수 없습니다.

자세한 내용은 계정 선택을 참고하세요.

시스템 계정 접근 시 MFA 인증

워크스페이스 보안 설정에서 권한 있는 접근에 MFA를 요구하면 다음 순서로 진행됩니다.

  1. 시스템 계정을 선택하고 Connect를 클릭합니다
  2. MFA가 필요하다는 알림이 표시됩니다
  3. MFA 인증 페이지로 이동합니다
  4. 인증을 완료합니다(TOTP, 이메일, 전화, WebAuthn)
  5. 인증에 성공하면 자동으로 에디터로 돌아갑니다
  6. 연결이 이뤄지고 에디터가 열립니다

MFA 인증은 워크스페이스 설정에서 구성된 기간 동안 유효합니다. 이 기간 내 후속 시스템 계정 접속에는 재인증이 필요하지 않습니다.

최초 접속

에디터를 통해 서버에 처음 접속하면 에디터 환경이 자동으로 설치됩니다. 이 과정은 몇 분 정도 소요될 수 있습니다.

접속 단계:

  1. “에디터 환경을 설치하는 중…”: 서버에 에디터 설치 중
  2. “에디터를 시작하는 중…”: 에디터 시작 중

준비가 끝나면 에디터가 열립니다.

같은 서버에 이후 접속할 때는 환경이 이미 설치되어 있으므로 더 빠르게 연결됩니다.

문제 해결

에디터에 “연결 오류”가 표시되는 경우:

  • 서버가 연결되어 있고 온라인 상태인지 확인하세요
  • Retry를 클릭해 다시 접속해 보세요
  • Back to Servers를 클릭해 서버 목록으로 돌아가세요

에디터가 “설치 중”에서 멈추는 경우:

  • 최초 설치에는 몇 분이 걸릴 수 있습니다
  • 설치에 실패하면 Retry를 클릭하세요

MFA 인증이 실패하는 경우:

  • 워크스페이스에서 허용하는 MFA 방식을 등록했는지 확인하세요
  • MFA 장치를 사용할 수 있는지 확인하세요
  • 문제가 계속되면 워크스페이스 관리자에게 문의하세요

관련 문서

최종 수정: