---
title: "에디터 접속하기"
description: "Editor를 열기 전에 서버 상태와 작업 세션의 편집 권한을 확인하고 접속 계정을 고릅니다. 워크스페이스가 에디터 MFA를 요구할 때 본인 계정이 아닌 계정으로 접속하면 추가 인증을 마쳐야 합니다. 처음 연결할 때의 화면과 연결이 끊긴 뒤 기존 에디터로 돌아가는 방법도 확인하세요."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# 에디터 접속하기

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

## 에디터 열기

에디터는 [작업 세션](/use/work-sessions/)을 통해 열립니다. **코드 에디터** 기능을 포함해 세션을 요청하고, 승인되면 세션에서 에디터를 실행합니다.

1. 서버 카드나 상세 페이지에서 연결을 클릭합니다(또는 Sessions를 열어 새 세션을 만듭니다).
2. 요청에 **코드 에디터** 기능을 포함해 제출합니다. [세션 요청하기](/use/work-sessions/create/)를 참고하세요.
3. 세션이 **활성** 상태가 되면 **세션** 탭을 엽니다. 편집할 서버의 **에디터** 버튼을 누릅니다.
4. 새 브라우저 탭에서 에디터가 열립니다.

대시보드의 **내 활성 세션**에서 시작할 수도 있습니다.

이미 연 에디터로 돌아가려면 탭을 새로고침하거나 에디터 주소를 다시 열거나, 세션의 **이어하기** 탭에서 **다시 연결**을 누르세요. [에디터 세션](/use/work-sessions/editor/sessions/#에디터로-돌아가기)을 참고하세요.

## 접속 요구사항

- 서버가 커미션되고 **온라인** 상태여야 합니다
- 서버의 **코드 에디터** 설정이 켜져 있어야 합니다. 꺼져 있다면 해당 서버의 **에디터** 버튼에서 열 수 없는 이유를 확인할 수 있습니다. [터널과 코드 에디터](/use/servers/manage/#터널과-코드-에디터)를 참고하세요
- 해당 서버에 대해 **코드 에디터** 기능을 포함한 **활성** 작업 세션이 있어야 합니다
- 해당 서버에 할당된 그룹에 속해 있어야 합니다(또는 워크스페이스 관리자)

## 계정 선택

에디터는 세션을 요청할 때 **접속 계정**에서 고른 계정으로 접속합니다. 기본값은 본인 계정이며, Alpacon 사용자 이름이 원격 사용자로 사용됩니다. 권한이 필요한 작업은 [sudo와 MFA](/use/work-sessions/terminal/sudo-with-mfa/)를 사용하세요.

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

고를 수 있는 계정과 본인 계정이 아닌 계정을 쓸 수 있는 사람은 [계정 선택](/use/work-sessions/account-selection/)을 참고하세요.

## 본인 계정이 아닌 계정으로 접속할 때의 MFA 인증

워크스페이스가 에디터에 MFA를 요구하면, 본인 계정이 아닌 계정으로 실행되는 세션에서 에디터를 열 때 먼저 MFA 인증을 거칩니다. 본인 계정으로 접속할 때는 필요하지 않습니다.

1. 서버 행의 **에디터** 버튼을 누릅니다
2. MFA가 필요하다는 알림이 표시됩니다
3. MFA 인증 페이지로 이동합니다
4. 인증을 완료합니다(TOTP, 이메일, 전화, WebAuthn)
5. 인증에 성공하면 자동으로 원래 화면으로 돌아가 에디터가 열립니다

인증은 워크스페이스가 정한 시간 동안 유지되므로, 그 안에 에디터를 다시 열 때는 다시 인증하지 않아도 됩니다.

## 최초 접속

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

**접속 단계:**
1. **터널 생성 중**: 서버와의 연결을 엽니다
2. **에디터 준비 중**: 서버에 에디터를 설치하거나 준비합니다
3. **에디터 시작 중**: 에디터를 시작합니다

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

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

## 문제 해결

에디터에 **연결 오류**가 표시되는 경우:
- 화면에 표시된 이유를 확인하세요. 에디터가 종료되었거나 작업 세션이 더 이상 활성 상태가 아니면 활성 세션에서 에디터를 다시 실행하세요
- 서버가 연결되어 있고 온라인 상태인지 확인하세요
- **재시도**를 클릭해 다시 접속해 보세요
- **서버 목록으로**를 클릭해 서버 목록으로 돌아가세요

에디터에 **에디터 연결이 끊어졌어요** 또는 **네트워크 연결이 끊어졌어요** 안내가 표시되는 경우:
- **다시 연결**을 누르세요. 에디터가 아직 실행 중이면 그 에디터로 돌아가고, 이미 종료되었으면 **연결 오류** 화면에 이유가 표시됩니다. [연결이 끊겼을 때](/use/work-sessions/editor/sessions/#연결이-끊겼을-때)를 참고하세요

에디터 대신 "Bad Gateway" 페이지가 표시되는 경우:
- 연결된 브라우저 탭이 없는 상태로 약 1시간(기본값)이 지나 에디터가 종료된 경우입니다. 작업 세션의 **이어하기** 탭에서 그 에디터를 종료한 뒤 새로 실행하세요. [에디터 종료하기](/use/work-sessions/editor/sessions/#에디터-종료하기)를 참고하세요

에디터가 **에디터 준비 중** 단계에서 멈추는 경우:
- 최초 설치에는 몇 분이 걸릴 수 있습니다
- 설치에 실패하면 **재시도**를 클릭하세요

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

## 관련 문서

- [에디터 인터페이스 안내](/use/work-sessions/editor/interface/)
- [에디터 세션](/use/work-sessions/editor/sessions/)
- [터미널 접속하기](/use/work-sessions/terminal/connect/)
- [접근 제어](/use/workspace/settings/roles/)

Source: https://docs.alpacax.com/ko/use/work-sessions/editor/connect/