소개
cloudflared는 Cloudflare에서 공식 제공하는 Cloudflare Tunnel의 커맨드라인 클라이언트입니다. 공개 IP 없이도 내부에 있는 웹 서버, SSH, RDP 등 다양한 오리진을 Cloudflare 네트워크에 안전하게 연결해 주는 터널 데몬으로, 트래픽은 외부 IP로 나가지 않고 cloudflared가 Cloudflare 측으로 아웃바운드 연결을 생성해 방화벽을 닫아 둔 상태로도 서비스를 노출할 수 있게 합니다.
상세정보
아웃바운드 전용 터널(역방향 프록시)
cloudflared는 오리진에서 외부 IP로 트래픽을 보내는 대신, Cloudflare 네트워크 방향으로만 아웃바운드 HTTPS 연결을 만들어 터널을 구성합니다. 이 구조 덕분에 오리진은 공개 IP 없이도 트래픽을 수신할 수 있고, Cloudflare가 우회 공격 등으로부터 오리진을 보호합니다.
다양한 프로토콜 지원
HTTP/HTTPS 웹서버에 대한 프록시 외에도, SSH, RDP 등 L4(레이어 4) TCP 트래픽도 터널을 통해 안전하게 전달할 수 있습니다. HTTP/웹소켓 기반 오리진은 cloudflared tunnel 명령으로, L4 오리진 접근은 cloudflared access 명령으로 관리합니다.
제로 트러스트 네트워크 액세스(ZTNA)
Cloudflare Zero Trust와 연동되어 인증된 사용자/디바이스만 터널 뒤의 오리진에 접근하도록 허용할 수 있습니다. WARP 클라이언트를 함께 사용하면 클라이언트 측에서 cloudflared access 명령 없이도 사설 오리진에 접속할 수 있습니다.
Quick Tunnels(임시 미리보기)
Cloudflare 계정과 도메인 없이도 한 줄의 명령으로 로컬 개발 환경을 trycloudflare.com 기반의 공개 미리보기 URL로 노출할 수 있습니다. 자동 HTTPS, DDoS 보호, 노출 포트 없음이 기본 제공되며, 디자인 리뷰, CI/CD 연동, 임시 협업 등 빠르게 링크를 공유해야 하는 상황에 적합합니다.
유연한 배포 형태
독립 실행 바이너리, Debian/RPM 패키지, Homebrew, Docker 이미지, MSI 설치 패키지 등 다양한 배포 형태가 제공되며, 소스에서 직접 빌드할 수도 있습니다.
Windows에 설치
GitHub 릴리스 페이지에서 최신 Windows 빌드를 다운로드할 수 있으며, 32비트/64비트용 실행 파일과 MSI 설치 패키지 두 종류가 제공됩니다. 설치 후 PowerShell에서 다운로드 폴더로 이동해 .cloudflared.exe --version을 실행하면 버전이 정상적으로 출력되는지 확인할 수 있습니다. winget 사용 환경이라면 winget install --id Cloudflare.cloudflared --exact 명령으로 설치할 수도 있습니다.
macOS·Linux·Docker에 설치
macOS에서는 Homebrew 또는 Darwin amd64 바이너리를 사용하고, Linux에서는 Cloudflare 패키지 리포지토리를 통한 설치 또는 Debian/RPM 패키지, Docker 이미지를 사용할 수 있습니다. 소스에서 빌드하려면 Go 1.26 이상과 GNU Make, capnp가 필요하며 make cloudflared로 빌드합니다.
터널 생성과 트래픽 라우팅
영구 터널을 만들려면 먼저 Cloudflare 대시보드에서 웹사이트를 추가하고 네임서버를 Cloudflare로 변경한 뒤, cloudflared를 Cloudflare 계정에 인증해야 합니다. 이후 터널을 생성하고 Cloudflare의 공개 DNS 레코드, Cloudflare Load Balancer의 퍼블릭 호스트명, 또는 WARP 클라이언트의 사설 트래픽 경로를 통해 트래픽을 터널로 라우팅합니다.
Quick Tunnel 한 줄 실행
계정 없이도 cloudflared tunnel --url http://localhost:8000 명령 하나로 로컬 웹서버를 즉시 trycloudflare.com 미리보기 URL로 노출할 수 있습니다. Cloudflare가 인증서, 라우팅, DDoS 보호를 자동으로 처리해 주므로 별도의 설정 파일 없이도 동작합니다.
cloudflared는 무료인가요?
네. cloudflared는 Apache-2.0 라이선스의 오픈소스 프로젝트이며, 소스 코드는 GitHub 저장소에 공개되어 있습니다.
계정 없이도 사용할 수 있나요?
Quick Tunnels는 Cloudflare 계정이나 도메인 설정 없이도 사용할 수 있습니다. 영구 터널을 만들어 DNS/Load Balancer/WARP와 연동하려면 Cloudflare 대시보드에서 웹사이트를 추가하고 인증해야 합니다.
지원되는 운영체제와 배포 형태는 무엇인가요?
Windows(32/64비트 실행 파일 및 MSI), macOS(Homebrew/Darwin 바이너리), Linux(Debian/RPM/패키지 리포지토리), Docker 이미지가 제공되며, 소스에서 빌드해 설치할 수도 있습니다.
SSH나 RDP 같은 비HTTP 트래픽도 터널링할 수 있나요?
가능합니다. L4 TCP 트래픽은 cloudflared access 명령으로, WARP 클라이언트를 사용하는 경우에는 별도의 cloudflared access 명령 없이도 사설 오리진에 접속할 수 있습니다.
시스템 요구사항
운영체제: Windows 10 이상, macOS, Linux(amd64/arm64/386) 및 Docker 이미지 지원. 설치 형태: Windows 실행 파일(.exe) 및 MSI(Linux/Mac은 Homebrew, Debian, RPM, 패키지 매니저, Docker, 소스 빌드 제공). 런타임: 소스에서 빌드 시 Go 1.26 이상, GNU Make, capnp 필요(개발 시 capnpc-go, goimports, golangci-lint, gomocks 등 선택). 계정: 영구 터널을 사용하려면 Cloudflare 계정과 도메인(또는 private routing) 설정이 필요하며, Quick Tunnels는 계정 없이 사용할 수 있습니다.