SANGE Studio를 Next.js로 이전했습니다: 구성과 출시까지의 3일
2026년 11월 11일부터 13일까지 퇴근 후 매일 3~4시간 정도 작업해 SANGE Studio 웹사이트를 정적 HTML에서 Next.js로 이전했습니다. 기존 URL과 12개 언어의 콘텐츠는 유지하면서, 브라우저 관리 화면에서 초안 저장·미리 보기·발행을 할 수 있게 했습니다. 이번 글에서는 구성과 출시 과정, 각 Cloudflare 서비스의 역할을 소개합니다.
2026년 11월 11일부터 13일까지 퇴근 후 매일 3~4시간 정도 작업해 SANGE Studio 웹사이트를 정적 HTML에서 Next.js로 이전했습니다. 기존 URL과 12개 언어의 콘텐츠는 유지하면서, 브라우저 관리 화면에서 초안 저장·미리 보기·발행을 할 수 있게 했습니다. 이번 글에서는 구성과 출시 과정, 각 Cloudflare 서비스의 역할을 소개합니다.
이전한 이유
기존 사이트는 HTML·CSS·JavaScript와 페이지를 미리 생성하는 Python 스크립트로 구성되어 있었습니다. 앱 소개, 법적 문서, 블로그를 제공할 수 있었지만, 글을 수정할 때 목록과 번역, 사이트맵도 일관되게 유지해야 했습니다. 12개 언어를 다루다 보니 확인할 대상이 많았습니다.
글 데이터와 페이지를 만드는 처리를 분리하고, 블로그 원고를 데이터베이스에서 관리하도록 바꿨습니다. 쓰고, 초안으로 저장하고, 화면을 확인한 다음 발행하는 흐름을 만들고자 했습니다.
Next.js의 역할
Next.js는 React로 웹 애플리케이션을 만드는 프레임워크입니다. 이번에는 공개 페이지와 관리 화면을 구현하는 데 사용했습니다. 서버에서 글 데이터를 읽고 본문이 포함된 HTML을 만들어 돌려주는 방식을 서버 사이드 렌더링, SSR이라고 합니다. 독자는 기존 URL을 그대로 사용하고, 편집자는 개별 HTML 파일 대신 초안과 발행 상태를 관리합니다.
Cloudflare 서비스는 무엇을 담당할까
Cloudflare는 사이트 배포와 보호뿐 아니라 프로그램 실행 환경과 데이터 저장소도 제공합니다. 이번에는 네 가지 서비스를 조합했습니다.
Workers: 프로그램을 실행하는 곳
Cloudflare Workers는 Cloudflare 네트워크에서 코드를 실행합니다. 서버 컴퓨터를 직접 준비하고 운영체제를 관리하는 대신 실행 기반을 서비스에 맡깁니다. 글 조회, 페이지 생성, 관리 화면의 저장 요청 처리를 담당합니다.
D1: 글과 번역을 저장하는 데이터베이스
Cloudflare D1은 정보를 항목별로 저장하고 조건에 따라 조회하는 데이터베이스 서비스입니다. 제목, 본문, 언어, 초안, 발행본, 편집 이력을 저장합니다. 특정 글의 일본어 발행본이나 영어로 공개된 글 목록을 가져올 수 있습니다.
R2: 업로드한 이미지 저장소
Cloudflare R2는 파일을 저장합니다. D1이 글 정보를 보관한다면 R2는 관리 화면에서 올린 이미지 파일을 보관합니다. 기존 이미지와 CSS는 정적 파일로 계속 제공합니다.
Access: 관리 화면 접근 제한
Cloudflare Access는 웹 애플리케이션에 접근할 수 있는 사람을 제한합니다. 공개 글은 로그인 없이 읽지만 편집에는 로그인이 필요합니다. 애플리케이션도 인증 정보와 저장 요청의 정당성을 확인합니다.
전체 구성
그림은 일본어 원본입니다. 독자는 공개 사이트로, 관리자는 Access 인증 후 관리 화면으로 들어갑니다. 두 화면은 Workers를 사용하고, Workers는 D1·R2·정적 파일과 연결됩니다.
글을 열면 Workers가 D1에서 발행된 본문을 읽어 페이지를 반환합니다. 이미지는 R2나 정적 파일에서 제공합니다. Access로 로그인한 뒤 편집한 내용은 Workers를 거쳐 D1에 저장됩니다.
OpenNext는 Next.js 애플리케이션을 Workers에서 실행할 수 있게 빌드합니다. 모든 페이지를 데이터베이스로 옮긴 것은 아닙니다. 앱 소개와 법적 문서는 기존 HTML에서 추출한 데이터로 표시하며 버전 관리 도구인 Git으로 업데이트합니다. 브라우저 편집의 중심은 블로그입니다.
초안과 발행본을 분리하기
관리 화면에서 글 생성, 초안 저장, 미리 보기, 발행, 번역, 이미지 관리를 할 수 있습니다. 초안을 저장해도 독자가 보는 본문은 바뀌지 않고, 확인 후 발행할 때 공개 버전이 전환됩니다.
편집 이력을 보관하며 과거 버전을 새 초안으로 복원할 수 있습니다. 각 언어는 별도의 초안과 발행 상태를 갖습니다. 본문은 HTML과 Markdown을 지원하고, 제목·이미지·표를 읽기 쉽게 보여 주는 서식 보기, 소스 편집, 저장된 원고 미리 보기를 제공합니다.
퇴근 후 매일 3~4시간
작업 기간은 2026년 11월 1113일, 3일입니다. 매일 34시간으로 계산하면 총 9~12시간 정도입니다. 시간을 측정한 기록이 아닌 대략적인 추산입니다. 기존 글·번역·이미지·디자인을 재사용했으므로 사이트 전체를 처음부터 만든 시간은 아닙니다. 단계별 시간은 따로 측정하지 않았습니다.
| 날짜 | 주요 작업 |
|---|---|
| 11월 11일 | 기존 사이트와 다국어 데이터 조사, 구성 설계 |
| 11월 12일 | 공개 페이지와 관리 화면 구현, 로컬 확인 |
| 11월 13일 | 운영 환경 준비, 공개 전환, 관리 화면 분리와 검증 |
출시까지의 8단계
일본어 그림의 작업 순서를 아래에 설명합니다.
1. 기존 사이트 조사
공개 URL 300개, 12개 언어의 404 페이지, 글 7개의 언어별 본문 84개를 확인했습니다. URL·본문·이미지·검색엔진용 정보를 이전 후 검증 기준으로 정리했습니다.
2. 구성과 데이터 설계
D1에는 글과 번역, R2에는 새 이미지, Workers에는 처리 로직을 맡겼습니다. 초안·발행본·이력·언어별 상태를 정의하고 저장과 발행을 구분했습니다.
3. 로컬 환경 준비
Docker Compose로 운영 환경과 분리된 테스트 환경을 만들었습니다. Docker는 프로그램과 필요한 환경을 함께 실행하는 도구입니다. 실제 글을 바꾸지 않고 저장과 업로드를 시험했습니다. Windows에서 개발하고 운영용 빌드는 Linux에서 수행했습니다.
4. 화면과 기능 구현
기존 콘텐츠를 가져와 표시·편집·발행을 구현했습니다. 제목·이미지·표·언어별 페이지를 보존하고, 기존 링크와 북마크를 유지했습니다. 예전 언어 선택 URL에는 리디렉션을 마련했습니다.
5. 테스트와 검증 환경 확인
자동 테스트와 별도 검증 환경에서 저장·발행·번역·이미지·URL·언어·사이트맵을 확인했습니다. 권한 없는 작업을 거부하는지, 초안이 발행본을 바꾸지 않는지도 검사했습니다.
6. 운영 환경 준비
테스트와 분리된 운영용 D1과 R2를 준비하고 기존 글을 가져왔습니다. Access를 설정하고 운영용 빌드에서도 인증을 확인했습니다.
7. 백업 후 단계적으로 공개
데이터를 백업하고 일관성을 확인했습니다. 관리 화면부터 연결해 시험한 뒤 공개 사이트를 새 Worker로 전환했습니다. 되돌릴 수 있도록 이전 배포 구성도 유지했습니다. 이후 관리 화면을 전용 도메인으로 분리했습니다.
8. 실제 URL에서 재확인
공개 후 페이지, 언어별 404, 정규 URL, 사이트맵, 이미지, 데이터베이스 연결과 관리 화면 보호를 확인했습니다. 이후 Node.js와 의존 패키지도 업데이트하고 다시 빌드·검증·배포했습니다. 이때도 공개 URL 300개와 정적 파일 61개의 일치를 확인했습니다.
달라진 점과 앞으로 확인할 점
기존 URL과 다국어 콘텐츠를 유지하면서 브라우저에서 글을 관리하는 기반을 만들었습니다. 초안·번역·이미지·발행본을 한 흐름에서 다룹니다. 검색 순위나 속도 효과는 앞으로 측정해야 합니다. 이전에도 본문을 담은 HTML을 제공했으므로 이번의 구체적인 개선은 편집 방식과 데이터 관리입니다.
실행 기반을 맡겨도 애플리케이션 업데이트, 권한 설정, 백업은 운영자의 일로 남습니다. 실제 글과 번역을 작성하며 편집기를 개선해 나가겠습니다.
2026년 11월 13일의 구성과 이전 기록을 바탕으로 작성했습니다. 서비스 설명에는 Cloudflare 공식 문서를 연결했습니다.
댓글 0
국적이나 거주지를 뜻하지 않습니다. VPN 등에 따라 달라질 수 있습니다.
아직 없습니다.