irum운영자 가이드
문서함 소유자는 블로그와 연결 권한을 관리하고, 배포 운영자는 서버·데이터·백업을 관리합니다. 상세 설정과 검증 화면은 저장소 운영 문서를 참고하세요.
오프라인 Docker 설치
인터넷이 연결된 환경에서 릴리즈 파일을 내려받아 오프라인 서버로 옮깁니다. Linux amd64 Docker 엔진이 필요합니다.
docker load -i irum-blog-v1.0.2.tar.gz
docker volume create irum-blog-data
docker run -d --name irum-blog --restart unless-stopped \
-p 8080:8080 -v irum-blog-data:/data \
-e PUBLIC_ORIGIN=http://localhost:8080 \
irum-blog:v1.0.2브라우저에서 http://localhost:8080을 엽니다. 다른 기기에서 접근할 때는 PUBLIC_ORIGIN을 실제 접근 주소로 설정하세요. 운영 환경은 HTTPS 역방향 프록시를 권장합니다. 필요한 웹 자산과 내장 DB가 이미지에 포함되며 시작할 때 패키지를 다운로드하지 않습니다.
계정과 공개 범위
초기 계정을 만든 후 회원가입을 닫으려면 ENABLE_REGISTRATION=false로 재시작합니다. 문서함별 권한을 최소로 부여하고 발행 권한과 연결별 자동 발행은 분리해서 관리하세요. API 키와 OAuth 연결은 설정에서 철회할 수 있습니다.
백업과 복원
내장 DB는 반드시 컨테이너를 정지한 뒤 /data 볼륨 전체를 보관하세요. DB, 첨부, 서명용 비밀키를 함께 보존해야 합니다. 복원은 새 볼륨에서 먼저 검증하고 기존 데이터에 덮어쓰지 마세요. 외부 PostgreSQL은 pg_dump 및 R2 백업을 따로 관리합니다.
Cloudflare 운영
Pages는 웹과 API, 별도 Worker는 예약 발행을 처리합니다. PostgreSQL은 Hyperdrive로 연결하고 첨부와 발행본은 비공개 R2에 보관합니다. 두 배포에 동일한 연결과 HMAC 비밀키가 필요합니다. DB 마이그레이션은 관리자 연결에서 실행하고, 서비스는 공유 연결 풀에서 블로그 전용 역할로 전환해 접근합니다.
SEO·AEO 점검
공개 문서에는 서버에서 생성한 본문·제목·설명·canonical·공유 이미지와 구조화 데이터가 포함됩니다. 사이트맵은 /sitemap.xml, 블로그 RSS는 /b/블로그주소/rss.xml입니다. 사적인 작업실은 검색 색인을 허용하지 않습니다. 실제 제목과 내용을 정확히 쓰고, 요약과 출처·작성 주체를 명확하게 제공하세요. 구조화 데이터만으로 검색 노출이나 AI 인용이 보장되지는 않습니다.
장애 확인과 업데이트
/health 응답과 컨테이너 상태, 서버 로그를 확인합니다. 예약 발행은 Worker 실행 로그와 운영 화면의 실패 목록을 확인합니다. 업데이트 전에 정지 백업을 만들고 새 버전 이미지를 불러온 뒤 기존 볼륨을 연결하세요. DB 변경이 있는 버전을 되돌릴 때는 이전 이미지와 해당 버전의 백업을 새 볼륨에 복원합니다.