에디터 접속하기

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

에디터 열기

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

  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 장치가 사용 가능한지 확인
  • 문제가 지속되면 워크스페이스 관리자에게 문의

관련 문서

최종 수정: