🔑 어드민 최초 진입 및 환경설정 시작하기

본 문서는 블로그 시스템을 제어하기 위해 관리자가 어드민 페이지에 안전하게 접근하고, 로그인 세션을 유지하며, 화면 상의 각종 문구(다국어 사전)를 손쉽게 조작하는 방법을 안내합니다.

---

🔒 1. 어드민 로그인 전 IP 보안 통제 정책

이 블로그 엔진은 외부 해킹 시도나 포스팅 등록 권한 탈취를 완벽하게 방지하기 위해 접속 IP 필터링 보안 정책을 고수하고 있습니다. 배포 시점에 감지된 관리자의 공인 IP 주소만이 허용 목록(ALLOWED_IP)으로 클라우드 서버에 등록되어 접근을 허용합니다.

[!IMPORTANT]

🛡️ 안전지대 중심의 운영 원칙 (공공장소 사용 금지)

본 블로그의 어드민 관리는 반드시 집이나 신뢰할 수 있는 개인 사무실 등 물리적·네트워크 보안이 확보된 장소에서만 수행하셔야 합니다.
불특정 다수가 이용하고 해킹 위험에 직접 노출된 PC방, 도서관, 공공 와이파이 환경 등 공공장소에서는 보안 유출 방지를 위해 어드민 접속 자체를 절대 권장하지 않으며 지양해 주시기 바랍니다.

만약 사용 중인 안전한 장소 내에서 공유기 재부팅이나 인터넷 회선 사정으로 공인 IP 주소가 바뀌어 403 Forbidden 차단 화면을 만나게 된다면, 아래의 절차에 따라 허용 목록을 수동 갱신해 주어야 합니다.

⚙️ 허용 IP 주소 갱신 절차 (재배포 필요)

1. 변경된 인터넷 환경에서 터미널을 열고, 블로그 서비스 어드민을 다시 한 번 **재배포(Redeploy)**하는 명령을 실행해야 합니다.
2. 작업 과정 안내: 데이터베이스 내부를 직접 편집하여 IP를 강제로 기입하는 극단적인 작동 방식보다는 안전하지만, 재배포 명령어가 가동되면서 매번 빌드 프로세스와 파일 업로드 대기 시간이 수 분간 소요되므로 실질적으로 꽤나 번거롭고 불편함이 수반되는 과정입니다.
3. 배포 스크립트가 실행되는 동안 현재 연결된 컴퓨터의 새 공인 IP 주소를 탐지하여 원격 서버의 허용 IP 목록을 최신으로 교체합니다.
4. 배포 처리가 최종 마무리된 후에 어드민 주소로 재접속하면 정상적으로 로그인 화면이 다시 활성화됩니다.
5. 어드민 페이지만 재배포 하시면 됩니다.

---

🔑 2. 관리자 로그인 및 세션 관리

로그인 차단이 정상 해제되면, 최초 구축 시 설정했던 관리자 마스터 비밀번호(ADMIN_PASSWORD)를 입력하여 접속합니다.

• 보안 세션 유지: 브라우저의 전용 보안 쿠키 설정을 활용하여 30일 동안 어드민 로그인 세션이 안전하게 유지됩니다.
• 공공 컴퓨터 및 위험 지역 접근 금지:
  보안이 입증되지 않은 PC방이나 공용 기기 환경에서는 어드민 로그인 자체를 시도하지 않는 것이 가장 확실한 보안법입니다. 만약 피치 못할 사정으로 공공 환경에서 로그인했다면, 작업을 마친 직후 반드시 어드민 하단의 [로그아웃] 단추를 누르고, 추가로 터미널에 npx wrangler logout을 입력하여 로컬 컴퓨터에 기록된 클라우드플레어 관리 계정 정보까지 확실하게 연동 해제(로그아웃)해 주셔야 유출 사고를 방지할 수 있습니다.

[!WARNING]

🔒 어드민 접속 주소(도메인) 노출 최소화 권장

어드민은 허용 IP 목록을 통해 이중으로 안전하게 보호되고 있으나, 악성 공격의 표적이 되는 공격 표면(Attack Surface) 자체를 줄이는 것이 가장 확실한 보안법입니다.

따라서 admin.myblog.com과 같이 알기 쉬운 커스텀 주소를 굳이 연결하지 마시고, Cloudflare Pages에서 기본으로 제공하는 무작위의 서브도메인 주소(예: [프로젝트명].pages.dev)를 그대로 사용하여 어드민의 접속 경로를 비밀스럽게 숨겨두실 것을 강력히 권장합니다.

---

🌐 3. 다국어 사전(i18n) 설정 가이드

포스트 본문 외에 사이트 화면에 고정되어 있는 공통 문구(메뉴 명칭, 댓글 달기 버튼, 로그인 메시지 등)는 소스코드를 한 줄도 수정하지 않고도 사전 기능을 통해 한국어/영어/일본어 등으로 즉시 고쳐 쓸 수 있습니다.

새로운 지원 언어는 새 언어 추가 기능을 통해 등록할 수 있습니다. 단, 새로 추가한 언어가 화면에 올바르게 표시되려면 기존 사전에 등록된 모든 번역 키(Key)에 대해 해당 언어의 번역본을 빠짐없이 입력해 주어야 합니다.

1. 어드민 좌측 메뉴에서 언어 설정 메뉴로 이동합니다.
2. 현재 사이트 전역에 사용되는 각종 번역 사전 키와 저장된 문구 리스트가 하단의 UI 다국어 사전 편집기 구역에 제공됩니다.
3. 번역을 수정하고 싶은 키의 입력란에 원하는 문구(한국어, 영어, 일본어)를 작성하고, 해당 행 오른쪽 끝에 있는 저장 아이콘을 클릭합니다.
4. 저장과 동시에 사이트에 바로 적용되며, 방문자가 블로그에서 언어를 스위칭할 때 실시간으로 변경된 문구로 매끄럽게 번역되어 표시됩니다.