- 목적: 사람과 여러 AI 에이전트가 함께 재사용할 수 있는 지식 기반 Wiki 구축
- 현재 상태: Synology 배포 완료, Wiki.js 기본 설정 및 홈 문서 생성 완료
- 주요 환경: Synology DS920+, Container Manager, Nginx Proxy Manager, PostgreSQL, Wiki.js
- 소유자: saint
- URL:
https://wiki.saintkite.com
- 주요 브랜치:
main
- 로컬 경로:
C:\Users\saint\2026_personal_project\wiki-js-knowledge-base
- NAS 배포 경로:
/volume1/docker/wiki-js-knowledge-base/app
Browser
-> Nginx Proxy Manager
-> Wiki.js
-> PostgreSQL
- 수동 배포와 rollback 절차는 Runbook: Deploy Wiki.js to Synology를 기준으로 한다.
- 현재 Synology 파일 배포 workflow는 manual only다. self-hosted runner가 Synology 파일시스템을 직접 볼 수 있을 때만 사용한다.
- Wiki.js 문서 게시 테스트와 단건/일괄 게시에는 GraphQL API workflow를 사용한다.
- 권장 게시 흐름:
Git commit
-> push to main
-> Publish Wiki.js Content Tree via API
-> live URL verification
| Path |
Purpose |
docker-compose.yml |
기본 Wiki.js + PostgreSQL Compose |
deploy/compose.synology.yml |
Synology bind mount override |
deploy/deploy-synology.sh |
NAS 배포 스크립트 |
.github/workflows/deploy-synology.yml |
GitHub Actions 배포 템플릿 |
docs/SYNOLOGY_DEPLOYMENT.md |
Synology 운영 가이드 |
wiki-content/ |
Wiki 초기 콘텐츠와 템플릿 |
- 현재 운영 경로는
https://wiki.saintkite.com이며, NPM을 거쳐 Wiki.js로 프록시한다.
- 기본 로캘은 한국어이며 문서 경로는
/ko/... 네임스페이스를 사용한다.
- Local File System storage는
/wiki/data/storage로 활성화되어 있다.
- 문서 원본은
wiki-content/로 두고, Wiki.js DB에는 API publish workflow로 반영한다.
- 상세 배포, 백업, 복구 절차는 Synology 배포 런북과 운영 가이드를 기준으로 한다.
- Wiki.js DB 백업 없이 Git 저장소만 백업하면 사용자, 권한, 설정은 복구되지 않는다.
- Date: 2026-06-24
- Verified by: Codex
- Evidence: GitHub Actions
publish-wikijs-api.yml created/updated /ko/knowledge/glossaries/battery-ai through Wiki.js GraphQL API; live URL returned 200 and rendered Korean body content.