psviderski/uncloud

어떤 프로젝트인가요?

핵심 기능

• 01Docker 호스트 간에 WireGuard 메시 네트워크를 구성하고 피어를 자동으로 검색합니다.
• 02서비스와 볼륨을 정의할 때 표준 Docker Compose 파일을 사용할 수 있습니다.
• 03DNS 기반 서비스 검색과 로드 밸런싱을 기본 제공합니다.
• 04Caddy를 통해 Let's Encrypt 인증서를 자동 발급해 HTTPS 인그레스를 처리합니다.
• 05무중단 배포를 위한 롤링 업데이트를 지원합니다.
• 06중앙 제어 플레인 없이 실행되므로 단일 장애 지점이 없습니다.

활용 사례

• 클라우드 VM 몇 대나 홈 서버에 자체 웹 앱을 호스팅합니다.
• 여러 리전이나 제공업체에 걸쳐 고가용성 서비스를 운영합니다.
• 머신 간에 볼륨을 관리하며 상태 저장 서비스를 셀프 호스팅합니다.
• Kubernetes를 도입하지 않고 단일 Docker 호스트 구성을 대체합니다.

빠른 시작

1. 1

   Homebrew로 Uncloud CLI를 설치합니다

   brew install psviderski/tap/uncloud
2. 2

   SSH를 통해 첫 번째 머신을 초기화합니다

   uc machine init root@your-server-ip
3. 3

   Docker 이미지를 배포하고 도메인에서 포트 8000을 HTTPS로 공개합니다

   uc run -p app.example.com:8000/https image/my-app
4. 4

   도메인이 서버의 IP 주소를 가리키도록 DNS A 레코드를 만든 다음 DNS 전파를 기다립니다

사용 전 알아둘 점

• !README에 따르면 실패 시 자동 롤백은 아직 지원되지 않습니다.
• !설정하려면 자체 서버에 SSH로 액세스할 수 있어야 하며, 각 서버에 머신 데몬과 Docker가 설치됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

uncloud은(는) 무엇인가요?

Kubernetes나 Swarm 없이 WireGuard 메시를 통해 자체 Docker 호스트 여러 대에 컨테이너 앱을 배포하고 확장합니다. Uncloud는 클라우드 VM, 전용 서버, 베어메탈을 비롯한 여러 Docker 호스트에서 컨테이너 기반 웹 앱을 실행하는 경량 도구입니다. 시스템 간에 WireGuard 메시를 구성해 서로 다른 호스트의 컨테이너에 고유 IP를 할당하고 직접 통신할 수 있게 합니다.

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

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

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

활발히 유지보수 중. uncloud의 마지막 커밋은 2026년 10월 14일입니다.

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

클라우드 VM 몇 대나 홈 서버에 자체 웹 앱을 호스팅합니다. 여러 리전이나 제공업체에 걸쳐 고가용성 서비스를 운영합니다. 머신 간에 볼륨을 관리하며 상태 저장 서비스를 셀프 호스팅합니다. Kubernetes를 도입하지 않고 단일 Docker 호스트 구성을 대체합니다.

uncloud는 어떻게 설치하나요?

Homebrew로 Uncloud CLI를 설치합니다: brew install psviderski/tap/uncloud SSH를 통해 첫 번째 머신을 초기화합니다: uc machine init root@your-server-ip Docker 이미지를 배포하고 도메인에서 포트 8000을 HTTPS로 공개합니다: uc run -p app.example.com:8000/https image/my-app 도메인이 서버의 IP 주소를 가리키도록 DNS A 레코드를 만든 다음 DNS 전파를 기다립니다

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

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