opennamu (r1)

opennamu의 개발은 기존 위키엔진인 나무위키의 소스 코드 공개 문제와 라이선스 논란에서 비롯되었다. 2015년 서비스를 시작한 나무위키는 폐쇄적인 운영 방식을 유지하며 소스 코드를 공개하지 않았고, 이는 자유 소프트웨어 운동의 원칙에 반하는 것으로 여겨졌다. 특히 나무위키가 사용한 MIT 허가서는 소프트웨어의 사용, 복제, 수정, 배포에 대한 제한이 거의 없는 자유로운 라이선스임에도 불구하고, 실제 개발 과정은 공개적이지 않았다. 이러한 모순은 오픈 소스 커뮤니티 내에서 비판의 대상이 되었다.

이러한 배경에서, 나무위키와 유사한 기능을 제공하되 진정한 오픈 소스 정신에 입각한 대체 엔진을 만들려는 움직임이 나타났다. opennamu 프로젝트는 나무위키의 인터페이스와 사용성을 계승하면서도, 소스 코드를 완전히 공개하고 GNU 일반 공중 사용 허가서(GPL) 같은 강력한 자유 소프트웨어 라이선스 하에 개발을 진행하기 위해 시작되었다. 핵심 목표는 사용자에게 엔진의 내부를 완전히 투명하게 공개하고, 누구나 자유롭게 수정 및 재배포할 수 있는 진정한 오픈 소스 위키 플랫폼을 제공하는 것이었다.

개발 초기에는 나무위키의 클로즈드 소스 정책에 반발한 개발자들과 사용자들이 주도적으로 참여했다. 그들은 단순한 포크(fork)를 넘어, 라이선스 문제를 근본적으로 해결하고 커뮤니티 주도의 개발 모델을 정착시키고자 했다. 이 과정에서 코드의 재작성과 구조 개선이 동반되며, 나무위키와는 별개의 독자적인 프로젝트로 성장하게 되었다.

opennamu의 개발은 2020년대 초반에 시작되었으며, 주요 버전 업데이트를 통해 기능과 안정성을 지속적으로 개선해왔다. 초기 버전은 나무위키의 데이터를 기반으로 한 미러 서비스와 기본적인 위키 엔진 기능에 중점을 두었다.

아래는 주요 버전의 역사를 정리한 연표이다.

각 주요 버전은 이전 버전의 한계를 해결하고 사용자 및 관리자의 요구를 반영하는 방향으로 발전했다. 특히 2.0 버전은 확장성과 유지보수성을 크게 향상시킨 중요한 전환점으로 평가받는다. 프로젝트는 깃허브 등의 플랫폼에서 공개적으로 개발되며, 버전 릴리즈 노트를 통해 상세한 변경 내역을 공개한다.

opennamu는 클라이언트-서버 모델을 기반으로 하는 웹 애플리케이션이다. 백엔드는 Python 프로그래밍 언어와 Flask 웹 프레임워크로 구축되었으며, 데이터는 SQLite 또는 MariaDB와 같은 관계형 데이터베이스에 저장된다. 프론트엔드는 HTML, CSS, 자바스크립트를 사용하여 렌더링되며, 편집 인터페이스는 마크다운 문법을 주로 지원한다.

시스템은 크게 라우팅 및 요청 처리 계층, 비즈니스 로직 계층, 데이터 접근 계층으로 구성된다. 사용자의 요청은 Flask 라우터를 통해 적절한 핸들러 함수로 전달되고, 이 함수는 문서 조회, 편집, 역사 관리, 사용자 인증 등의 로직을 수행한다. 모든 데이터 변경은 ACID 트랜잭션을 보장하는 데이터베이스 계층을 통해 이루어진다. 파일 업로드 및 첨부 기능의 경우, 메타데이터는 데이터베이스에 저장되고 실제 파일은 서버의 파일 시스템에 보관되는 구조를 가진다.

아키텍처의 주요 특징은 모듈화와 확장성에 있다. 핵심 기능은 독립적인 모듈로 분리되어 있으며, 플러그인 시스템을 통해 새로운 기능을 추가하거나 기존 동작을 변경할 수 있다. 이는 관심사의 분리 원칙을 따르며, 테마 변경, 편집 필터 추가, 특수 문서 처리기 등 다양한 확장을 가능하게 한다. 또한, RESTful API를 일부 제공하여 자동화된 도구나 다른 시스템과의 연동에 활용될 수 있다.

opennamu는 위키 엔진으로서 다양한 편집 및 관리 기능을 제공한다. 사용자들은 직관적인 인터페이스를 통해 문서를 생성, 수정, 삭제할 수 있으며, 모든 편집 이력은 자동으로 기록되어 역사 관리와 되돌리기 기능을 가능하게 한다. 또한 토론 기능을 통해 문서 내용에 대한 논의를 별도의 공간에서 진행할 수 있다.

문서 관리 측면에서는 분류 시스템을 지원하여 문서를 체계적으로 정리할 수 있다. 파일 업로드 기능을 통해 이미지나 문서 파일을 위키에 첨부할 수 있으며, 특수 문서를 이용해 특정 조건을 만족하는 문서 목록을 생성하거나 사이트 통계를 확인할 수 있다. 접근 제어는 권한 관리 시스템을 통해 이루어지며, 관리자는 사용자별로 문서 편집, 파일 업로드, 관리 기능 사용 등의 권한을 세부적으로 설정할 수 있다.

편집 기능은 마크다운 문법과 위키텍스트를 모두 지원하는 것이 특징이다. 표를 생성하거나 하이퍼링크를 삽입하는 것이 비교적 간단하며, 수학 공식을 표현하기 위한 LaTeX 문법도 사용할 수 있다. 또한 차단 기능을 통해 문제가 있는 사용자나 IP 주소의 편집을 제한할 수 있다.

opennamu는 PHP와 MySQL 기반의 위키 엔진으로, 비교적 가벼운 시스템 요구사항을 가진다. 서버 측면에서는 PHP 7.4 이상의 버전과 MySQL 5.7 이상 또는 MariaDB 10.2 이상의 데이터베이스 관리 시스템이 필요하다. 또한 Apache나 Nginx와 같은 웹 서버 소프트웨어가 설치되어 있어야 하며, mod_rewrite와 같은 URL 재작성 모듈이 활성화되어 있으면 미디어위키 스타일의 짧은 주소(Short URL) 사용이 가능해진다.

클라이언트 측면에서는 특별한 요구사항이 없다. 최신 버전의 주요 웹 브라우저(Chrome, Firefox, Edge, Safari 등)에서 정상적으로 작동한다. 문서 편집을 위한 WYSIWYG 에디터는 자바스크립트 기반으로 동작하므로, 브라우저에서 자바스크립트 실행이 활성화되어 있어야 모든 편집 기능을 사용할 수 있다.

권장되는 서버 환경은 다음과 같다.

특히 PHP 설정에서 upload_max_filesize와 post_max_size 값은 사용자가 파일을 업로드할 때 제한 크기를 결정하므로, 운영 목적에 맞게 적절히 조정하는 것이 좋다. 또한 대규모 커뮤니티를 운영할 경우 데이터베이스 연결 수와 메모리 제한(max_execution_time, memory_limit)을 높이는 것이 성능에 유리하다.

opennamu는 Docker를 사용한 설치를 권장하며, 수동 설치도 가능합니다. Docker 설치 방식은 의존성 문제를 최소화하고 배포를 단순화합니다.

Docker를 이용한 설치 시, 먼저 Git 저장소를 클론한 후 docker-compose.yml 파일이 있는 디렉토리에서 docker-compose up -d 명령어를 실행합니다. 이 명령은 데이터베이스 서버와 웹 애플리케이션 컨테이너를 함께 시작합니다. 초기 설정은 환경 변수 파일(.env)을 수정하여 데이터베이스 접속 정보나 사이트 이름 등을 구성할 수 있습니다. 설치가 완료되면 웹 브라우저를 통해 서버의 IP 주소나 도메인에 접속하여 위키를 사용할 수 있습니다.

수동 설치의 경우, Python과 Flask 프레임워크 환경을 직접 구성해야 합니다. 필요한 단계는 다음과 같습니다.

두 방식 모두 설치 후 관리자 계정을 생성하고, 네임스페이스 설정이나 문서 백업 주기 등의 추가 구성을 진행하는 것이 일반적입니다. 공식 문서나 커뮤니티는 Docker 방식을 통한 설치를 가장 보편적인 방법으로 안내합니다.

opennamu는 위키 문법을 사용하여 문서를 편집합니다. 기본적인 문법은 다른 위키 엔진과 유사하지만, 몇 가지 고유한 특징을 가지고 있습니다. 편집은 웹 브라우저를 통해 실시간으로 이루어지며, 저장 전에 미리보기 기능을 활용하여 변경 사항을 확인할 수 있습니다.

주요 편집 기능으로는 다음과 같은 것들이 있습니다.

편집 충돌을 방지하기 위해 편집 충돌 방지 시스템이 동작합니다. 동시에 여러 사용자가 같은 문서를 편집하려 할 경우 경고가 표시됩니다. 또한, 특정 문서나 포함된 틀(템플릿)이 자주 변경될 경우, 이를 참조하는 다른 문서들도 함께 재생성되는 캐시 시스템을 가지고 있습니다[2]. 관리자는 문서 보호 기능을 통해 특정 문서나 이름공간의 편집을 제한할 수 있습니다.

관리자는 특수 기능을 통해 사이트 전반을 관리할 수 있다. 주요 관리 기능은 다음과 같다.

이러한 기능들은 대부분 웹 기반의 관리자 패널을 통해 접근하고 실행할 수 있다. 관리 작업은 행동 로그에 기록되어 투명하게 관리되며, 일부 주요 작업(예: 문서 삭제)은 여러 관리자의 토론을 거치도록 권장된다[3].

opennamu 소프트웨어를 기반으로 운영되는 주요 위키 사이트들은 주로 특정 주제에 집중된 소규모 커뮤니티나 폐쇄적인 프로젝트에서 찾아볼 수 있다. 대부분의 사례는 한국어를 사용하는 커뮤니티에 집중되어 있으며, 공개적인 대형 위키보다는 특정 집단 내부의 지식 공유나 문서화 목적으로 활용되는 경향이 있다.

한국 내에서는 특정 게임, 문화 서클, 혹은 학술 동아리 등에서 자체적인 위키를 구축하기 위한 솔루션으로 선택되는 경우가 있다. 예를 들어, 특정 인디 게임의 팬 커뮤니티나 대학 내 동아리에서 회원 간 정보 공유를 위해 설치하여 운영한다. 또한, 기존 대형 위키 플랫폼의 정책에 제약을 받지 않고 자유로운 편집이 필요한 니즈를 가진 소규모 그룹들이 선택하기도 한다.

주요 운영 사례의 구체적인 목록은 다음과 같다.

전반적으로 오픈나무는 미디어위키나 마크다운 기반 위키 엔진에 비해 대중적인 인지도나 광범위한 채택률은 높지 않다. 그러나 오픈 소스이며 한국어 환경에 최적화된 간편한 설치 절차 덕분에, 기술적 배경이 깊지 않은 사용자들도 쉽게 자체 위키를 시작할 수 있는 진입점을 제공한다는 점에서 의미를 가진다.

opennamu는 플러그인 시스템을 통해 기능을 확장할 수 있다. 사용자는 필요한 기능을 선택적으로 설치하거나, 직접 플러그인을 개발하여 커뮤니티에 기여할 수 있다. 이는 위키의 기능을 기본적인 문서 편집 및 관리에서 벗어나 다양한 용도로 맞춤화할 수 있게 해준다.

주요 확장 기능은 다음과 같은 카테고리로 나눌 수 있다.

플러그인은 주로 Python으로 작성되며, opennamu의 코어 코드를 수정하지 않고도 후크(hook)나 API를 통해 기능을 주입하는 방식을 사용한다. 공식적으로 제공되거나 커뮤니티에서 개발된 플러그인은 GitHub 등의 저장소를 통해 공유된다. 사용자는 설정 파일에 플러그인 이름을 추가하는 간단한 과정으로 기능을 활성화할 수 있다.

이러한 모듈식 구조는 opennamu가 가벼운 기본 상태를 유지하면서도, 운영자의 필요에 따라 강력한 기능을 갖춘 위키로 성장할 수 있는 유연성을 제공한다. 또한, 특정 커뮤니티의 독특한 요구사항을 해결하는 맞춤형 확장 기능의 개발을 촉진한다.