---
url: https://docs.ogmabox.com/ko/app/plugins.md
description: 로컬 패키지, 폴더, ZIP 아카이브, 마켓플레이스에서 Ogma 플러그인을 설치하고 관리, 업데이트, 개발합니다.
---

# 플러그인 {#plugins}

플러그인은 사용자 지정 UI 페이지, 백엔드 처리, 이벤트 훅, 설정 패널로 Ogma를 확장합니다. 모든 기능은 플러그인이 선언한 권한 범위 안에서 동작합니다.

## 플러그인이 추가할 수 있는 기능 {#what-plugins-can-add}

* 왼쪽 탐색 메뉴에서 접근하는 사용자 지정 UI 페이지.
* 요청이나 응답을 처리하는 백엔드 라우트.
* 캡처된 트래픽에 의해 실행되는 이벤트 훅.
* 플러그인 전용 설정 페이지.
* 명령 팔레트에 등록할 수 있는 명령.

## 폴더에서 설치 {#install-from-folder}

1. 플러그인 화면에서 **설치**를 클릭합니다.
2. **폴더 경로**를 선택합니다.
3. 플러그인 루트 디렉터리를 선택합니다. 유효한 플러그인 매니페스트와 매니페스트에서 선언한 파일이 있어야 합니다.
4. Ogma가 패키지를 검증하고 등록합니다.
5. 플러그인을 활성화하여 동작시킵니다.

## ZIP 아카이브에서 설치 {#install-from-zip-archive}

1. 플러그인 화면에서 **설치**를 클릭합니다.
2. **ZIP 파일**을 선택합니다.
3. 플러그인 `.zip` 파일을 선택합니다.
4. 감지된 플러그인 이름과 버전을 검토합니다.
5. **설치**를 클릭한 뒤 플러그인을 활성화합니다.

ZIP으로 설치한 파일은 Ogma가 관리하는 플러그인 디렉터리로 복사됩니다. 설치 후 원본 아카이브를 삭제해도 됩니다.

## 호환성 경고 {#compatibility-warnings}

설치 후 Ogma가 플러그인 상세 페이지에 경고를 표시할 수 있습니다. 이는 참고 정보이며 플러그인 실행을 막지 않습니다.

일반적인 경고:

* **참조되지 않은 파일** - 패키지에 있지만 매니페스트에 선언되지 않은 파일.
* **런타임 호환 계층 누락** - 플러그인이 사용하는 API에 필요한 호환 계층이 현재 Ogma 버전에 없는 경우.

익숙하지 않은 플러그인을 켜기 전에 경고를 검토하세요.

## 활성화 및 비활성화 {#enable-and-disable}

플러그인 행의 **활성화됨** 스위치로 켜거나 끕니다. 비활성화된 플러그인은 설치된 상태로 남지만 실행되지 않습니다. 다시 켜면 재설치 없이 사용할 수 있습니다.

## 플러그인 상세 탭 {#plugin-detail-tabs}

플러그인을 선택하면 상세 패널이 열립니다. 다음 탭이 있습니다.

| 탭 | 내용 |
|-----|----------|
| 개요 | 플러그인 이름, 버전, 작성자, 설명, 출처. |
| 경고 | 설치 또는 활성화 시 발견된 호환성 문제. |
| 권한 | 플러그인이 요청한 권한과 Ogma가 실행 시 허용한 권한. |
| 파일 | 플러그인 패키지의 파일 목록. |
| 로그 | 플러그인의 런타임 출력. 구조화된 로그 행에는 구문 강조가 적용됩니다. |
| UI | 패널 안에서 렌더링되는 플러그인의 사용자 지정 페이지. |

## 권한 {#permissions}

권한 탭에는 플러그인이 매니페스트에 선언한 각 권한과 현재 허용 상태가 표시됩니다. 백엔드 호출 권한은 서버 측에서 강제 적용됩니다. UI는 각 권한의 현재 상태를 반영합니다.

플러그인이 예상대로 동작하지 않으면 권한 탭에서 필요한 권한이 허용되어 있는지 확인하세요.

## 개발 모드 {#dev-mode}

폴더에서 설치한 플러그인에는 **개발** 배지와 **새로 고침** 버튼이 표시됩니다.

**새로 고침**을 클릭하면 재설치 없이 코드 변경을 적용할 수 있습니다. 플러그인이 다시 시작되고 모든 훅과 라우트가 재등록됩니다. 플러그인 작성자가 반복 개발할 때 사용하는 일반적인 방식입니다.

개발 모드 플러그인은 소스 폴더와 연결된 상태를 유지합니다. 해당 폴더의 파일 변경은 다음 새로 고침 때 적용됩니다.

## 마켓플레이스 {#marketplace}

**마켓플레이스** 탭은 Awesome Ogma Plugins 레지스트리의 커뮤니티 플러그인을 나열합니다.

1. 플러그인 목록을 둘러보거나 검색합니다.
2. 플러그인을 클릭하여 설명, 버전, 호환성 메타데이터를 확인합니다.
3. **설치**를 클릭하여 바로 설치합니다.
4. 설치된 마켓플레이스 플러그인에 더 최신의 호환 버전이 있으면 작업이 **업데이트**로 바뀝니다.

마켓플레이스 설치에는 패키지를 가져오기 위한 네트워크 연결이 필요합니다.

## 관련 페이지 {#related-pages}

* [플러그인 빠른 시작](/ko/plugins/quickstart)
* [백엔드 SDK](/ko/plugins/backend-sdk)
* [프런트엔드 SDK](/ko/plugins/frontend-sdk)