Appwrite: Firebase의 오픈소스 대안

---

들어가며

백엔드 개발은 언제나 시간과 노력이 많이 드는 작업입니다. 인증, 데이터베이스, 파일 스토리지, 서버리스 함수… 이 모든 것을 직접 구축하려면 몇 주, 어쩌면 몇 달이 걸릴 수 있죠. 그래서 많은 개발자들이 Firebase 같은 Backend-as-a-Service(BaaS)를 선택합니다.

하지만 Firebase에는 치명적인 단점이 있습니다. **벤더 종속(Vendor Lock-in)**과 데이터 통제권 상실입니다.

오늘 소개할 Appwrite는 이러한 문제를 해결하면서도 Firebase 못지않은 개발자 경험을 제공하는 오픈소스 백엔드 플랫폼입니다.

---

Appwrite란?

Appwrite는 2019년 Eldad Fux가 시작한 오픈소스 프로젝트로, 웹, 모바일, 네이티브 앱을 위한 완전한 백엔드 솔루션입니다. Docker 마이크로서비스 아키텍처로 설계되어 어디서든 쉽게 배포할 수 있습니다.

“백엔드 인프라는 단순하고, 셀프 호스팅이 가능하며, 프라이버시 중심이어야 한다” — Eldad Fux, Appwrite 창립자

현재 GitHub에서 50,000개 이상의 스타를 받으며, 전 세계 수천 개의 앱에서 사용되고 있습니다.

---

핵심 기능

1. 🔐 Authentication (인증)

다양한 인증 방식을 몇 줄의 코드로 구현할 수 있습니다:

• 이메일/비밀번호
• SMS OTP
• OAuth (Google, GitHub, Apple 등 30+ 제공자)
• 익명 로그인
• Magic URL (비밀번호 없는 로그인)

// 이메일 로그인 예시
import { Client, Account } from 'appwrite';

const client = new Client()
    .setEndpoint('https://cloud.appwrite.io/v1')
    .setProject('your-project-id');

const account = new Account(client);

// 로그인
const session = await account.createEmailPasswordSession(
    'user@example.com',
    'password123'
);

2. 📊 Databases (데이터베이스)

NoSQL 스타일의 문서 데이터베이스를 제공하며, 강력한 쿼리 기능을 갖추고 있습니다:

• 컬렉션 및 문서 기반 구조
• 실시간 데이터 동기화
• 인덱싱 및 고급 쿼리
• 관계형 데이터 지원

// 문서 생성 예시
const databases = new Databases(client);

const document = await databases.createDocument(
    'database-id',
    'collection-id',
    ID.unique(),
    {
        title: '첫 번째 게시물',
        content: 'Appwrite로 만든 첫 게시물입니다!',
        published: true
    }
);

3. 📁 Storage (스토리지)

파일 업로드, 다운로드, 이미지 변환까지 한 번에 처리합니다:

• 고급 압축 및 암호화
• 실시간 이미지 리사이징/크롭
• CDN 통합
• 바이러스 스캔 (선택사항)

// 파일 업로드 예시
const storage = new Storage(client);

const file = await storage.createFile(
    'bucket-id',
    ID.unique(),
    document.getElementById('fileInput').files[0]
);

// 이미지 미리보기 (200x200 썸네일)
const preview = storage.getFilePreview(
    'bucket-id',
    file.$id,
    200, // width
    200  // height
);

4. ⚡ Functions (서버리스 함수)

13개 언어, 30개 이상의 런타임을 지원하는 서버리스 함수:

• Node.js, Python, PHP, Ruby, Go, Dart, .NET 등
• 이벤트 트리거 또는 스케줄 실행
• 격리된 보안 환경

# Python 함수 예시
def main(context):
    context.log('새로운 사용자가 등록되었습니다!')
    
    user = context.req.body
    
    # 환영 이메일 발송 로직
    send_welcome_email(user['email'])
    
    return context.res.json({
        'success': True,
        'message': f'Welcome, {user["name"]}!'
    })

5. 💬 Messaging (메시징)

푸시 알림, 이메일, SMS를 통합 플랫폼에서 관리:

• FCM, APNS 푸시 알림
• SMTP 이메일
• Twilio, Vonage SMS
• 타겟팅 및 스케줄링

6. 🔄 Realtime (실시간)

WebSocket 기반 실시간 이벤트 구독:

// 실시간 문서 변경 감지
client.subscribe('databases.main.collections.posts.documents', (response) => {
    console.log('문서가 변경되었습니다:', response.payload);
});

Firebase와 달리 Appwrite의 실시간 엔진은 인증, 스토리지, 메시징 등 전체 플랫폼에 걸쳐 작동합니다.

---

Firebase vs Appwrite 비교

항목	Firebase	Appwrite
오픈소스	❌	✅
셀프 호스팅	❌	✅
벤더 종속	Google Cloud 종속	없음
데이터 소유권	Google 관리	100% 사용자
가격 예측성	사용량 기반 (예측 어려움)	명확한 티어 + 예산 상한
오프라인 지원	제한적	완전 지원
실시간 범위	데이터베이스만	전체 플랫폼
컴플라이언스	제한적	GDPR, HIPAA 용이

---

2025년 주요 업데이트

🌐 Appwrite Sites

Vercel 스타일의 프론트엔드 배포 서비스가 추가되었습니다. CLI 한 줄로 정적/동적 사이트를 Appwrite 엣지 네트워크에 배포할 수 있습니다.

appwrite deploy site

💰 새로운 가격 정책

좌석당 과금에서 프로젝트당 과금으로 변경되어 팀 규모와 관계없이 예측 가능한 비용을 유지할 수 있습니다.

플랜	가격	포함 사항
Free	무료	5GB 대역폭, 2GB 스토리지, 750K 실행
Pro	$25/월	2TB 대역폭, 대폭 증가된 한도
Enterprise	맞춤	전용 지원, 고급 보안

🤖 AI 통합

MCP(Model Context Protocol) 서버를 통해 Claude Desktop, Cursor 같은 AI 도구에서 직접 Appwrite 프로젝트를 관리할 수 있습니다.

---

셀프 호스팅: 5분 만에 시작하기

요구 사항

• Docker 설치됨
• 최소 1 CPU, 2GB RAM

설치

docker run -it --rm \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
  --entrypoint="install" \
  appwrite/appwrite:1.8.0

설치 프로그램이 대화형으로 설정을 안내합니다. 완료 후 http://localhost에서 Appwrite 콘솔에 접속할 수 있습니다.

Docker Compose 수동 설치

더 세밀한 제어가 필요하다면 Docker Compose를 직접 사용할 수 있습니다:

mkdir appwrite && cd appwrite

# 공식 파일 다운로드
curl -o docker-compose.yml https://raw.githubusercontent.com/appwrite/appwrite/master/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/appwrite/appwrite/master/.env

# 환경 변수 편집
nano .env

# 실행
docker compose up -d

---

SDK 지원

Appwrite는 거의 모든 플랫폼을 지원합니다:

클라이언트 SDK

• Web: JavaScript, TypeScript
• Mobile: Flutter, Swift, Kotlin, React Native
• Desktop: Electron

서버 SDK

• Node.js
• Python
• PHP
• Ruby
• Deno
• Go
• .NET
• Dart

// Flutter 예시
import 'package:appwrite/appwrite.dart';

final client = Client()
    .setEndpoint('https://cloud.appwrite.io/v1')
    .setProject('your-project-id');

final account = Account(client);

// 현재 사용자 정보
final user = await account.get();
print('Hello, ${user.name}!');

---

실제 사용 사례

1. 스타트업 MVP

빠르게 프로토타입을 만들고 검증한 뒤, 그대로 프로덕션으로 확장

2. 엔터프라이즈 내부 도구

GDPR/HIPAA 컴플라이언스가 필요한 내부 시스템

3. SaaS 제품

멀티테넌트 앱을 위한 확장 가능한 백엔드

4. 모바일 앱

Flutter나 React Native로 크로스플랫폼 앱 구축

5. IoT 프로젝트

실시간 데이터 수집 및 처리

---

커뮤니티와 생태계

Appwrite의 가장 큰 강점 중 하나는 활발한 커뮤니티입니다:

• Discord: 10,000+ 멤버의 활발한 커뮤니티
• GitHub: 지속적인 기여와 빠른 이슈 대응
• Hacktoberfest: 매년 수백 명의 기여자 참여
• YouTube: 공식 튜토리얼과 라이브 스트림

---

마치며

Appwrite는 단순히 “Firebase의 오픈소스 대안”을 넘어, 개발자 경험과 데이터 주권을 모두 잡은 현대적인 백엔드 플랫폼입니다.

특히 다음과 같은 경우 Appwrite를 강력히 추천합니다:

✅ 데이터를 직접 통제하고 싶을 때
✅ 벤더 종속에서 벗어나고 싶을 때
✅ 예측 가능한 비용이 필요할 때
✅ GDPR/HIPAA 컴플라이언스가 필요할 때
✅ 오픈소스 생태계를 선호할 때

시작하기 어렵지 않습니다. 오늘 바로 Appwrite Cloud에서 무료로 시작하거나, Docker 한 줄로 셀프 호스팅을 경험해 보세요!

---

참고 자료

• 🔗 공식 사이트: appwrite.io
• 📚 문서: appwrite.io/docs
• 💻 GitHub: github.com/appwrite/appwrite
• 💬 Discord: appwrite.io/discord
• 📺 YouTube: youtube.com/@appwrite

---