셀프 호스팅 문서
Enclave 전체를 내 머신에서 돌리기: 서비스 2개, SQLite 파일 1개, 외부 의존성 제로. 아키텍처부터 공개까지, 백업부터 직접 데스크톱 설치 파일 만들기까지 — 운영자에게 필요한 모든 것이 여기에 있습니다. 일상적인 사용 질문은 도움말 센터로.
배포
셀프 호스팅 Enclave는 단 두 개의 서비스입니다: 정적 프런트엔드(메인 앱) + Core API(NestJS), 데이터는 SQLite 파일 하나 — Postgres, Redis, 메시지 큐 같은 외부 의존성이 없습니다. 각 부분이 무엇인지, 데이터가 어디에 있는지, 운영 진입점이 어디인지 설명합니다.
저장소 클론 → .env 복사 후 작성 → docker compose up -d. 세 단계로 메인 앱과 Core API가 함께 올라옵니다. 헬스 체크 내장, 데이터는 호스트의 ./data 디렉터리에 저장. 이것이 권장 셀프 호스팅 경로입니다.
Node.js 20+와 nginx면 충분합니다: 백엔드는 npm ci + build 후 node나 pm2로 상주시키고, 프런트엔드는 정적 파일로 빌드해 nginx에 넘깁니다. 저장소에 포함된 nginx 설정 템플릿은 플레이스홀더 두 개만 바꾸면 바로 쓸 수 있습니다.
인증서를 갖춘 nginx 한 대로 공개 도메인을 메인 앱에 리버스 프록시하면 공개 완료. 자주 틀리는 세 가지: WebSocket에는 Upgrade 헤더 필수, CORS와 공개 주소 env 두 개 수정, X-Admin-Secret 헤더는 명시적으로 통과시키기.
운영
api/.env는 네 그룹으로 이해하세요: LLM 게이트웨이 3종 세트, 서버 시크릿 3개, 네트워크와 경로, 선택적 미디어와 메일. 알아둘 역사적 명명 하나: DEEPSEEK_API_KEY는 사실 범용 게이트웨이 키로, OpenAI 호환 게이트웨이라면 무엇이든 여기에 넣습니다.
데이터의 본체는 ./data 디렉터리 안의 SQLite 파일 하나와 미디어 디렉터리입니다: 백업 = 복사, 이전 = 새 머신으로 복사, 업그레이드 = git pull 후 컨테이너 재빌드. 엄밀한 백업은 sqlite3의 .backup 명령으로 하고, 메이저 업그레이드 전에는 꼭 한 번 백업하세요.
Enclave는 당신의 AI 키를 보관하지 않습니다: 셀프 호스팅의 클라우드 비용은 사실상 0이며, 모델 비용은 선택한 게이트웨이에 직접 지불합니다. 어떤 OpenAI 호환 게이트웨이든 env 세 줄로 연결되고, 게이트웨이를 바꿔도 채팅 기록과 관계는 전혀 잃지 않습니다.