Decap CMS
정적 파일로 만든 사이트에 개발자가 아닌 사람도 쓸 수 있는 편집 화면을 얹는 Git 기반 CMS
Decap CMS는 정적 사이트 생성기로 만든 사이트를 위한 오픈소스 콘텐츠 편집기입니다. 자기 사이트의 관리자 경로에 얹는 단일 페이지 앱으로, 편집자를 로그인시키고 YAML 파일로 정의한 폼을 보여준 뒤, 그 변경을 커밋으로 만들어 Git 저장소에 되돌려 씁니다. 데이터베이스도, 별도의 콘텐츠 서버도 없습니다. 저장소 자체가 콘텐츠입니다. 라이선스는 MIT이고, 2023년 2월에 Netlify CMS에서 이름을 바꿨으며, 2026년 9월 기준 GitHub 별은 19,351개였습니다.
Decap CMS는 실제로 무엇인가
Decap CMS(github.com/decaporg/decap-cms)는 좁지만 분명한 문제를 잘 풉니다. 사이트는 저장소 안의 Markdown 파일 뭉치인데, 문장 하나를 고치고 싶은 사람은 Git을 쓰지 않는다는 문제입니다. 설치 위치는 이미 있는 사이트의 관리자 경로입니다. 간단한 방식은 프로젝트 자신의 설명대로 HTML 파일 하나와 설정 파일 하나이고, CMS 본체는 CDN에서 불러옵니다. 본격적인 설치는 npm을 거치며 손댈 여지가 더 넓습니다. YAML이 콘텐츠 모델을 선언하고, 편집기가 거기서 폼을 만들며, 저장할 때마다 커밋이 하나 생깁니다.
편집 화면은 위젯으로 조립되고, 그 종류는 대부분의 사이트에 충분합니다. Markdown과 리치 텍스트, 이미지와 파일, 날짜, 숫자, 불리언, 셀렉트, 리스트와 중첩 객체, 그리고 한 항목이 다른 항목을 가리키게 하는 관계 위젯까지 있습니다. 로그인은 당연히 주어지는 게 아니라 끼워 넣는 방식이라, 저장소에는 GitHub, GitLab, Bitbucket, Azure, Gitea, Forgejo용 백엔드와 호스팅형 Git 게이트웨이, 그리고 로컬 편집용 프록시가 함께 들어 있습니다. 미디어는 저장소에 두어도 되고 Cloudinary나 Uploadcare로 보내도 됩니다. 라이선스는 MIT이며, 사용자 관리를 한곳에 모으거나 더 세밀한 역할, 데이터베이스 프록시, 지원이 붙은 도입이 필요한 팀을 위한 Decap Turbo라는 유료 등급이 있습니다.
한 시간의 혼란을 덜어 줄 이름 이야기 하나. 이것은 2023년 2월까지 Netlify CMS였고, README에도 그렇게 적혀 있습니다. 검색해서 나오는 튜토리얼 상당수는 아직 옛 이름과 옛 패키지를 쓰고 있으며, 설정은 그 글들이 쓰인 뒤로 달라졌습니다.
당신이 하는 맞교환
- 콘텐츠가 이력까지 붙은 평범한 파일로 내 저장소에 남는다 — 언젠가 떠나더라도 내보낼 것이 없다.
- 저장이 곧 커밋이라, 게시에 걸리는 시간은 빌드와 배포 파이프라인이 걸리는 시간 그대로다.
- 운영할 데이터베이스는 없지만, 인증 백엔드는 여전히 세워야 한다.
- 편집자에게 주어지는 것은 폼이지 캔버스가 아니다. 레이아웃은 코드에 남으며, 누군가 새로운 종류의 섹션을 원하기 전까지는 장점이다.
저장할 때마다 커밋이 되는 방식이 설계의 전부이고, 이것은 양쪽으로 작용합니다. 콘텐츠는 기본적으로 버전 관리되고, 원한다면 풀 리퀘스트로 검토할 수도 있습니다. 문구 수정이 코드 변경과 같은 절차를 타는 셈인데, 홈페이지를 누가 고쳤는지 아무도 모르는 팀에서는 확실히 드물고 값진 성질입니다. 값은 지연입니다. 오타 하나 고치는 것이 빌드 한 번이라, 빌드가 4분 걸리면 오타 수정도 4분 걸립니다. 주 단위로 게시하는 사이트라면 상관없는 이야기입니다. 한 시간마다 게시하는 사이트라면 잘못 고른 도구이고, 뒤에 데이터베이스가 있는 쪽이 맞습니다.
혼자 두고 판단하기보다 이웃과 나란히 놓으면 이해가 빠릅니다. Payload는 같은 축의 반대편으로, 자체 데이터베이스를 가진 완전한 프레임워크입니다. 콘텐츠가 사실상 애플리케이션이라면 그쪽이 필요합니다. Ghost는 저장소 위에 얹는 한 겹이 아니라 완성된 퍼블리싱 제품입니다. Decap은 셋 중 가장 얇고, 얇다는 것이 바로 요점입니다. 이미 돌아가는 사이트에 편집 화면만 더할 뿐, 그 밖의 무엇도 넘겨받지 않습니다.
공개한 뒤 그 페이지를 누가 고치는가
우리는 Decap을 직접 운영하지 않으므로, 이 페이지는 운영에 대해 아무것도 주장하지 않습니다. 일차 경험으로 말할 수 있는 것은 이 도구가 답하려는 질문 쪽입니다. 우리가 그 질문에 반대편에서 도달했기 때문입니다. 우리는 고객을 위한 랜딩 페이지를 게시하는데, 그 편집 인터페이스는 대화입니다. 고객이 변경을 요청하면 에이전트가 그것을 합니다. 한 고객은 한 자리에서 같은 페이지를 세 번 고쳤는데, 인상적이었던 건 시간이 어디로 갔는가였습니다. 편집기에는 시간이 전혀 들지 않았습니다. 전부 페이지에 무엇을 쓸지 정하는 데 들어갔습니다.
그래서 이 층은 지루하게 두는 편이 낫습니다. 무엇을 고르든 일주일쯤 지나면 병목은 문장으로 옮겨 가니, 유지 비용이 가장 적은 쪽을 고르고 아낀 몫을 글에 쓰세요. 그럼에도 작은 사이트라면 더 무거운 도구보다 Git 기반 편집기를 먼저 권하는 이유는, 비싸게 배운 두 번째 교훈에 있습니다. 정적 사이트 생성기가 내놓는 것은 완성된 HTML이고, 덕분에 우리 자신의 동적 렌더링 페이지에서 몇 달치 색인을 잃게 만든 실패 — 크롤러가 페이지 대신 껍데기를 받는 일 — 을 구조적으로 피합니다. Markdown을 커밋하고 정적 사이트를 다시 만드는 구성은 애초에 그 실수를 저지를 수 없습니다.
그리고 게시는 도구의 도움이 끝나는 지점이기도 합니다. 누군가 편집할 수 있는 사이트가 곧 누군가 읽은 사이트는 아니며, 그다음의 일 — 발견되고, 선택되고, 후속 연락을 받는 일 — 은 페이지를 띄운 일과는 다른 기술입니다. AgentCeres — AI Growth Officer(agentceres.com)가 겨냥하는 자리가 바로 그 틈입니다. 운영까지 맡는 AI 마케팅 팀이 작업을 초안으로 만들고, 밖으로 나가는 것은 사람의 승인을 기다립니다. 아직 바탕을 고르는 중이라면 AstroWind는 편집기가 아니라 출발용 템플릿이고, Webstudio는 같은 질문에 대한 비주얼 빌더 쪽 답입니다.
FAQ
- Decap CMS란 무엇인가요?
- Decap CMS는 정적 사이트 생성기로 만든 사이트를 위한 오픈소스 Git 기반 콘텐츠 관리 시스템입니다. 자기 사이트의 관리자 경로에 추가하면 YAML 설정으로 정의된 편집 폼을 보여주고, 저장할 때마다 저장소에 커밋합니다. 2023년 2월까지는 Netlify CMS라는 이름이었고, JavaScript로 작성되었으며, 라이선스는 MIT, 2026년 9월 기준 GitHub 별은 19,351개였습니다.
- Decap CMS는 무료인가요?
- 소프트웨어 자체는 무료이고 MIT 라이선스이며, 자기 사이트의 일부로 직접 호스팅하므로 편집기 자체에 낼 돈은 없습니다. 사용자 관리를 한곳에 모으거나 더 세밀한 역할, 데이터베이스 프록시, 지원이 붙은 도입이 필요한 팀을 위해 Decap Turbo라는 유료 등급도 있습니다. 다만 무료 경로에도 자기 인프라는 전제됩니다. 인증 상대가 되는 저장소 백엔드, 그리고 커밋마다 사이트를 빌드하고 배포하는 무언가가 필요합니다.
- Decap CMS에 서버나 데이터베이스가 필요한가요?
- 데이터베이스는 필요 없고, 그게 핵심 발상입니다. 콘텐츠가 어딘가의 행이 아니라 Git 저장소 안의 파일이니까요. 대신 편집자가 로그인하고 브라우저가 그 저장소에 쓸 수 있는 통로는 필요하며, 백엔드가 바로 그 역할입니다. GitHub, GitLab, Bitbucket, Azure, Gitea, Forgejo가 직접 지원되고, 호스팅형 Git 게이트웨이와 개발용 로컬 프록시도 함께 제공됩니다. 전통적인 CMS보다 훨씬 적은 인프라지만, 아예 없는 것은 아닙니다.
- Decap CMS가 맞지 않는 경우는 언제인가요?
- 편집자가 자신뿐이고 사이트가 한 페이지라면 불필요한 부담입니다. 파일을 고치세요. 콘텐츠가 사실상 관계와 권한과 조회를 갖춘 애플리케이션이라면 데이터베이스 기반 시스템이 더 맞습니다. 그리고 하루에 여러 번 게시한다면, 커밋하고 다시 만드는 주기가 작은 수정 하나하나를 배포로 바꿔 놓습니다. 가장 잘 맞는 자리는 중간입니다. 정적 사이트이고, 페이지가 몇 개보다는 많고, 코드 편집기를 열지 않고도 문구를 바꿀 수 있어야 하는 사람이 최소 한 명 있는 경우입니다.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.