프로젝트: Wiki.js Knowledge Base
원본 상대경로:docs/SYNOLOGY_DEPLOYMENT.md
형식:MD
분류:문서
추출 방식:text
동기화:2026-06-29 09:50:49
docs/SYNOLOGY_DEPLOYMENT.md이 문서는 Synology DS920+ + Container Manager + Nginx Proxy Manager 환경에 Wiki.js 지식 기반을 배포하는 절차입니다.
/volume1/docker/wiki-js-knowledge-base/
app/ # this Git repository
postgres/ # PostgreSQL data
wikijs/ # Wiki.js local data
NAS에 SSH로 접속한 뒤 실행합니다.
mkdir -p /volume1/docker/wiki-js-knowledge-base
cd /volume1/docker/wiki-js-knowledge-base
git clone <your-repo-url> app
cd app
cp .env.synology.example .env
vi .env
.env에서 최소한 POSTGRES_PASSWORD를 긴 랜덤 문자열로 바꿉니다.
mkdir -p /volume1/docker/wiki-js-knowledge-base/postgres
mkdir -p /volume1/docker/wiki-js-knowledge-base/wikijs
docker compose -f docker-compose.yml -f deploy/compose.synology.yml up -d
기본값이면 Wiki.js는 NAS의 8080 포트로 열립니다.
가장 단순한 방식은 NPM에서 NAS LAN IP로 프록시하는 것입니다.
| Field | Value |
|---|---|
| Scheme | http |
| Forward Hostname/IP | <NAS_LAN_IP> |
| Forward Port | 8080 |
| Websockets Support | On |
| Block Common Exploits | On |
| SSL | Let's Encrypt certificate |
NPM과 Wiki.js를 같은 Docker network로 붙이고 싶다면 deploy/compose.npm-network.example.yml을 사용합니다. 이 경우 NPM에서는 kb-wikijs:3000으로 프록시합니다.
cd /volume1/docker/wiki-js-knowledge-base/app
sh ./deploy/deploy-synology.sh
배포 스크립트는 git pull, wiki-content/를 Wiki.js Local File System storage로 동기화, DB 백업, 이미지 pull, docker compose up -d 순서로 실행됩니다.
기본 storage 경로는 /volume1/docker/wiki-js-knowledge-base/wikijs/storage이며 필요하면 .env의 WIKI_STORAGE_DIR로 조정합니다.
cd /volume1/docker/wiki-js-knowledge-base/app
sh ./scripts/backup.sh
백업은 app/backups/에 SQL 파일로 생성됩니다. 문서 Markdown 저장소 백업과 Wiki.js DB 백업은 별도입니다.
운영 DB에 바로 복구하기 전에 별도 테스트 인스턴스에서 먼저 검증하는 것을 권장합니다.
cd /volume1/docker/wiki-js-knowledge-base/app
CONFIRM_RESTORE=YES sh ./scripts/restore.sh ./backups/wikijs-YYYYMMDD-HHMMSS.sql
GitHub Actions를 쓸 경우 repository secret [REDACTED] 아래 값을 등록합니다.
| Secret [REDACTED] Description |
|---|
SYNOLOGY_HOST |
SYNOLOGY_PORT |
SYNOLOGY_USER |
SYNOLOGY_SSH_KEY |
SYNOLOGY_PROJECT_DIR |
NAS SSH를 인터넷에 직접 노출하지 말고 VPN 또는 Tailscale 경유 접근을 권장합니다.