본문으로 건너뛰기

문서

dragoman 설치, 모델 연결, 문제 해결에 필요한 모든 것.

설치

브라우저 스토어에서 dragoman을 설치하면 스토어를 통해 자동으로 최신 상태가 유지됩니다.

Chrome, Edge, Helium 및 기타 Chromium 브라우저
릴리스 직접 설치하기

모든 릴리스는 GitHub에도 올라가 있으며, Chromium 기반 브라우저와 Firefox용 zip 파일과 전체 소스 코드를 제공합니다. 직접 불러온 빌드는 자동으로 업데이트되지 않습니다.

  1. 1 최신 릴리스에서 Chrome용 zip을 내려받아 압축을 푸세요.
  2. 2 helium://extensions(다른 브라우저에서는 chrome://extensions)를 열고 개발자 모드를 켜세요.
  3. 3 압축해제된 확장 프로그램을 로드합니다를 선택하고 압축을 푼 폴더를 고르세요.
최신 릴리스 열기

dragoman을 툴바에 고정해 클릭 한 번으로 쓸 수 있게 하세요.

Android용 Chrome은 확장 프로그램을 지원하지 않습니다. Android에서는 Firefox를 사용하세요.

첫 페이지 번역하기

웹사이트를 열고 dragoman 아이콘을 클릭한 뒤 언어를 고르고 페이지 번역을 선택하세요. 키보드로는 Alt+Shift+T(Mac에서는 Option+Shift+T)를 누르면 됩니다. 초벌 번역에는 금색 점선 밑줄이 표시되며, 모델이 각 문단을 다듬으면 사라집니다.

AltShiftT / ⌥⇧T 페이지 번역 또는 원문 보기

번역된 페이지 읽는 법

기기에서 초벌 번역
모찌는 현재 편집장에게 승진되었다.
직접 고른 모델이 다듬기
모찌는 그 뒤 편집장으로 승진했습니다.
원문은 마우스만 올리면
문단 위에 포인터를 올리면 원래 내용을 볼 수 있습니다. 배지를 한 번 클릭하거나 Alt+Shift+T를 누르면 페이지 전체가 원래대로 돌아갑니다.

휴대폰이나 태블릿에서는 브라우저의 확장 프로그램 메뉴에서 dragoman을 여세요.

브라우저 번역기와 비교

Chrome, Edge, Safari, Firefox는 자체적으로 페이지를 번역할 수 있고, 가볍게 훑어보기엔 그걸로 충분할 때가 많습니다. dragoman은 페이지를 제대로 읽고 싶을 때를 위한 도구입니다. 의미와 표현을 정확하게 살리고, 누가 텍스트를 볼지는 직접 정합니다.

페이지 전체를 읽습니다

내장 번역기는 페이지를 작은 조각으로 나눠 따로따로 번역하기 때문에, 같은 단어가 몇 줄 사이에 서로 다르게 번역되기도 합니다. dragoman은 AI 모델에게 페이지 제목, 소제목, 반복되는 표현을 함께 보여 주므로 이름, 레이블, 용어가 처음부터 끝까지 같은 번역으로 유지됩니다.

조각조각 번역할 때

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Period
Περίοδος
1928–1932
Tenure
Περίοδος
1933
Term

페이지 전체를 보고 번역할 때

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
예시: 정보 상자에 반복되는 그리스어 항목 하나를 영어로 번역한 모습입니다.

텍스트가 어디로 갈지 직접 정합니다

Chrome이나 Edge가 페이지를 번역할 때는 텍스트를 Google이나 Microsoft로 보냅니다. dragoman은 기기에서 초벌 번역을 한 뒤, 지금 읽고 있는 부분만 내 키로 직접 고른 제공업체에 보냅니다. 기기에서만 처리하도록 설정하면 페이지 텍스트는 전혀 밖으로 나가지 않습니다.

페이지 텍스트가 가는 곳

Chrome Google Edge Microsoft dragoman 내 기기 내 AI 제공업체 모델을 추가한 경우, 읽는 부분만 전송
번역할 모델을 직접 고릅니다
Chrome은 Google 번역으로, Edge는 Microsoft Translator로 페이지를 번역합니다. dragoman은 Claude, Gemini, ChatGPT의 모델은 물론 내 컴퓨터에서 실행하는 모델까지, 직접 고른 AI 모델로 번역합니다. 요즘 AI 모델은 관용구와 어조, 문장에 따라 뜻이 달라지는 단어를 대체로 더 잘 다룹니다.
원문을 바로 확인할 수 있습니다
문단에 마우스를 올리거나 휴대폰에서 탭하면, 페이지 전체를 되돌리지 않고도 원래 내용을 읽을 수 있습니다.

브라우저 번역기는 내장되어 있고 무료이며 따로 설정할 필요가 없습니다. dragoman의 기기 내 초벌 번역도 무료이고, 다듬기 비용은 읽은 텍스트에 대해 제공업체가 청구하는 금액뿐이며 작은 모델이라면 대개 아주 적습니다. Firefox 자체 번역기는 dragoman이 Firefox에서 초벌 번역에 쓰는 것과 같은 Bergamot 엔진을 사용하므로, 그곳에서의 차이는 AI 다듬기와 페이지 맥락 반영입니다.

작동 원리
두 단계 번역
브라우저의 기기 내 모델이 백그라운드에서 초벌 번역을 하고, 모델이 없는 경우에는 WebAssembly로 컴파일된 Bergamot이 대신합니다. 그런 다음 화면에 보이는 문단과 곧 나올 문단을 조금씩 묶어 선택한 모델로 보내고, 다듬어진 문단이 초벌 번역을 하나씩 대체합니다.
페이지 맥락
각 요청에는 페이지 제목, 소제목 개요, 페이지에서 반복되는 표현과 그 표현이 처음 나온 주변 텍스트, 그리고 지금까지 정해진 모든 번역어가 함께 담깁니다. 모델은 선택한 용어를 돌려주고, 이후 요청은 그 용어를 그대로 따릅니다.
마크업
링크, 강조 등 인라인 요소는 번호가 매겨진 자리표시자로 전달되므로 레이아웃과 링크가 그대로 돌아옵니다.
읽는 부분만
다듬기는 화면에 보이는 영역을 따라가므로, 긴 페이지라도 스크롤한 부분만큼만 비용이 듭니다. 완성된 번역은 기기에 저장되어 다시 방문할 때 재사용됩니다.
중간 서버 없음
요청은 내 키로 브라우저에서 제공업체로 바로 전송됩니다. dragoman 서버는 없으며, 모든 코드가 공개되어 있습니다.

기기 내 번역

모든 페이지는 기기에서 시작됩니다. dragoman은 Chrome과 Edge에 내장된 기기 내 모델, 그리고 Safari에서는 Apple의 모델로 초벌 번역을 합니다. 이 모델들은 온라인으로 처리되는 브라우저 자체의 페이지 번역과 달리 컴퓨터에서 실행됩니다. 그 밖의 환경이나 이 모델들이 지원하지 않는 언어는 Firefox Translations의 오픈 엔진인 Bergamot이 브라우저 안에서 번역합니다. 계정이나 키는 전혀 필요 없습니다. 이것만으로도 빠르고 안전한 번역을 받을 수 있고, AI 모델을 추가하면 이 초벌 번역을 모델이 다듬어 줍니다.

언어 쌍마다 한 번만 다운로드

  • 영어 → 튀르키예어 15MB
  • 영어 → 독일어 26MB
  • 프랑스어 → 영어 26MB
  • 일본어 → 영어 49MB

프랑스어 → 영어 → 독일어

52MB

두 언어를 바로 잇는 모델이 없나요? dragoman이 영어를 거쳐 번역하며 양쪽 모델을 모두 다운로드합니다.

다운로드 크기는 Mozilla 모델 레지스트리에 표시된 값입니다.
언어
영어와 50개 이상의 언어 사이를 양방향으로 번역합니다. 영어가 아닌 두 언어 사이에서는 영어를 거쳐 번역합니다. 언어 목록에서 AI 전용 표시가 있는 언어는 AI 모델이 필요합니다.
처음 사용할 때
Chrome과 Edge는 언어 팩이 처음 필요할 때 내려받고, Safari는 기기에서 Apple 번역용으로 내려받은 언어를 사용합니다. Bergamot의 언어 쌍은 Mozilla에서 한 번만 내려받으며(보통 15~50MB) 브라우저에 저장됩니다. 그 후로는 모두 오프라인에서 작동합니다.
초벌 번역과 다듬기
초벌 번역은 빠르고 다소 직역에 가까워 요점을 파악하기에 좋습니다. 모델은 페이지 전체를 보면서 이를 다시 써서, 문장이 자연스럽고 이름과 용어도 일관되게 유지됩니다.
선택은 사용자에게
모델을 설정한 상태에서도 페이지를 기기 안에서만 처리하려면 팝업에서 이 기기에서만을(를) 켜세요. 초벌 번역 없이 모델의 결과를 기다리려면 설정에서 먼저 이 기기에서 초벌 번역을(를) 끄세요.

Bergamot은 유럽연합이 지원한 연구 프로젝트에서 탄생했으며, Mozilla가 이 엔진에서 쓰는 언어 모델을 학습시켜 공개합니다. Bergamot 소개

AI 모델 추가

팝업에서 설정을 열고 제공업체를 고른 뒤 세 단계를 따라 하세요. 키를 붙여 넣으면 dragoman이 바로 확인하고 빠르고 저렴한 모델을 미리 선택해 둡니다. 모델은 언제든 바꿀 수 있습니다.

사용할 수 있는 제공업체

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • OpenAI 호환 서버 모두

OpenRouter는 키를 대신 만들어 줍니다. OpenRouter로 연결을 선택하고 요청을 승인하세요.

워크스페이스에 연결되지 않은 Anthropic 키는 워크스페이스 ID도 필요합니다. Anthropic Console의 설정 > 워크스페이스에서 찾을 수 있습니다.

로컬 모델 사용

Ollama를 설치하고 gemma3 같은 모델을 받은 뒤, 확장 프로그램의 요청을 받을 수 있도록 OLLAMA_ORIGINS를 설정해 실행하세요:

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*,safari-web-extension://*" ollama serve

LM Studio에서 모델을 불러오고 서버 설정에서 CORS를 켠 다음 로컬 서버를 시작하세요. dragoman이 localhost:1234에서 찾아냅니다.

비용

dragoman은 무료입니다. 다듬기는 사용자의 키로 실행되므로 요금은 제공업체가 직접 청구합니다. 번역에는 대개 작고 빠른 모델로 충분합니다. 설정의 사용량 탭에서 매월 모델별 토큰 수를 확인할 수 있고, '페이지별 비용 표시'를 켜면 배지 옆에 현재 페이지의 비용이 표시됩니다.

문단 14개 중 4개 다듬음

  • 다듬음
  • 초벌 번역
  • 대기 중

스크롤하면 곧 나올 문단은 빠르게 초벌 번역되고, 화면에 보이는 문단은 다듬어집니다. 나머지 부분은 그곳에 닿기 전까지 비용이 들지 않습니다.

개인정보 보호

컴퓨터 밖으로 나가는 것: 화면에 보이는 문단과 바로 다음 문단, 그리고 동반자에게 번역을 요청한 텍스트는 선택한 제공업체로 전송됩니다. 브라우저가 자체적으로 번역할 수 없는 언어라면 Mozilla에서 모델을 한 번 내려받습니다. 키는 해당 제공업체에만 전송됩니다. dragoman에는 서버도, 계정도, 분석 도구도 없습니다.

개인정보처리방침 전문 보기

문제 해결

팝업에 페이지를 번역할 수 없다고 표시됩니다

설정, 확장 프로그램 페이지, 웹 스토어 같은 브라우저 페이지는 확장 프로그램이 변경할 수 없습니다. 일반 웹사이트를 열어 보세요.

기기 내 엔진에 이 언어 쌍의 모델이 없습니다

기기 내 번역기는 널리 쓰이는 언어를 대부분 지원합니다. Safari에서는 기기의 언어 및 지역 설정에 있는 번역 언어에서 언어를 더 추가할 수 있습니다. 그 밖의 언어는 AI 모델을 추가하면 dragoman이 모델로 바로 번역합니다.

브라우저도 페이지 번역을 제안해요

dragoman은 브라우저가 번역할 만한 페이지에서 끼어들지 않도록 요청합니다. 이 기능을 껐다면 설정의 언어에서 '브라우저 번역기가 끼어들지 않게 하기'를 켜세요. 브라우저가 이미 페이지를 번역했다면 'dragoman으로 번역하기'를 선택해 원문으로 다시 불러오세요.

로컬 모델이 연결되지 않습니다

서버가 실행 중인지, 설정에 입력한 주소가 맞는지 확인하세요. Ollama는 OLLAMA_ORIGINS가, LM Studio는 CORS 활성화가 필요합니다.

dragoman이 페이지를 읽지 못해요

Safari와 Firefox에서는 확장 프로그램이 읽을 수 있는 웹사이트를 직접 고를 수 있습니다. dragoman을 열고 모든 웹사이트에서 허용을 선택하세요.

Firefox에서 내 모델로 다듬어지지 않아요

Firefox는 확장 프로그램이 페이지 텍스트를 외부로 보내기 전에 확인을 요청합니다. 설정을 열고 모델 아래에서 페이지 텍스트 전송 허용을 선택하세요.

소스에서 빌드하기

dragoman은 MIT 라이선스의 오픈 소스입니다. 빌드하려면 Node 24와 pnpm이 필요합니다.

git clone https://github.com/firatciftci/dragoman.git
cd dragoman
pnpm install
pnpm dev:extension

브라우저마다 빌드가 따로 있습니다. extension/에서 다음을 실행하세요:

Chromium 기반 브라우저 pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 그런 다음 Xcode에서 safari/dragoman.xcodeproj를 빌드하세요.

저장소는 pnpm 워크스페이스로 구성되어 있습니다:

extension/
WXT와 Svelte로 만든 확장 프로그램
site/
SvelteKit으로 만든 이 웹사이트
brand/
드래고먼들, 로고, 그리고 도시
messages/
85개 언어로 된 인터페이스 텍스트