93 lines
3.0 KiB
Markdown
93 lines
3.0 KiB
Markdown
---
|
|
title: CF Multisite (정적 사이트 호스팅)
|
|
updated: 2026-03-28
|
|
tags: [service, hosting, cloudflare, r2]
|
|
---
|
|
|
|
## 개요
|
|
|
|
Cloudflare Workers + R2 기반 멀티테넌트 정적 사이트 호스팅 플랫폼. Gitea repo에 push하면 자동으로 R2에 업로드되고, Workers가 서브도메인으로 서빙.
|
|
|
|
## 아키텍처
|
|
|
|
```
|
|
hosting/{customer} repo (Gitea push)
|
|
→ Gitea Actions Runner (jp1)
|
|
→ rclone sync → R2 multisite-bucket/sites/{customer}/
|
|
→ Cloudflare Workers (cf-multisite)
|
|
→ {customer}.actions.it.com
|
|
```
|
|
|
|
## 구성요소
|
|
|
|
| 항목 | 값 |
|
|
|------|-----|
|
|
| Worker | `cf-multisite` (Cloudflare Workers) |
|
|
| R2 버킷 | `multisite-bucket` |
|
|
| R2 API 키 | Vault `secret/cloud/r2-multisite` |
|
|
| DNS | `*.actions.it.com` → Cloudflare proxied |
|
|
| Worker 라우트 | `*.actions.it.com/*` |
|
|
| Gitea org | `hosting` (private) |
|
|
| 소스 코드 | `kaffa/cf-multisite` |
|
|
| 템플릿 | `kaffa/cf-multisite/template/.gitea/workflows/deploy.yml` |
|
|
|
|
## Gitea org secrets (hosting)
|
|
|
|
org-level secrets로 모든 고객 repo에 자동 적용:
|
|
|
|
| Secret | 용도 |
|
|
|--------|------|
|
|
| R2_ACCESS_KEY | R2 S3 호환 액세스 키 |
|
|
| R2_SECRET_KEY | R2 S3 호환 시크릿 키 |
|
|
| R2_ENDPOINT | `https://d8e5997eb4040f8b489f09095c0f623c.r2.cloudflarestorage.com` |
|
|
|
|
## 고객 사이트 추가 절차
|
|
|
|
```bash
|
|
# 1. hosting org에 repo 생성
|
|
tea repo create --name {customer} --owner hosting --init
|
|
|
|
# 2. deploy.yml 복사 (kaffa/cf-multisite 템플릿에서)
|
|
# template/.gitea/workflows/deploy.yml을 고객 repo에 추가
|
|
|
|
# 3. 정적 파일 push
|
|
git clone https://gitea.inouter.com/hosting/{customer}.git
|
|
cd {customer}
|
|
# index.html 등 추가
|
|
git add . && git commit -m "initial site" && git push
|
|
|
|
# 4. 자동 배포 → https://{customer}.actions.it.com
|
|
```
|
|
|
|
org secrets가 자동 상속되지 않으면 repo-level secrets를 수동 설정:
|
|
```bash
|
|
TOKEN="(Vault secret/apps/gitea api_token)"
|
|
for secret in R2_ACCESS_KEY R2_SECRET_KEY R2_ENDPOINT; do
|
|
curl -X PUT -H "Authorization: token $TOKEN" \
|
|
"https://gitea.inouter.com/api/v1/repos/hosting/{customer}/actions/secrets/$secret" \
|
|
-H "Content-Type: application/json" \
|
|
-d "{\"data\":\"(Vault secret/cloud/r2-multisite $secret)\"}"
|
|
done
|
|
```
|
|
|
|
## Worker 기능
|
|
|
|
- **멀티테넌트**: 서브도메인 → R2 경로 매핑 (`{customer}.actions.it.com` → `/sites/{customer}/`)
|
|
- **캐시**: HTML 1시간, 정적파일(CSS/JS/이미지) 24시간 Edge 캐시
|
|
- **Rate Limiting**: KV 기반 분당 요청 수 제한 (티어별)
|
|
- **Admin API**: 사용량/고객/통계 조회 (`/api/usage/:customer`, `/api/customers` 등)
|
|
- **MIME 자동감지**: 확장자 기반 Content-Type 매핑
|
|
|
|
## 배포 방식
|
|
|
|
rclone으로 R2 S3 호환 API 사용. AWS CLI 대비 설치 빠르고 경량.
|
|
|
|
## 운영 중인 사이트
|
|
|
|
| 서브도메인 | repo | 상태 |
|
|
|-----------|------|------|
|
|
| demo.actions.it.com | kaffa/cf-multisite (sample-site) | ✅ |
|
|
| test-customer.actions.it.com | (직접 업로드) | ✅ |
|
|
| multisite-demo.actions.it.com | (직접 업로드) | ✅ |
|
|
| demo-site.actions.it.com | hosting/demo-site | ✅ |
|