Page History

기능설명

Export API 서버는 에디터에서 사용된 이미지를 다운로드한 뒤, 문서를 HWPX, DOCX 등 다양한 포맷으로 변환하여 파일을 반환하는 역할을 합니다.

실행환경

실행환경

본 Export API 실행 모듈은 Docker 컨테이너 환경에서 실행됩니다.
Docker가 설치 및 실행 가능한 Linux 운영체제에서 사용 가능합니다.

다음은 검증된 환경 예시입니다.

• Ubuntu 18.04 이상

• CentOS 7 이상 / RHEL 7 이상

• Debian 9 이상

• Fedora 30 이상

운영 환경에서는 Linux (x86_64 / amd64) 서버에서의 실행을 권장합니다.
해당 환경에서는 아키텍처 에뮬레이션 없이 네이티브로 실행되어 성능 및 안정성이 가장 우수합니다.

컨테이너 내부 실행 환경은 node:18-slim 이미지를 기반으로 하며,
호스트 운영체제에 따른 실행 모듈의 동작 차이는 없습니다.

macOS(Apple Silicon) 및 Windows 환경에서도 Docker Desktop을 통해 실행이 가능하나,
해당 환경에서는 아키텍처 에뮬레이션이 사용될 수 있으므로 개발 및 테스트 용도로만 사용하는 것을 권장합니다.

실행 방법

## Installation
# Load Docker image:
docker load -i export_api.tar

# Docker run
docker run -d --name export-api \
  -p 9090:9090 \
  -e REMOTE_SOURCE_PROXY_DOMAINS=example.com,.internal.local \
  -e REMOTE_SOURCE_PROXY_TARGET=http://10.0.0.5:8080/remote/ \
  export-api:latest

옵션 설명

- `PORT`: 서버 리스닝 포트 (기본값 9090)

서버 상태 check

http://localhost:9090/health

에디터 툴바설정에 'export'추가시 내보내기 다이얼로그를 사용할 수 있습니다.

{
    'editor.toolbar': [..., 'export', ...]
}

익스포트 UI 다이얼로그

Image Removed

파일 포맷을 지정합니다.

다른 포맷(hwp, doc, docx 등)으로 저장이 필요한 경우 고객문의

용지 방향을 설정합니다.

A4 세로(defalut)

A4 가로

저장할 파일명을 입력합니다.

문자열

(미입력 시: untitled)

내보내기 시 생성된 파일은 사용 중인 브라우저의 기본 다운로드 경로에 저장됩니다.

'editor.export.extensions' 키를 사용해 임포트 가능한 문서 확장자를 설정할 수 있습니다.

{   // TODO 작업해야함
    'editor.export.extensions' : ['HWPX']
}

API

관련기능

• Export API 설정