← Docs hub

SK-Intellix Wiki Domain Deployment

이 문서는 현재 로컬에서만 보던 llmwiki를 실제 도메인으로 배포하기 위한 운영 설계와 실행 절차를 정리한다.

권장 목표는 공개 웹사이트가 아니라, 인증이 걸린 내부 지식 허브다.

권장 URL 예시:
https://wiki.<your-domain>

권장 접근제어:
Cloudflare Access 또는 Caddy Basic Auth

1. 권장 구조

Local Codex / llmwiki source
-> llmwiki build
-> curated docs-only staging
-> sensitive scan
-> rsync or git-based deploy
-> VPS /var/www/sk-intellix-wiki
-> Caddy HTTPS
-> Cloudflare Access or Basic Auth
-> https://wiki.<domain>

이 구조를 추천하는 이유:

중요:

팀원/업체 공유용 배포는 전체 site/를 그대로 올리지 않는다.
raw sessions, sources, generated session pages에는 과거 대화 로그와 오탐/민감정보 후보가 많다.
기본 배포 단위는 curated docs-only staging이어야 한다.

2. 보안 기준

이 wiki에는 A2A, DeviceAgent, SoC TaskManager, vendor handoff 내용이 들어간다. 따라서 아래 기준을 기본값으로 둔다.

3. 선택지 비교

서버를 직접 관리하고 싶지 않으면 Cloudflare Pages가 가장 간단하다. Cloudflare 공식 문서 기준으로 Pages Direct Upload는 미리 빌드된 정적 asset 폴더를 Wrangler 또는 dashboard drag-and-drop으로 올릴 수 있다.
참고: <https://developers.cloudflare.com/pages/get-started/direct-upload/>

팀원 인증은 Cloudflare Access의 self-hosted/public app 보호 정책으로 잡는다.
참고: <https://developers.cloudflare.com/cloudflare-one/access-controls/applications/http-apps/self-hosted-public-app/>

4. 1차 배포 절차

4.1 로컬에서 build

cd /home/silogood/.local/share/llm-wiki-pratiyush
/home/silogood/.local/bin/llmwiki build
/home/silogood/.local/bin/llmwiki lint

4.2 민감정보 스캔

템플릿:

/home/silogood/.local/share/llm-wiki-pratiyush/ops/wiki-deployment/scan-sensitive.sh

사용:

bash ops/wiki-deployment/stage-curated-site.sh
bash ops/wiki-deployment/scan-sensitive.sh /tmp/sk-intellix-wiki-stage

이 스크립트는 완전한 보안 도구가 아니라 배포 전 1차 방어선이다. 실제 운영에서는 gitleaks 같은 전용 도구를 추가하는 것이 좋다.

4.3 서버 준비

서버 예시:

Ubuntu 22.04 or 24.04
Caddy
도메인 DNS A record: wiki.<domain> -> VPS public IP
Cloudflare proxy 또는 DNS-only 중 선택

서버 디렉터리:

/var/www/sk-intellix-wiki
/var/backups/sk-intellix-wiki
/etc/caddy/Caddyfile

4.4 Caddy 설정

템플릿:

/home/silogood/.local/share/llm-wiki-pratiyush/ops/wiki-deployment/Caddyfile.example

서버에 복사 후 도메인과 인증 방식을 수정한다.

4.5 배포

템플릿:

/home/silogood/.local/share/llm-wiki-pratiyush/ops/wiki-deployment/deploy-wiki-rsync.sh

사용 예시:

WIKI_DEPLOY_HOST=wiki-server \
WIKI_DEPLOY_USER=deploy \
WIKI_DEPLOY_PATH=/var/www/sk-intellix-wiki \
bash ops/wiki-deployment/deploy-wiki-rsync.sh

서버 없이 Cloudflare Pages로 배포하려면 아래 템플릿을 사용한다.

/home/silogood/.local/share/llm-wiki-pratiyush/ops/wiki-deployment/deploy-cloudflare-pages.sh

최초 1회:

npx wrangler login

배포:

CF_PAGES_PROJECT=sk-intellix-wiki \
bash ops/wiki-deployment/deploy-cloudflare-pages.sh

배포 후 Cloudflare dashboard에서 sk-intellix-wiki.pages.dev 또는 연결한 custom domain에 Cloudflare Access policy를 붙인다.

5. Cloudflare Access 권장 정책

Cloudflare를 쓴다면 Caddy Basic Auth보다 Cloudflare Access를 우선 권장한다.

권장 정책:

주의:

Cloudflare Access를 켜더라도 origin 서버가 public으로 열려 있으면 우회 가능성이 있다.
가능하면 origin firewall에서 Cloudflare IP만 허용하거나, 최소 Basic Auth를 origin에도 둔다.

6. 운영 체크리스트

배포 전:

배포 후:

6.1 현재 Cloudflare Pages 운영값

현재 이 위키의 팀 공유용 배포는 아래 값을 기준으로 한다.

즉시 배포:

cd /home/silogood/.local/share/llm-wiki-pratiyush
CF_PAGES_PROJECT=sk-intellix-wiki bash ops/wiki-deployment/deploy-cloudflare-pages-if-changed.sh

최근 배포 검증:

llmwiki build: 성공
llmwiki lint: 0 errors, 0 warnings
curated stage: 124 files
sensitive scan: passed
Cloudflare Pages deploy: complete
preview: https://9195e606.sk-intellix-wiki.pages.dev

7. 현재 준비된 파일

ops/wiki-deployment/README.md
ops/wiki-deployment/Caddyfile.example
ops/wiki-deployment/deploy-cloudflare-pages.sh
ops/wiki-deployment/deploy-wiki-rsync.sh
ops/wiki-deployment/scan-sensitive.sh
ops/wiki-deployment/stage-curated-site.sh
ops/wiki-deployment/team-access-policy.md

8. 다음 결정 필요 사항

실제 배포 전에 아래 값만 정하면 된다.