바른 도커 설치 10분 가이드

바른(bareun)은 도커 이미지로 배포되어, 명령어 몇 줄이면 한국어 형태소 분석 서버를 띄울 수 있습니다. 이 글은 docker pull부터 API키 등록, 첫 분석 요청까지 약 10분이면 끝나도록 정리한 빠른 설치 가이드입니다. 더 자세한 옵션과 설정은 도커 설치 문서를, 처음 시작이라면 빠른 시작을 함께 보세요.

1. 이미지 받기 (약 2분)

docker pull bareunai/bareun:latest

2. 서버 실행 (약 1분)

데이터·로그가 저장될 디렉토리를 만들고 컨테이너를 띄웁니다. 도커 배포본은 5656 포트로 서비스합니다.

mkdir -p ~/bareun/var
docker run -d -p 5656:5656 -v ~/bareun/var:/bareun/var bareunai/bareun:latest

• -d: 백그라운드 실행
• -p 5656:5656: 호스트 5656 포트를 컨테이너에 연결
• -v ~/bareun/var:/bareun/var: 바른 등록 결과 또는 라이선스, 사용자 사전, 로그, 첫 기동에 내려받은 모델을 호스트에 보존(이 마운트를 빼면 컨테이너를 다시 만들 때마다 모델 수백 MB를 다시 내려받습니다)

3. API키 등록 (약 1분)

발급받은 본인의 API키로 -reg 옵션을 실행합니다.

docker exec bareun /bareun/bin/bareun -reg koba-ABCDEFG-1234567-LMNOPQR-7654321

4. 첫 분석 요청 (약 3분)

파이썬 클라이언트로 바로 확인해봅니다.

from bareunpy import Tagger

API_KEY = "koba-ABCDEFG-1234567-LMNOPQR-7654321"  # 본인 키로 교체
tagger = Tagger(API_KEY, 'localhost', 5656)
res = tagger.tags(["안녕하세요.", "바른을 도커로 설치했습니다."])
print(res.pos())

[('안녕하', 'VA'), ('시', 'EP'), ('어요', 'EF'), ('.', 'SF'),
 ('바른', 'NNP'), ('을', 'JKO'), ('도커', 'NNG'), ('로', 'JKB'),
 ('설치하', 'VV'), ('았', 'EP'), ('습니다', 'EF'), ('.', 'SF')]

라이브러리는 pip install bareunpy로 설치합니다. 파이썬 외에도 자바·자바스크립트·R 클라이언트와 엘라스틱서치 플러그인을 제공하므로, 같은 서버를 여러 언어에서 함께 쓸 수 있습니다. 분석 API 호출 방법은 API로 형태소 분석하기에 자세히 정리되어 있습니다.

자주 묻는 질문

Q. 도커로 설치하면 맞춤법 검사기도 되나요?

무료로 설치 가능한 바른은 형태소 분석기까지만 제공됩니다. 맞춤법 검사기는 클라우드 (api.bareun.ai)에서 제공되며, 폐쇄망 설치는 별도 유료 계약이 필요합니다.

Q. API키 등록 화면을 웹으로 열 수도 있나요?

네. 설치된 시스템에서 API키 등록 웹 페이지로 접속해 등록할 수도 있습니다. 명령어 방식(-reg)과 결과는 같습니다.

Q. 컨테이너를 재시작해도 키가 유지되나요?

네. -v ~/bareun/var:/bareun/var로 마운트했다면 바른 등록 결과 및 라이선스, 사용자 사전, 로그가 호스트에 보존되어 재시작 후에도 유지됩니다.

Q. 도커 배포본은 어떤 언어 클라이언트로 호출하나요?

파이썬(pip install bareunpy)·자바·자바스크립트·R 클라이언트와 엘라스틱서치 플러그인을 제공합니다. 바른은 서버로 동작하므로 하나의 설치본을 여러 사용자와 여러 언어에서 동시에 사용할 수 있습니다. REST API와 gRPC도 지원합니다.

관련 문서

• 도커 설치
• 빠른 시작
• API로 형태소 분석하기
• 가장 빠르게 체험하는 3가지 방법