orthdron/subatic

어떤 프로젝트인가요?

핵심 기능

• 01업로드 파일을 AWS S3, MinIO, Cloudflare R2 같은 S3 호환 버킷에 저장합니다.
• 02별도의 트랜스코더가 업로드한 영상을 HLS 재생용으로 처리합니다.
• 03Docker Compose로 앱, 트랜스코더, PostgreSQL, MinIO를 함께 배포합니다.
• 04SQS를 선택적으로 연동해 S3 버킷 알림을 통해 처리를 시작할 수 있습니다.
• 05환경 변수로 Umami, Plausible, Google Analytics를 활성화할 수 있습니다.

활용 사례

• 자체 서버에서 비공개 또는 커뮤니티 동영상 라이브러리를 호스팅합니다.
• 객체 스토리지와 CDN에서 영상을 직접 제공해 스트리밍 비용을 줄입니다.
• Docker Compose로 배포할 수 있는 소규모 동영상 공유 사이트를 운영합니다.

빠른 시작

1. 1

   docker-compose.yml과 같은 디렉터리에 있는 .env.example을 사용해 .env 파일을 만드세요

2. 2

   .env 파일에 필요한 환경 변수를 추가하세요

3. 3

   Docker Compose로 서비스를 시작하세요

   docker-compose up -d

사용 전 알아둘 점

• !S3 호환 스토리지, PostgreSQL 데이터베이스, 별도의 트랜스코딩 파이프라인이 필요하므로 셀프 호스팅에는 상당한 설정 작업이 필요합니다.
• !아직 자세한 문서는 제공되지 않으며, README에는 곧 공개될 예정이라고 나와 있습니다.
• !GPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 파생 저작물도 동일한 조건으로 오픈소스화해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

subatic은(는) 무엇인가요?

업로드 파일은 S3 호환 스토리지에 저장하고, 트랜스코딩한 영상은 HLS로 스트리밍하는 셀프 호스팅 동영상 공유 플랫폼입니다. Subatic은 직접 호스팅하는 간단한 동영상 공유 사이트입니다. 업로드한 영상은 S3 호환 버킷에 저장되고, 별도의 트랜스코더가 처리한 뒤 공개 버킷이나 도메인에서 재생할 수 있도록 제공합니다.

subatic은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

subatic은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

subatic은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. subatic의 마지막 커밋은 2026년 11월 6일입니다.

subatic은(는) 어디에 사용할 수 있나요?

자체 서버에서 비공개 또는 커뮤니티 동영상 라이브러리를 호스팅합니다. 객체 스토리지와 CDN에서 영상을 직접 제공해 스트리밍 비용을 줄입니다. Docker Compose로 배포할 수 있는 소규모 동영상 공유 사이트를 운영합니다.

subatic는 어떻게 설치하나요?

docker-compose.yml과 같은 디렉터리에 있는 .env.example을 사용해 .env 파일을 만드세요 .env 파일에 필요한 환경 변수를 추가하세요 Docker Compose로 서비스를 시작하세요: docker-compose up -d

subatic은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/orthdron/subatic