Cloudwiki

Cloudwiki 는 Cloudflare Workers로 셀프호스팅할 수 있는 서버리스 위키 엔진입니다. 커뮤니티 위키부터 프라이빗 팀의 내부 지식 베이스까지, 작게 시작해 트래픽이 늘어도 서버 증설 없이 운영할 수 있으며, [[Cloudwiki/위키 문법 가이드|마크다운 기반 확장 문법]] 및 MCP 서버를 지원합니다.

> https://wiki.vialinks.xyz



# 소개

Cloudwiki 는 Cloudflare Workers 위에서 동작하는 서버리스 위키입니다. 별도의 서버를 임대하거나 관리할 필요 없이, Cloudflare 계정 하나로 위키를 띄우고 운영할 수 있습니다.


# 핵심 특징


 프리티어 셀프호스팅
Cloudflare Workers · D1 · R2 · KV 위에서 동작합니다. 소규모에서 무료 한도로 충분하고, 늘어나도 Workers Paid 요금제 전환만으로 대응 가능합니다.

 컴포넌트 조립식 문서
마크다운 + 확장 문법으로 위키 내부 링크, 틀(트랜스클루전)을 지원하며, 카드 · 그리드 · 탭 · 콜아웃 · 버튼 · 진행도 바 등을 조립해, 문서 한 장을 페이지처럼 구성합니다.

 MCP 외장 지식 저장소
모델 컨텍스트 프로토콜(MCP) 서버를 내장해, AI 에이전트가 위키를 검색 · 열람 · 편집하는 외장 지식 베이스로 활용할 수 있습니다.

 커뮤니티 · 프라이빗 팀
문서 · 카테고리 단위 ACL, 회원가입 정책, 위키 공개 설정으로 공개 커뮤니티 위키와 팀 위키를 모두 운영할 수 있습니다.



# 기술 스택

| 영역 | 사용 기술 |
| --- | --- |
| 런타임 | Cloudflare Workers (서버리스) |
| 프레임워크 | [Hono](https://hono.dev/) |
| 데이터베이스 | [Cloudflare D1](https://developers.cloudflare.com/d1/) (SQLite 기반) |
| 오브젝트 스토리지 | [Cloudflare R2](https://developers.cloudflare.com/r2/) (미디어 업로드) |
| Key-Value | [Cloudflare KV](https://developers.cloudflare.com/kv/) (사이드바 설정 · 동시편집 충돌 감지) |
| 보안 · API | [Turnstile](https://developers.cloudflare.com/turnstile/) (캡차), Web Push API |
| 언어 |  TypeScript |
| 프런트엔드 | Bootstrap 5, Astro 셸, CodeMirror 6, Marked.js, DOMPurify, PrismJS, SweetAlert2 |

# 위키 문법

마크다운을 기반으로 확장한 문법을 사용하며, 기존 마크다운 문서를 그대로 가져와 쓸 수 있습니다. 문서 작성에 쓰는 전체 문법은 [[Cloudwiki/위키 문법 가이드]] 와 [[Cloudwiki/위키 문법 가이드/컴포넌트|컴포넌트 문법]] 을 참고하세요.

# 빠른 시작


1. 저장소 준비
공개 저장소 `eoeoe22/cloudwiki-public` 를 클론해 본인 GitHub 프라이빗 저장소에 올립니다.

2. Cloudflare 리소스 생성
D1 · R2 · KV 를 만들고 `wrangler.toml` 에 값을 채운 뒤, OAuth(Google / Discord) 를 설정합니다.

3. 배포
Cloudflare Workers 에 GitHub 저장소를 연결해 배포하고, 도메인을 연결합니다.



전체 절차(OAuth · Turnstile · 시크릿 주입 · D1 마이그레이션 등)는 [[Cloudwiki/설정|설정 가이드]] 에서 자세히 안내합니다.

# 문서 안내


 기능
[[Cloudwiki/기능/문서|문서·대체 제목]] · [[Cloudwiki/기능/ACL|ACL 권한]] · [[Cloudwiki/기능/검색|검색]] · [[Cloudwiki/기능/맵 및 그래프|맵·그래프]] · [[Cloudwiki/기능/틀|틀]] · [[Cloudwiki/기능/편집 요청|편집 요청]] · [[Cloudwiki/기능/문서 주시|문서 주시]]

 에디터
[[Cloudwiki/에디터|에디터 개요]] · [[Cloudwiki/에디터/툴바|툴바]] · [[Cloudwiki/에디터/단축키|단축키]] · [[Cloudwiki/에디터/표|표]] · [[Cloudwiki/에디터/이미지 업로드|이미지 업로드]] · [[Cloudwiki/에디터/자동완성|자동완성]]

 설정
[[Cloudwiki/설정|설치·초기 설정]] · [[Cloudwiki/설정/MCP서버|MCP 서버]] · [[Cloudwiki/설정/테마|테마]] · [[Cloudwiki/설정/푸시알림|푸시 알림]] · [[Cloudwiki/설정/웹훅|웹훅]] · [[Cloudwiki/설정/회원가입 정책|회원가입 정책]]

 문법
[[Cloudwiki/위키 문법 가이드|위키 문법 가이드]] · [[Cloudwiki/위키 문법 가이드/컴포넌트|컴포넌트]] · [[Cloudwiki/위키 문법 가이드/차트|차트 • 다이어그램]]

 확장 기능
[[Cloudwiki/확장 기능|확장 기능]] · [[Cloudwiki/확장 기능/freq|freq]] · [[Cloudwiki/확장 기능/stock|stock]]

 관리 · 운영
[[Cloudwiki/관리자|관리자]] · [[Cloudwiki/관리자/블로그 및 공지|블로그·공지]] · [[Cloudwiki/Pricing|가격·라이선스]] · [[Cloudwiki/이용약관|이용약관]]





# 운영 비용

방문자 수가 적다면 Cloudflare Workers 프리티어 환경에서 매우 안정적으로 운영할 수 있습니다. 방문자가 급증하더라도 별도의 서버 증설 작업 없이 Cloudflare Workers Paid 요금제 전환만으로 대응할 수 있습니다. 자세한 한도와 요금 비교는 [[Cloudwiki/Pricing|Pricing]] 문서를 참고하세요.

# 라이선스

MIT 라이선스로 자유롭게 사용할 수 있습니다. 사용하실 때 `eoe@vialinks.xyz` 로 한마디 보내주시면 감사하겠습니다.