마크다운 시대 협업문서도구 Outline 위키 소개

사내 문서가 Slack 스레드·Notion·개인 로컬·Obsidian 볼트로 흩어진 국내 기업이라면, 올해 운영 환경 통합을 검토하면서 자체 호스팅 협업 위키를 후보로 올리는 경우가 많습니다. 이때 기능 목록보다 먼저 따져야 할 것은 라이선스·아키텍처·한국어 검색·인증 연계라는 네 가지 도입 변수이며, 이 글에서는 그 판단 근거를 1차 출처 기반으로 정리합니다.

2026년 06월 22일

왜 지금 셀프호스팅 위키인가?

문서 자산이 여러 도구에 흩어지면 검색과 변경 이력이 끊기고, 외부 SaaS에 의존하면 공급 주체가 바뀔 때 재이행 비용이 발생합니다. 이 도구는 자체 인프라에 설치하는 오픈소스 협업 위키로, 이 두 문제를 동시에 겨냥합니다. 라이선스는 Business Source License 1.1이며, 사내 자체 호스팅은 무료로 허용되고 외부 고객에게 동일 서비스를 재판매하는 경우만 차단됩니다. 2030년 6월 6일에는 더 개방적인 Apache License 2.0으로 자동 전환되는 조항이 명시되어 있어, 도입 조직은 라이선스 리스크의 상한을 먼저 점검해야 합니다. 회사는 외부 자본에 의존하지 않는 흑자 구조를 공식 페이지에서 밝히고 있어, 공급 주체의 급변 위험도 상대적으로 낮은 편입니다.

벤더 종속 리스크 줄이는 셀프호스팅 위키 Outline 도입 기준 - 백서 다운로드

CNF 백서 구독하기🔔

새로운 백서가 발간되면 가장 먼저 안내드려요!

CNF가 전하는 최신 백서와 클라우드 인사이트를 가장 빠르게 만나보실 수 있습니다.

진심으로 구독 부탁드립니다 🙏

어떻게 도입을 검증하는가?

한국어 검색 한계는 코드 수준 우회로 닫을 수 있습니다. 인덱싱과 쿼리 양쪽의 정규식 설정을 simple로 바꾸거나 형태소 분석기를 붙이는 방식이 대표적입니다. 인덱싱 트리거와 쿼리 프로바이더 두 지점을 같은 값으로 함께 적용해야 검색이 멈추지 않으므로, 기존 검색 인덱스 재생성까지 한 묶음으로 준비해야 합니다.

# docker-compose: 의존 컴포넌트는 PostgreSQL + Redis 둘뿐
services:
  outline:
    image: outlinewiki/outline:latest   # 도입 시 최신 stable 태그로 고정
    environment:
      OIDC_AUTH_URI:  https://<keycloak>/realms/<realm>/protocol/openid-connect/auth
      OIDC_TOKEN_URI: https://<keycloak>/realms/<realm>/protocol/openid-connect/token
      OIDC_USERNAME_CLAIM: preferred_username

인증은 빌트인 이메일 로그인이 없어 외부 OIDC 연계가 전제입니다. Keycloak Realm의 네 endpoint를 환경변수에 매핑하면 무료 빌드에서도 SSO가 동작하므로, 사내 IdP 보유 여부를 먼저 점검해야 합니다.

도입 전후로 무엇이 달라지는가?

항목	도입 전	도입 후
문서 위치	여러 도구에 분산	단일 자체 호스팅 저장소
운영 컴포넌트	도구별로 상이	PostgreSQL · Redis 2개
한국어 검색	제약	우회 설정 후 회복
AI 연계	수작업	내장 MCP 서버로 검색·편집

2026년 2월 18일 추가된 내장 MCP 서버는 사내 LLM 에이전트가 문서를 직접 검색·읽기·생성·편집하도록 열어 줍니다(백서 4장). 운영 컴포넌트가 두 개로 한정되는 점은 백업·복구 설계를 단순하게 만들므로, 운영팀은 이 구조를 사내 표준 배포 방식과 대조해 점검해야 합니다.

무엇을 어떤 순서로 결정할 것인가?

도입 판단은 일정이 아니라 여섯 변수로 좁혀집니다. 라이선스와 아키텍처, 차별화, AI 에코시스템은 그대로 도입 가능 영역이고, 한국어 검색과 그룹 동기화는 사전 보완이 필요한 영역입니다. 단일 차단 요인은 없으므로, 조직은 한국어 검색 우회와 SSO 연계 두 과제를 먼저 결정해야 합니다. 이어 표본 자산을 정규화 스크립트로 변환해 PoC 환경에 임포트하고, 손실을 검증한 뒤 운영 전환을 결정하는 순서로 착수해야 합니다.

결론 — 기술 우위 요약과 도입 경로

이 위키는 자체 호스팅과 실시간 협업, Markdown 호환을 동시에 만족하는 드문 오픈소스 도구이며, 라이선스 자동 전환 조항이 장기 도입 안전성을 뒷받침합니다. 약점인 한국어 검색과 그룹 동기화는 우회 경로가 분명하므로, 도입팀은 표본 검증과 인증 연계를 우선 과제로 준비해야 합니다.

도입 전 자주 묻는 질문 정리

이 위키는 오픈소스인가요? Business Source License 1.1이며 사내 자체 호스팅은 무료로 허용됩니다. 2030년 Apache License 2.0 자동 전환 조항도 본문에 명시되어 있습니다.
Markdown으로 데이터가 저장되나요? 1차 저장은 ProseMirror JSON이고 Markdown은 손실을 동반한 export입니다. 진본은 JSON이므로 이행 시 이 점을 기준으로 검증해야 합니다.
한국어 검색이 정말 안 되나요? 기본 설정이 영어 기준이라 한계가 있지만, 정규식 설정 교체나 형태소 분석기로 회복할 수 있습니다.