웹사이트 라우팅 및 다중 사이트
이제 교회 한 곳이 서로 다른 여러 웹사이트를 운영할 수 있으며, 각 사이트는 *.b1.church 서브도메인이나 교회가 직접 소유한 완전한 사용자 지정 도메인에 있을 수 있습니다. 이 페이지는 빌더 아래에 있는 라우팅 계층을 설명합니다. 들어오는 요청이 교회와 특정 사이트로 어떻게 연결되는지, 다중 사이트 데이터 모델(기존의 모든 사이트가 변함없이 렌더링되도록 하는 siteId 센티널), 그리고 사용자 지정 도메인 가장자리 계층을 다룹니다. 가장자리 계층은 EC2에서 실행되는 직접 관리하는 Caddy 프록시로, TLS를 종료하고 각 교회 도메인을 *.b1.church 업스트림으로 다시 씁니다. 요청이 연결된 후 실제로 무엇이 렌더링되는지(페이지/섹션/요소 트리)는 웹사이트 빌더를 참고하세요.
개요
grace.b1.church www.gracechurch.org (사용자 지정 도메인)
(b1.church 서브도메인) │
│ ▼
│ ┌──────────────────────────────────────────┐
│ │ Caddy 가장자리 — EC2 3.23.251.61 │
│ │ (proxy.b1.church) │
│ │ • TLS 종료 (도메인별 LE 인증서) │
│ │ • Host → {sub}.b1.church 다시 쓰기 │
│ │ • B1App으로 역방향 프록시 │
│ └────────────────────┬─────────────────────┘
│ Host = {sub}.b1.church
▼ ▼
┌────────────────────────────────────────────────────────────┐
│ B1App src/middleware.ts │
│ • 항상: 클라이언트가 보낸 x-site 삭제 (위조 방지) │
│ • 내부 *.b1.church Host ⇒ 도메인 조회는 동작하지 않음 │
│ • 원시 사용자 지정 Host (Caddy 우회) ⇒ 조회 → x-site 설정 │
└───────────────────────────┬────────────────────────────────┘
▼ next.config.mjs → 호스트 첫 레이블 → /[sdSlug]/…
┌─────────────────────────────────────────────────┐
│ [sdSlug] · ConfigHelper.load(sdSlug) │
│ GET /membership/churches/lookup/?subDomain=… │
│ → { id, name, subDomain, siteId? } │
│ 모든 콘텐츠 호출에 ?siteId= 전달: │
│ /content/pages/:id/tree · /globalStyles · │
│ /blocks/public/footer · /links · sitemap │
└─────────────────────────────────────────────────┘
도메인 저장/삭제 (B1Admin 설정→도메인 → POST /membership/domains)
└─ 최선의 노력으로 CaddyHelper.updateCaddy() 호출 (감싸져 있으며 치명적이지 않음, 10초 시간 초과)
Caddy는 두 개의 익명 엔드포인트로 domains 테이블을 직접 읽음:
GET /membership/domains/authorize — 요청 시 TLS `ask` (알려진 도메인 200 / 알 수 없으면 404)
GET /membership/domains/hostmap — host→{sub}.b1.church 맵 (5분마다 갱신)
이 계층에는 세 가지 규칙이 적용됩니다.
- 센티널이 모든 것의 하위 호환성을 유지합니다.
siteId = ''는 기본 사이트입니다. 이 기능이 생기기 전부터 있던 모든 페이지, 블록, 링크, 전역 스타일, 도메인 행은''를 가지며, 예전과 똑같이 렌더링됩니다. 두 번째 웹사이트는 단지siteId가 비어 있지 않은 행들의 집합이며,?siteId=없이 호출된 콘텐츠 엔드포인트는 기본 사이트를 반환합니다. 예전 요청과 바이트 단위로 같습니다. - 연결은 호스트 레이블 기반이며 한 곳으로 모입니다.
*.b1.church서브도메인은 호스트 레이블로 직접 라우팅됩니다. 사용자 지정 도메인은 B1App이 보기 전에 Caddy 가장자리에서{sub}.b1.church레이블로 다시 쓰이며, (원시 사용자 지정Host에 대비해) 미들웨어의 DB 조회가 대체 수단으로x-site헤더를 설정합니다. 두 경로 모두 같은[sdSlug]라우트와 같은churches/lookup호출로 연결되므로, 이후 렌더링은 동일합니다. - Caddy 가장자리는 하나의 진실 원천을 바라보는 무상태 구조입니다. 사용자 지정 도메인은 직접 관리하는 EC2의 Caddy 프록시에서 종료되며, 이 프록시는 각 도메인을
{sub}.b1.church업스트림으로 다시 씁니다. 도메인을 저장하면 최선의 노력으로CaddyHelper.updateCaddy()가 한 번 호출되며, Caddy도domains테이블을 직접 읽습니다(아래의authorize및hostmap엔드포인트). 테이블이 권위 있는 원천이므로, Caddy에 연결할 수 없어도 저장이 실패하는 일은 없습니다.
사이트 연결
*.b1.church 서브도메인
B1App/next.config.mjs는 호스트에 따라 들어오는 요청을 다시 씁니다. (?<subdomain>.*?)\..* 패턴의 호스트 규칙은 호스트의 첫 번째 레이블을 캡처하고, / 및 /:path*를 /{subdomain}으로 다시 씁니다. 이는 [sdSlug] App Router 세그먼트입니다. 따라서 grace.b1.church/about은 /grace/about이 됩니다.
src/app/[sdSlug]/ 안에서 ConfigHelper.load(sdSlug)(src/helpers/ConfigHelper.ts)는 GET /membership/churches/lookup/?subDomain={sdSlug}를 호출합니다. ChurchController.getBySubDomain 응답에는 이제 두 가지 분기가 있습니다.
| 슬러그 일치 대상 | 응답 | 의미 |
|---|---|---|
churches.subDomain | { id, name, subDomain } | 해당 교회의 기본 사이트 |
sites.subDomain | { id, name, subDomain, siteId } | 보조 사이트 -- 컨트롤러가 sites로 대체 조회하여 소유 교회를 찾고, 조회한 슬러그와 추가 siteId를 돌려줌 |
이 추가 siteId만이 보조 사이트 요청과 기본 사이트 요청을 구별하는 유일한 요소이며, 나머지 파이프라인은 모두 공유됩니다.
두 테이블 중 어느 곳과도 일치하지 않는 슬러그는 200과 함께 {}를 반환합니다. ConfigHelper.load는 id가 없는 응답을 알 수 없는 사이트로 보고 Next의 notFound()를 호출하므로, 알 수 없는 서브도메인은 이후 모든 호출이 /…/undefined를 요청하는 대신 실제 404를 받습니다. 빌더 페이지 라우트도 pageTreePath()(src/helpers/pageTreePath.ts)로 트리 경로를 만들며, 이 함수는 슬러그를 URL 인코딩합니다. 그래서 잘못된 형식의 슬러그(백슬래시, 공백)는 API의 400이 500으로 노출되는 대신 404가 됩니다.
사용자 지정 도메인
교회가 소유한 도메인은 Caddy 가장자리(아래에서 자세히 설명)에서 종료되며, 이 가장자리는 B1App으로 프록시하기 전에 Host 헤더를 사이트의 {sub}.b1.church로 다시 씁니다. 따라서 일반 경로에서 B1App은 내부 *.b1.church 호스트를 받으며, 기본 서브도메인과 똑같이 호스트 레이블로 연결합니다. 미들웨어의 DB 조회는 실행되지 않습니다. src/middleware.ts는 모든 요청에 대해 여전히 실행되지만, 항상 수행하는 작업 하나와 대체 작업 하나가 있습니다.
- 항상 -- 클라이언트가 보낸
x-site헤더를 삭제합니다. 이 헤더는 위조할 수 있는 다시 쓰기 입력이며, 미들웨어 자신이 설정한 경우에만 신뢰합니다. 이 헤더를 제거하는 것이 Caddy 뒤에서 미들웨어가 하는 실제 작업입니다. - 대체 작업, 내부가 아닌
Host에만 -- Caddy의 다시 쓰기를 거치지 않고 B1App에 도달한 원시 사용자 지정 도메인Host에 대해서는GET /membership/domains/public/lookup/{host}를 호출하고, 그 결과에subDomain이 있으면x-site: {subDomain}.b1.church를 설정합니다. Caddy 뒤에서는Host가 이미*.b1.church이므로 이 분기는 동작하지 않습니다.
내부 호스트 -- localhost, b1.church, 그리고 .b1.church, .localtest.me, .localhost, .up.railway.app, .vercel.app 접미사를 가진 호스트 -- 는 조회를 아예 건너뜁니다. 이미 호스트 레이블 다시 쓰기로 연결되었거나, 미리보기 또는 배포 호스트이기 때문입니다.
조회 자체(DomainRepo.loadByName)는 domains → churches와 domains → sites를 왼쪽 조인하고 COALESCE(NULLIF(sites.subDomain,''), churches.subDomain)을 반환합니다. 도메인이 보조 사이트를 가리키면 그 사이트의 서브도메인을, 그렇지 않으면 교회의 서브도메인을 반환합니다. 먼저 정확한 호스트와 일치시키며, 그 호스트가 www.로 시작했는데 일치하지 않으면 기본 apex로 한 번 다시 시도합니다.
next.config.mjs에서 x-site 다시 쓰기 규칙은 일반 호스트 규칙 앞에 배치되므로 우선합니다. x-site: grace.b1.church → 첫 레이블 grace → [sdSlug] = grace이며, 이후의 연결은 서브도메인 경로와 같습니다(같은 churches/lookup, 같은 siteId).
x-site 헤더는 외부에서 들어온 값을 신뢰하지 않습니다. 미들웨어는 자신이 설정하기 전에 들어온 x-site를 무조건 제거하며, 다시 쓰기 규칙은 미들웨어가 설정한 값만 봅니다. 따라서 클라이언트가 헤더를 보내서 다른 교회의 콘텐츠에 강제로 접근할 수는 없습니다.
미들웨어와 관련된 운영 세부 사항은 두 가지입니다.
- 캐시. 각 호스트의 결과(적중 또는 확인된 미스 -- 네트워크 오류는 절대 해당하지 않음)는 서버리스 아이솔레이트마다 메모리 내
Map에 10분 동안 캐시됩니다. - 매처. 매처는
/sitemap.xml,/robots.txt,/manifest.webmanifest를 의도적으로 다시 포함합니다. 첫 번째 패턴은 점이 있는 경로를 제외하는데, 그렇지 않으면 이 파일들이 빠지기 때문입니다. 다시 포함시켜서 사용자 지정 도메인의 교회별 SEO/PWA 파일도x-site헤더를 받게 합니다. - 정식 헤더. 교회 페이지에 대해 미들웨어는
Link: <{proto}://{host}{path}>; rel="canonical"응답 헤더를 추가하여, 페이지가 실제로 제공된 호스트(서브도메인 또는 사용자 지정 도메인)를 가리킵니다(helpers/canonicalLink.ts). 사용자 지정 도메인이 Caddy 프록시를 통해 B1App에 도달하면 요청 호스트는{sub}.b1.church서브도메인이므로, 미들웨어는 대신X-Church-Host에서 방문자의 도메인을 사용합니다. 다만/domains/public/lookup/{host}가 해당 도메인이 같은 서브도메인에 대응함을 확인한 뒤에만 그렇게 합니다(ownsSubdomain()). 그러면 정식 링크,robots.txt,sitemap.xml은b1.church서브도메인이 아니라 사용자 지정 도메인을 가리킵니다. 내부가 아닌 호스트(b1.church,localhost,*.vercel.app,*.up.railway.app)와/mobile,/login,/logout, 생성된 robots/sitemap/manifest 파일에서는 이 과정을 건너뜁니다.
공개 웹사이트 비활성화
교회는 B1Admin에서 Disable Public Website(교회 수준 콘텐츠 설정 hidePublicSite = "true")를 켤 수 있습니다. 그러면 사이트는 교인 대상 경로만 제공합니다.
- B1App 미들웨어는 서브도메인을 조회하고(
/membership/churches/lookup, 그다음/content/settings/public/:churchId), 허용 목록 밖의 경로에 대한 익명 요청을/login?returnUrl={path}{query}로 리디렉션합니다. 허용 목록(helpers/publicSite.ts)은/login,/logout,/mobile/*,/register/*,/guest-register, 그리고 manifest/robots/sitemap 파일입니다. 확인된 응답만 캐시되며, 운영 환경에서는 60초 동안 캐시됩니다(관리자의 재검증 호출이 인스턴스별 이 맵을 지울 수 없기 때문입니다. 개발/테스트 환경에서는 캐시하지 않음). API 오류가 발생하면 모두를 잠그는 대신 사이트를 제공합니다. - 로그인한 교인은 전체 사이트를 봅니다. 만료되지 않은
jwt쿠키가 있는 요청은(미들웨어의hasSession()은 서명을 검증하지 않고 페이로드의exp만 디코딩합니다. 이것은 접근 제어가 아니라 느슨한 게이트입니다) 리디렉션을 건너뜁니다. 그래서 로그인 후 교인은 요청했던 페이지로 돌아가 일반 페이지, 기본 제공 페이지(그룹, 설교 등), 헤더 탐색을 볼 수 있습니다. 페이지 컴포넌트와Header는 더 이상hidePublicSite를 직접 확인하지 않습니다. - **
robots.txt**는 noindex 호스트와 마찬가지로 모든 것을 차단합니다. - API.
GET /content/pages/public/:churchId(사이트맵의 페이지 목록)는[]를 반환하므로, 익명 호출자는 페이지 목록을 볼 수 없습니다.
siteId 전달
ConfigHelper는 해석된 siteId를 요청별 ConfigurationInterface에 저장하고(React cache()로 메모이제이션), 이 객체와 페이지 컴포넌트가 하는 콘텐츠 호출에 ?siteId=를 덧붙입니다. 이때 조건부로 덧붙입니다. 빈 siteId(기본 교회 서브도메인)이면 매개변수 자체를 생략합니다. 전달되는 엔드포인트는 페이지 트리(/content/pages/:id/tree), 사이트맵에서 사용하는 공개 페이지 목록(/content/pages/public/:id), 전역 스타일(/content/globalStyles/church/:id), 탐색 링크(/content/links/church/:id), 독립형 푸터 블록(/content/blocks/public/footer/:id)입니다. 일반 렌더링 경로에서는 푸터가 페이지 트리 안(zone: "siteFooter"로 표시된 섹션)에 들어 있으며, 이미 siteId와 함께 가져오므로 범위가 지정되지 않은 푸터 문제는 없습니다.
교인 포털(B1App mobile)은 의도적으로 이 범위 밖에 있습니다. loadChurchAppearance.ts는 churches/lookup으로 교회를 찾지만, 교회 수준의 /settings/public/{id}를 읽으며 siteId를 전달하지 않습니다. 포털은 v1에서 교회 전체를 대상으로 합니다(아래 참고).
교회당 여러 웹사이트
데이터 모델
새로운 membership.sites 테이블은 의도적으로 단순합니다.
| 열 | 유형 | 참고 |
|---|---|---|
id | char(11) PK | |
churchId | char(11) | 소유 교회 |
name | varchar(255) | 표시 이름(예: "Español", "Youth") |
subDomain | varchar(45) | 고유 인덱스 -- 전역 네임스페이스(아래 참고) |
사이트 범위 지정은 콘텐츠 및 도메인 테이블에 추가된 널이 아닌 열 하나로 이루어집니다.
| 테이블(모듈) | 열 | ''의 의미 |
|---|---|---|
domains(membership) | siteId char(11) NOT NULL DEFAULT '' | 도메인이 기본 사이트를 제공함 |
pages, links, globalStyles, blocks(content) | siteId char(11) NOT NULL DEFAULT '' | 기본 사이트 -- 그리고 **blocks**에서 ''는 추가로 모든 사이트에서 공유를 뜻함 |
이 모든 것은 두 개의 마이그레이션으로 추가됩니다(tools/migrations/membership/2026-07-02_sites.ts, tools/migrations/content/2026-07-02_site_id.ts). 열의 기본값이 ''이므로, 기존의 모든 행은 백필 없이 지금의 동작을 그대로 유지합니다.
전역 서브도메인 네임스페이스. sites.subDomain은 churches.subDomain과 하나의 네임스페이스를 공유합니다. 따라서 사이트 서브도메인이 교회 서브도메인이나 다른 사이트의 서브도메인과 충돌할 수 없습니다. 이는 두 저장 경로 모두에서 강제됩니다. SiteController.save는 churches 또는 sites에 있는 슬러그를 거부하며, ChurchController.validateSave는 반대 방향으로 같은 검사를 합니다. sites.subDomain의 고유 인덱스가 데이터베이스 수준에서 이를 뒷받침합니다.
페이지 고유성은 (churchId, url)에서 (churchId, siteId, url)로 넓어졌으므로, 한 교회의 두 사이트가 각자 자신의 /about을 가질 수 있습니다.
대체 수단이 있는 사이트별 콘텐츠
사이트 범위가 지정된 모든 콘텐츠 목록/트리 엔드포인트는 선택적 ?siteId=를 받습니다(없으면 '' = 기본). 페이지 트리/목록/공개, 블록 목록/유형별/푸터, 링크(익명/필터링/전체), 전역 스타일이 여기에 해당합니다. 섹션과 요소는 직접 범위가 지정되지 않으며, 상위 페이지나 블록을 통해 상속됩니다.
두 가지 해석 체인이 흥미로운 일을 합니다.
- 전역 스타일 --
사이트 → 기본 → 기본값.GlobalStyleRepo.loadForChurch(churchId, siteId)는 사이트 고유 행을 반환합니다. 보조 사이트에 행이 없으면 기본('') 행을 그대로 반환합니다(클라이언트가 복사 후 쓰기에 사용하는 기본 행의id/siteId를 유지함). 기본 행도 없으면GlobalStyleController는 코드에 고정된 기본 팔레트/글꼴을 반환합니다. - 푸터 블록 -- 사이트별 항목이 우선하고, 공유 항목이 대체합니다.
BlockRepo.loadByBlockType(churchId, "footerBlock", siteId)는 공유('') 행과 사이트별 행을 모두 반환하며, 리졸버는 사이트 고유 푸터가 있으면 그것을, 없으면 공유 푸터를 고릅니다. 같은 로직이TreeHelper.insertBlocks(페이지 트리)와 독립형/content/blocks/public/footer/:churchId엔드포인트 모두에서 실행됩니다.
사이트 삭제 연쇄
SiteController.delete(membership 설정→편집 권한으로 제한됨)는 보조 사이트를 세 단계로 삭제합니다.
ContentModuleGateway.deleteSiteContent(churchId, siteId)가 사이트가 소유한 모든 콘텐츠를 연쇄 삭제합니다. 사이트의 페이지(섹션, 요소,pageHistory,posts까지), 사이트 자체 블록(섹션, 요소,pageHistory까지), 링크와 globalStyles.''에 대해서는 실행을 거부하는 가드가 있어, 기본/공유 센티널은 절대 연쇄 삭제되지 않습니다.DomainRepo.clearSiteId는 사이트의 도메인을 삭제하지 않고 기본 사이트(siteId → '')로 다시 할당합니다. 그래서 사이트를 삭제해도 사용자 지정 도메인은 살아남습니다.sites행이 삭제되고 Caddy 경로가 다시 동기화됩니다(최선의 노력).
B1Admin 화면
| 기능 | 위치 | 방식 |
|---|---|---|
| 사이트 전환기 | useSiteSelection + SiteSwitcher(비어 있음 = "Main Website") | ?site= URL 매개변수를 읽고 ContentApi 호출에 ?siteId=로 전달함. Pages, Blocks, Appearance 세 사이트 목록 영역에 있지만, siteId를 레코드에 담고 있는 페이지/블록 편집기에는 없음 |
| 사이트 생성/삭제 | 전환기의 "Manage websites…" 항목에서 여는 SitesDialog | POST /membership/sites / DELETE /membership/sites/:id(이름 + subDomain). membership 설정→편집 권한으로 제한됨(서버에서는 Permissions.settings.edit, B1Admin에서는 Permissions.membershipApi.settings.edit). 생성/삭제만 가능하며, v1에는 이름 변경 UI가 없음 |
| 도메인별 사이트 할당 | 설정→도메인 아래의 DomainSettingsEdit | 행마다 사이트 드롭다운이 있으며, 도메인별 siteId를 /membership/domains로 보냄. API가 사이트를 반환하지 않으면(이전 백엔드) 이 열은 숨겨짐 |
| 복사 후 쓰기 스타일 | StylesManager.prepareForSave | 불러온 전역 스타일 행의 siteId가 선택된 사이트와 일치하지 않으면(즉 API가 상속된 기본 사이트를 대체 수단으로 반환함), 기본의 id를 버리고 현재 siteId를 찍어서, 기본을 덮어쓰는 대신 사이트별 새 행을 삽입하도록 강제함. 같은 불일치 분기가 사이트 푸터 블록에도 적용됨 |
v1에서 교회 전체로 남아 있는 것(데이터 모델의 한계가 아니라 의도적인 범위 결정): 블로그(BlogPage에는 전환기가 없고 siteId 없이 /posts를 불러옴), 사이트 위젯(공지 배너 + 런처), 리디렉션, 로고 / GA4 / 교회 설정, 그리고 교인 포털(B1App 모바일)입니다. 이것은 "Appearance 전체"가 아니라는 점에 유의하세요. 보조 사이트의 전역 스타일(팔레트, 글꼴, 타이포그래피, 간격, 탐색, 사용자 지정 CSS)은 위의 복사 후 쓰기 경로를 통해 사이트별입니다. Appearance 페이지에서 교회 전체로 남는 것은 배너/런처/리디렉션/로고 하위 패널뿐입니다.
사용자 지정 도메인: Caddy 가장자리(정적 구성 계획)
방향 수정 2026-07-02. 사용자 지정 도메인 호스팅을 Vercel 관리 도메인으로 옮기려던 이전 계획은 취소되었으며, Vercel 도메인 등록 코드 전체(VercelHelper, 그 vercelToken/vercelProjectId/vercelTeamId 환경 변수, SSM 매개변수, 상태 확인 항목)가 Api에서 제거되었습니다. 직접 관리하는 EC2의 Caddy 프록시가 영구적인 사용자 지정 도메인 가장자리로 남습니다. 남은 작업은 내부적인 것뿐입니다. Caddy의 런타임 관리 API 구성을 재시작에도 살아남는 정적 구성으로 바꾸는 것입니다.
가장자리
모든 사용자 지정 교회 도메인은 DNS가 EC2 장비 하나(3.23.251.61, proxy.b1.church로도 접근 가능)를 가리키도록 설정합니다. B1Admin의 설정→도메인 화면은 교회에 apex A → 3.23.251.61 또는 CNAME → proxy.b1.church를 추가하라고 안내합니다. Caddy는 도메인별 Let's Encrypt 인증서로 TLS를 종료하고, Host 헤더를 도메인의 {sub}.b1.church 업스트림으로 다시 쓴 뒤 B1App으로 역방향 프록시합니다. B1App은 이를 모든 기본 서브도메인과 똑같이 호스트 레이블로 라우팅합니다(위의 사용자 지정 도메인 참고).
업스트림 매핑은 DomainRepo.loadPairs에서 나옵니다. 이 함수의 연결 대상은 할당된 사이트의 서브도메인을 COALESCE하므로, 도메인은 올바른 보조 사이트로 프록시되고, 없으면 교회의 기본 사이트로 대체됩니다.
CONCAT(COALESCE(NULLIF(s.subDomain,''), c.subDomain), '.b1.church:443') AS dial
WHERE d.domainName NOT LIKE '%www.%'
www.* 행은 맵에서 제외됩니다. Caddy는 대신 302 리디렉션으로 www.{host}를 apex로 보냅니다.
가장자리에 데이터를 제공하는 두 개의 익명 엔드포인트
DomainController는 장비가 직접 사용하는 인증되지 않은 읽기 전용 엔드포인트 두 개를 노출합니다. 가장자리는 교회 컨텍스트가 생기기 전에 이들을 조회해야 하므로 익명이어야 합니다.
| 엔드포인트 | 반환 | 역할 |
|---|---|---|
GET /membership/domains/authorize?domain= | 도메인이 domains에 있으면(또는 www. 미스의 경우 기본 apex) 200, 그 밖에는 404(빈 domain도 포함) | Caddy의 요청 시 TLS ask: 들어온 SNI에 대해 인증서를 발급할지 결정하는 남용 방지 장치 |
GET /membership/domains/hostmap | text/plain, 라우팅 가능한 도메인마다 정렬된 {domain} {sub}.b1.church 한 줄 | 장비가 타이머로 갱신하는 호스트→업스트림 맵 파일 |
authorize는 DomainRepo.loadByName을 재사용하고(정확한 호스트, 그다음 www.→apex 한 번 재시도), hostmap은 loadPairs를 재사용합니다. 따라서 사이트를 인식하며 www.*를 제외하고 프록시 경로와 동일하며, :443 접미사만 제거합니다.
도메인 저장/삭제 -- 최선의 노력으로 한 번 전송
DomainController.save는 domains 행을 쓴 뒤 CaddyHelper.updateCaddy()를 한 번 최선의 노력으로 호출합니다. 이 호출은 기록(console.error)하고 오류를 삼키는 try/catch로 감싸져 있습니다. delete도 같은 방식이며(이전의 오래된 경로 삭제 버그도 이것으로 고쳐졌습니다), 보조 사이트 삭제(SiteController.delete)도 마찬가지입니다. updateCaddy 자체가 10초 Axios 시간 초과로 제한되므로, 연결할 수 없거나 중지된 Caddy 때문에 도메인 저장이 500으로 실패하는 일은 없습니다. domains 테이블이 진실 원천입니다.
현재 상태 -- 정적 구성, 런타임 상태 없음
이 장비(영구 Elastic IP 뒤의 Windows EC2)는 정적 Caddyfile로 Caddy를 실행합니다. 요청 시 TLS를 쓰며 그 ask는 /membership/domains/authorize를 가리킵니다. 그리고 호스트→업스트림 맵 파일을 예약 작업이 5분마다 /membership/domains/hostmap에서 갱신하며, 작업은 정상적인 caddy reload로 끝납니다. 구성은 런타임 상태 없이 재시작을 견디므로 다시 준비하는 과정이 필요 없습니다. 알 수 없는 SNI는 TLS 거부되고(authorize가 거부한 호스트에는 인증서가 발급되지 않음), 승인되었지만 아직 맵에 없는 호스트(동기화 기간 안의 완전히 새로운 도메인)는 깔끔한 404를 받습니다. 새 도메인은 저장 후 약 5분 안에 라우팅 가능해지며, 인증서는 첫 접근 때 발급됩니다. 구축/설정, 운영, 현장에서 검증된 주의 사항은 Caddy 사용자 지정 도메인 프록시를 참고하세요.
이전 런타임 푸시 -- 롤백 경로, 삭제 예정
CaddyHelper(membership 모듈)는 여전히 caddyHost:caddyPort의 관리 API를 통해 Caddy를 제어할 수 있습니다(SSM caddyHost/caddyPort. 설정되지 않으면 아무 작업도 하지 않으며, ServerHealthController의 Integrations 그룹에 표시됨). updateCaddy()는 전체 라우트 배열을 PATCH하고, initializeCaddy()와 GET /membership/domains/caddy/init / GET /membership/domains/caddy 엔드포인트는 런타임에 구성된 서버를 처음부터 다시 만듭니다. 이 모드의 구성은 Caddy의 메모리에만 있었으며, 이것이 바로 이 아키텍처가 대체한 "재시작하면 기억을 잃는" 문제였습니다. 이 기계 장치는 롤백 경로로만 남아 있으며, 정적 장비가 안정적으로 동작하면 삭제될 예정입니다. 도메인 저장/삭제 시의 최선의 노력 updateCaddy() 푸시는 정적 장비에 대해서는 무해한 no-op입니다(해당 관리 API는 localhost 전용이기 때문입니다).
관련 문서
- Caddy 사용자 지정 도메인 프록시 -- 가장자리 장비 자체: 새 장비 설정, WinSW 서비스, 맵 동기화 작업, 운영상 주의 사항
- 웹사이트 빌더 -- 페이지/섹션/요소 트리, 렌더러, 블로그, SEO, AI 생성(요청이 교회/사이트로 연결된 뒤 렌더링되는 내용)
- Content 엔드포인트 -- 페이지, 블록, 링크, 전역 스타일의 REST 인터페이스(모두
?siteId=를 인식함) - B1App -- 미들웨어와
[sdSlug]라우팅을 호스팅하는 Next.js 앱 - 웹 앱 배포 -- B1App이 Vercel에 배포되는 방식