Twake Drive – Google Drive의 오픈소스 대안

1 week ago 5

프로젝트 개요

Twake Drive는 Linagora가 개발한 Google Drive의 오픈소스 대체 솔루션으로, 파일 저장·공유·협업 기능을 자체 서버에서 운영할 수 있는 형태로 제공
- 클라우드 서비스 종속을 피하고, 데이터 소유권과 보안 통제를 유지하려는 조직을 주요 대상으로 함
GitHub에서 공개된 저장소는 1,000개 이상의 스타와 70여 개의 포크를 기록하며 활발히 유지보수 중
프로젝트는 AGPL-3.0 라이선스를 채택해, 소스코드 수정 및 재배포 시 동일한 라이선스 조건을 유지해야 함

Twake Drive는 Node.js(18.x 이상) , MongoDB, Yarn을 기반으로 동작하며, 프런트엔드와 백엔드가 분리된 구조로 설계
- 프런트엔드는 tdrive/frontend/ 디렉터리에서 yarn dev:start로 실행
- 백엔드는 tdrive/backend/node/에서 환경 변수를 설정 후 yarn dev로 구동
Docker Compose를 이용한 간단한 배포 옵션(docker-compose.minimal.yml)을 제공해, 로컬 테스트 및 내부 배포가 용이
- http://localhost/에서 웹 인터페이스 접근 가능
MongoDB 컨테이너 실행 명령(docker run -p 27017:27017 -d mongo)을 통해 데이터베이스를 손쉽게 구동
환경 설정은 tdrive/backend/node/config/development.json 파일을 통해 세부 조정 가능

Twake Drive는 프런트엔드(React 기반) 와 백엔드(Node.js 기반) 가 분리되어 있으며, 로컬 파일 저장소 경로를 직접 지정 가능
- STORAGE_LOCAL_PATH 환경 변수를 통해 문서 저장 위치를 설정
PUBSUB_TYPE=local 설정으로 로컬 환경에서의 퍼블리시·구독 기능을 지원
애플리케이션은 기본적으로 3000번 포트에서 실행되며, 개발 및 테스트 환경에 최적화된 구조를 가짐
Docker Bake 설정 파일(docker-bake.hcl)과 CI/CD용 GitHub Actions 구성이 포함되어 있어 자동화된 빌드 및 테스트 지원

저장소는 882개의 커밋, 61개의 브랜치, 46개의 태그로 구성되어 있으며, 활발한 개발 이력 유지
주요 언어 비중은 TypeScript 58.9% , JavaScript 32.6% , SCSS 3.7% , CSS 2.2% , HTML 1.3% , Less 1.0%
최근 커밋(Oct 15, 2025)에서는 마이그레이션 스크립트 수정 및 버그 수정이 포함
Documentation 폴더에는 편집 세션 키(editing_session_key) 등 세부 기술 문서가 포함되어 있음

프로젝트는 CODE_OF_CONDUCT.md와 CONTRIBUTING.md를 통해 기여자 행동 강령과 참여 절차를 명시
- Pull Request, Issue 등록, 코드 리뷰 절차가 GitHub 표준 워크플로에 따라 운영
Security Policy 문서를 통해 보안 취약점 보고 절차를 안내
Telegram 채널과 공식 웹사이트를 통해 커뮤니티 피드백 및 로드맵 공유