Wiki.js는 Node.js 프레임워크 기반으로 설계된 풍부한 기능을 갖춘 오픈 소스 위키 애플리케이션입니다.마크다운과 위지윅 인터페이스를 모두 지원하여 다재다능한 편집 환경을 제공합니다.또한 실시간 협업, 버전 관리, 그리고 Google 및 LDAP 통합을 포함한 다양한 인증 방법을 지원합니다.이 종합 가이드는 Docker를 사용하여 Wiki.js를 설정하는 데 필요한 단계를 안내하여 단 몇 분 만에 자신만의 위키를 배포할 수 있도록 지원합니다.
Docker Compose를 통해 Wiki.js 설정
Docker와 Docker Compose를 사용하여 Wiki.js를 설치하는 과정은 간단합니다.먼저, “”라는 이름의 새 디렉터리를 만들고 wikijs-docker해당 디렉터리로 이동합니다.
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 인스턴스의 전체 구성을 정의하는 데 중요한 역할을 합니다.
일반 탭 에서는 사이트 제목, 설명, 기본 홈페이지, 가시성 설정(공개 또는 비공개)을 포함한 기본 사이트 설정을 조정할 수 있습니다.
사이트의 기본 언어, 시간대, 날짜/시간 형식을 지정하려면 로케일 탭 으로 전환하세요.
위키의 메뉴 구조를 관리하고 사용자 탐색을 향상시키려면 탐색 모음 섹션을 방문하세요.
페이지 탭 에서는 모든 위키 페이지를 감독, 편집, 구성하고, 새 페이지를 만들고, 콘텐츠 계층을 관리할 수 있습니다.
또한, 태그 탭에서는 콘텐츠 태그를 생성하고 관리하여 페이지 검색 가능성을 높일 수 있습니다.테마 탭에서는 사이트 로고, 색상, 글꼴, 레이아웃 스타일을 변경하여 위키의 미적 요소를 맞춤 설정할 수도 있습니다.
위키에서 그룹 관리하기
그룹 섹션 에서는 사용자 그룹을 생성하고, 구성원을 지정하고, 그룹 수준 권한을 설정하여 접근 권한을 관리할 수 있습니다.이러한 구성 방식은 사용자 역할을 간소화하고 위키 전체에서 일관된 접근 관리를 유지하는 데 도움이 됩니다.
특정 그룹을 클릭하면 해당 그룹의 설정, 권한, 페이지 규칙 및 사용자 관리를 업데이트할 수 있습니다.설정 탭을 통해 로그인 리디렉션 URL을 포함한 다양한 옵션을 조정할 수 있습니다.
또한 권한, 페이지 규칙 및 사용자 섹션을 탐색하여 그룹이 액세스할 수 있는 항목을 세부적으로 지정하고 그에 따라 사용자를 할당할 수 있습니다.
Wiki.js에서의 사용자 관리
새로운 사용자를 추가하려면 사용자 섹션으로 가서 새 사용자 버튼을 클릭 하고 필수 필드를 입력하세요.
완료되면 만들기 또는 만들기 및 닫기를 선택하여 새 사용자 설정을 마무리합니다.
특정 사용자를 선택하면 해당 프로필을 보고 편집하고, 사용자 그룹을 지정하고, 인증 방법(예: 비밀번호 또는 2단계 인증)을 정의하고, 비활성화, 확인 또는 삭제 와 같은 작업으로 상태를 관리할 수 있습니다.
또한, 기본 정보, 확장된 메타데이터(위치 및 직책 포함)를 업데이트하고 활동 내역을 볼 수 있습니다.
위키 모듈 관리
모듈은 Wiki.js의 기능을 확장하는 향상된 기능입니다.예를 들어, Analytics 모듈을 사용하면 Google Analytics와 같은 도구를 통합하여 사용자 참여도 및 트래픽 지표를 추적할 수 있습니다.
인증 탭을 활용하여 다양한 로그인 옵션을 구성하는 것과 함께 인증 공급자(로컬 로그인, LDAP, OAuth)를 설정하고 관리합니다.
또한, 댓글 시스템을 켜거나 끌 수 있으며 사용자가 페이지 토론에 참여하는 방식을 결정할 수 있습니다.
시스템 구성
렌더링 엔진, 검색 인덱싱 및 저장소 설정을 구성하여 콘텐츠 렌더링, 검색 인덱싱 및 저장 방식을 관리합니다.예를 들어, 렌더링 탭에 액세스하여 마크다운 엔진 설정을 조정하거나 다이어그램 및 수학 표현식 지원을 활성화하는 등 콘텐츠 렌더링을 맞춤 설정할 수 있습니다.
검색 엔진 섹션 에서는 내부 검색 인덱싱 옵션과 타사 검색 엔진 통합을 관리할 수 있습니다.
저장소 섹션 에서 콘텐츠의 백업 및 동기화 대상을 지정하여 미디어 및 페이지 첨부 파일이 저장되는 위치와 방식(예: 로컬 파일 시스템 또는 AWS S3)을 관리할 수 있습니다.
보안 및 연결 관리
API 액세스 구성, 이메일 알림 설정, 보안 정책 조정, SSL 활성화를 통해 Wiki.js 인스턴스를 안전하게 보호할 수 있습니다.예를 들어, API 토큰을 처리하여 Wiki.js를 다른 애플리케이션과 통합할 수 있습니다.
Wiki.js 내에서 알림, 초대, 비밀번호 복구 프로세스를 관리하기 위한 이메일 구성을 설정합니다.
세션 시간 초과, 암호 정책, 액세스 제한과 같은 측면을 포함하여 보안 설정을 세부적으로 조정할 수도 있습니다.
또한 SSL/TLS 인증서를 설정하여 Wiki.js 인스턴스가 HTTPS를 통해 안전하게 작동하도록 할 수 있습니다.
또한 시스템 진단, 서버 사양, 런타임 환경 통계 등의 Wiki 정보를 시스템 정보 섹션에서 확인하세요.
검색 결과 재인덱싱, 캐시된 데이터 지우기, 유틸리티 탭에서 구성 재설정과 같은 유지 관리 활동을 수행합니다.
마지막으로 개발자 도구는 GraphQL 플레이그라운드, 로그 디버깅 기능 또는 사용자 정의 스크립트 통합과 같은 고급 리소스를 제공합니다.
이제 Docker를 사용하여 Wiki.js를 설정하는 방법을 알았으므로 이 플랫폼을 사용하여 내부 문서, 협업 팀 위키 또는 공개 지식 기반을 손쉽게 만들 수 있습니다.
답글 남기기