Wiki.js를 설정하고 몇 분 만에 나만의 위키를 만드는 방법
Wiki.js는 Node.js로 구축된 강력한 오픈 소스 위키 플랫폼입니다. Markdown과 WYSIWYG 편집, 실시간 협업, 버전 관리 및 Google과 LDAP을 포함한 유연한 인증 옵션을 지원합니다. 이 가이드에서는 Docker를 사용하여 Wiki.js를 설정하는 방법을 보여 드리겠습니다. 몇 분 만에 위키를 가동할 수 있습니다.
Docker Compose를 사용하여 Wiki.js 설치하기
Docker와 Docker Compose를 사용하면 wiki.js를 설정하는 것이 매우 쉽습니다. 먼저 “wikijs-docker”라는 디렉토리를 만들고 cd 명령어를 사용하여 접근합니다:
mkdir wikijs-docker && cd wikijs-docker이후, 원하는 텍스트 편집기에서 “docker-compose.yml” 파일을 생성합니다:
nano docker-compose.yml그다음, 다음 내용을 이 파일에 붙여넣습니다:
services:
db:
image: postgres:16
environment:
POSTGRES_DB: wiki
POSTGRES_PASSWORD: wikijsrocks
POSTGRES_USER: wikijs
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
wiki:
image: ghcr.io/requarks/wiki:2
depends_on:
- db
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: wikijsrocks
DB_NAME: wiki
restart: unless-stopped
ports:
- "80:3000"
volumes:
db-data:파일을 저장하고 닫은 후, 다음 명령어를 사용하여 컨테이너를 시작합니다:
docker compose up -d
설정이 완료되면, 웹 브라우저에서 http://localhost에 Wiki.js를 엽니다. 관리자 계정 세부 정보를 입력하고 설치 버튼을 클릭하여 설치를 시작합니다:
설치 후, 자격 증명을 입력하여 로그인합니다.
Wiki.js에서 페이지 만들기 및 관리하기
이제 홈 페이지를 만들고 콘텐츠를 추가하거나, 설정, 사용자 및 기능을 관리하기 위해 관리 패널에 접근할 수 있습니다:
홈 페이지 만들기 버튼을 클릭하면, 페이지의 편집기를 선택하라는 요청이 표시됩니다. 선호도 및 요구 사항에 따라 하나를 선택합니다:
페이지 속성을 지정하고 확인 버튼을 클릭하여 새 페이지를 생성합니다:
원하는 내용을 쓰고 생성 버튼을 클릭하여 페이지를 만듭니다:
콘텐츠 관리 및 조직하기
대시보드에서 기존 페이지를 보고 수정하거나, 원하는 편집기를 사용하여 새 페이지를 만들고, 페이지를 이동하거나 이름을 바꾸거나 삭제하여 콘텐츠를 조직할 수 있습니다. 또한 콘텐츠를 효과적으로 분류하기 위해 태그를 추가할 수 있습니다. 사이드바와 검색 바를 사용하면 위키 내의 특정 페이지로 빠르게 이동할 수 있습니다:
Wiki.js 사이트 설정
Wiki.js 관리 패널에서 언어, 탐색, 테마 및 태그와 같은 사이트 설정을 구성할 수 있습니다. 이러한 옵션은 Wiki.js 인스턴스의 전반적인 구성을 정의하는 데 도움이 됩니다.
일반 탭에서 사이트 제목, 설명, 기본 홈페이지 및 사이트 가시성(공개 또는 비공개)과 같은 기본 사이트 전반의 설정을 구성할 수 있습니다:
로케일 탭으로 이동하여 사이트 전반에서 사용할 기본 언어, 시간대 및 날짜/시간 포맷을 설정합니다:
위키 메뉴의 구조를 관리하고 사용자가 콘텐츠를 탐색하는 방식을 제어하려면 탐색 바로 이동합니다.
페이지 탭에서는 모든 위키 페이지를 보고, 관리하고, 조직할 수 있습니다. 새 페이지를 만들거나 기존 페이지를 수정하거나 페이지 계층 구조를 관리합니다.
또한 태그 탭에서 콘텐츠를 분류하고 검색 기능을 향상시키기 위해 콘텐츠 태그를 생성하고 관리할 수 있습니다. 비슷하게, 테마 탭에서 위키의 모양과 느낌을 수정할 수 있습니다. 예를 들어 사이트 로고, 색상, 글꼴 및 레이아웃 테마를 수정할 수 있습니다.
위키의 그룹 관리
그룹 섹션에서는 사용자 그룹을 만들고, 구성원을 배정하고, 접근을 제어하기 위해 그룹 수준의 권한을 설정할 수 있습니다. 그룹을 사용하여 역할에 따라 사용자를 조직하고 위키 전반에 걸쳐 일관되게 접근을 관리합니다.
특정 그룹을 클릭하여 설정, 권한, 페이지 규칙 및 해당 그룹 내의 사용자들을 관리할 수 있습니다. 설정 탭에서 로그인 시 리디렉션할 URL과 같은 옵션을 구성할 수 있습니다.
또한 권한, 페이지 규칙 및 사용자 탭을 통해 그룹이 접근할 수 있는 내용을 제어하고 해당 그룹에 지정된 사용자를 관리할 수 있습니다.
Wiki.js에서 사용자 관리
새 사용자를 만들려면 사용자 섹션으로 이동하여 새 사용자 버튼을 클릭하고 필요한 세부 정보를 지정합니다.
그 후 생성 또는 생성과 닫기 버튼을 클릭하여 새 사용자를 생성합니다:
특정 사용자를 클릭하여 프로필을 보고 수정하고, 사용자 그룹에 배정하고, 비밀번호 및 2단계 인증과 같은 인증 방법을 설정하며, 비활성화, 확인 또는 삭제와 같은 작업으로 상태를 관리할 수 있습니다:
기본 정보, 확장 메타데이터(위치 및 직함 등)를 업데이트하고 활동 기록을 모니터링할 수 있습니다:
위키 모듈 관리하기
모듈은 Wiki.js 기능을 향상시키는 선택적 기능입니다. 예를 들어 분석 모듈은 Google Analytics와 같은 통합을 활성화하고 구성하여 사용자의 행동 및 위키의 트래픽을 추적할 수 있게 합니다.
인증 탭을 사용하여 인증 공급자(로컬 로그인, LDAP, OAuth 등)를 설정하고 관리하며 로그인 옵션을 구성합니다.
댓글 시스템을 활성화하거나 비활성화하고, 사용자가 페이지 토론에 참여하는 방법을 선택할 수 있습니다.
시스템 구성
내용이 렌더링되고 검색되고 저장되는 방식을 관리할 수 있습니다. 렌더링 엔진, 검색 인덱싱 및 저장 옵션을 구성하여 이를 설정할 수 있습니다. 예를 들어, 렌더링 탭으로 이동하여 콘텐츠가 렌더링되는 방식을 사용자 정의할 수 있습니다. Markdown 엔진 설정이나 다이어그램, 수학 표현식 등의 지원을 포함합니다.
검색 엔진 섹션에서는 내부 검색 인덱싱 옵션과 검색 엔진과의 통합을 구성할 수 있습니다:
저장소 섹션으로 이동하여 콘텐츠의 백업 및 동기화 대상 설정을 할 수 있습니다. 여기서 미디어 및 페이지 첨부 파일이 저장되는 위치와 방식을 관리할 수 있습니다(로컬 파일 시스템, AWS S3 등):
보안 및 연결성 관리하기
API 접근을 구성하고, 알림을 위한 이메일을 설정하고, 보안 정책을 조정하고, SSL을 활성화하여 Wiki.js 사이트를 보호하는 등 보안 및 연결성을 관리할 수 있습니다. 예를 들어, 외부 시스템이나 맞춤형 애플리케이션과 통합하기 위해 API 토큰을 관리할 수 있습니다:
WiKi.js에서 알림, 초대 및 비밀번호 복구를 처리하기 위해 나가는 이메일 설정을 구성할 수 있습니다.
보안 설정을 구성하여 세션 타임아웃, 비밀번호 정책 및 접근 제한을 설정할 수 있습니다.
이외에도, Wiki.js 사이트를 HTTPS로 보호하기 위해 SSL/TLS 인증서를 설정할 수 있습니다.
또한 시스템 정보 섹션에서 시스템 진단 보기, 서버 세부 정보 및 런타임 환경 통계와 같은 Wiki 정보를 확인할 수 있습니다.
유틸리티 탭에서 검색 재색인, 캐시 지우기 또는 구성 복원과 같은 유지 관리 작업을 수행할 수 있습니다.
마지막으로, 개발자 도구를 통해 GraphQL 플레이그라운드, 디버깅 로그 또는 맞춤형 스크립트와 같은 고급 도구에 접근할 수 있습니다:
이제 Docker로 Wiki.js를 설정하는 방법을 배웠으니, 내부 문서, 팀 위키 또는 심지어 공개 지식 기반을 쉽게 구축하는 데 사용할 수 있습니다. 여전히 옵션을 고려 중이라면 DokuWiki와 Wiki.js 비교를 확인하여 프로젝트에 적합한 플랫폼이 무엇인지 확인해 보세요.
