Dropplets는 데이터베이스가 필요 없는 초경량 마크다운 기반 블로그 플랫폼입니다. 단일 PHP 파일로 구성되어 설치부터 운영까지 30초면 충분합니다. 복잡한 CMS에 지친 개발자나 빠른 문서 공유가 필요한 사용자에게 적합합니다.
왜 Dropplets인가?
기존 워드프레스나 고스트 같은 시스템은 데이터베이스 설정, 플러그인 관리, 보안 업데이트 등 많은 부수 작업이 필요합니다. Dropplets는 이 모든 과정을 생략합니다. 모든 게시물은 .md 파일로 저장되며, 수동으로 파일을 복사하거나 FTP로 업로드하는 방식으로 운영됩니다. 서버 부담이 거의 없고, Git을 통해 버전 관리도 손쉽게 가능합니다.
핵심 특징
- 데이터베이스 불필요: MySQL, SQLite 등이 전혀 필요 없습니다.
- 마크다운 전용:
posts/폴더에.md파일만 넣으면 게시글이 자동 등록됩니다. - 비밀번호 인증: 간단한 비밀번호 해시로 관리자 페이지(
/dashboard)에 접근합니다. - 템플릿 커스터마이징: PHP 기반 템플릿 시스템으로 디자인을 자유롭게 변경할 수 있습니다.
즉시 설치 가이드
아래 단계를 따라하면 1분 안에 블로그를 띄울 수 있습니다.
1. 소스 코드 다운로드
git clone https://gitcode.com/gh_mirrors/dr/dropplets.git
cd dropplets2. 서브모듈 초기화
git submodule update --init --recursive3. 웹 서버에 배포
Apache, Nginx, XAMPP 등 어떤 PHP 지원 서버든 사용 가능합니다. 모든 파일을 public_html 또는 htdocs에 복사하면 됩니다.
4. 초기 설정
브라우저에서 http://yoursite.com/settings로 접속합니다. 아래 정보를 입력하고 "Create Your Blog"를 클릭합니다.
- 사이트 이름
- 사이트 설명
- 관리자 비밀번호 (평문 입력 시 해시로 자동 변환)
게시물 발행 방법
Dropplets의 게시물 발행은 두 가지 방법이 있습니다.
방법 A: 마크다운 파일 직접 생성
posts/ 디렉토리에 .md 파일을 생성합니다. 파일명은 URL 슬러그가 됩니다. 예: hello-world.md
Title: Hello World
Date: 2025-01-21
Tags: dropplets, markdown
# 반갑습니다!
이것은 첫 번째 게시물입니다. **마크다운** 문법이 모두 지원됩니다.방법 B: 대시보드에서 작성
/dashboard 경로로 접속하여 비밀번호를 입력합니다. 웹 기반 에디터에서 제목, 태그, 내용을 입력하고 저장하면 자동으로 .md 파일이 생성됩니다.
템플릿 커스터마이징
템플릿 파일은 templates/ 폴더에 위치합니다. 기본 템플릿을 복사해서 수정하는 것을 권장합니다. 필수 파일은 두 개입니다.
home.php: 게시물 목록 페이지 렌더링post.php: 개별 게시물 상세 페이지 렌더링
템플릿 내에서 사용할 수 있는 주요 변수입니다.
$siteConfig: 사이트 설정 정보(이름, 설명, 도메인 등) 배열$allPosts: 현재 페이지에 해당하는 게시물 목록 배열$post: 현재 보고 있는 게시물의 메타데이터와 내용
환경 설정 파일
프로젝트 루트에 있는 example_config.php를 복사하여 config.php로 만듭니다. 주요 파라미터는 아래와 같습니다.
name: 블로그 제목info: 블로그 설명 (SEO에 사용)domain: 블로그 도메인 (URL 생성 기준)password:password_hash()함수로 생성된 해시값template: 사용할 템플릿 디렉토리명postsPerPage: 페이지당 게시물 표시 개수
운영 시 팁
Dropplets는 완전 정적 사이트에 가깝지만, PHP가 필요합니다. 따라서 정적 사이트 호스팅(GitHub Pages, Netlify 등)에서는 동작하지 않습니다. 저렴한 웹 호스팅(예: 호스팅어, 카페24)이나 클라우드 VM(예: AWS EC2, Vultr)에 설치하는 것이 일반적입니다. 단일 PHP 파일이므로 Nginx + PHP-FPM 조합에서도 아주 가볍게 동작합니다.