Linux에서 cloudflared를 systemd 서비스로 실행하기

Linux에서 cloudflared를 시스템 서비스로 설치하고 실행하는 방법을 알아봐요.

출처: 문서

본문

Linux에서 cloudflared를 시스템 서비스로 설치할 수 있어요.

전제 조건

Linux에서 Cloudflare Tunnel을 서비스로 설치하기 전에 Tunnel CLI 설정 가이드의 1~4단계를 따라요. 이 시점에는 named tunnel과 .cloudflared 디렉터리의 config.yml 파일이 있어야 해요.

1. cloudflared를 서비스로 구성하기

기본적으로 Cloudflare Tunnel은 모든 구성이 $HOME/.cloudflared/config.yml 구성 파일에 존재하길 기대해요. 서비스로 실행하려면 최소한 다음 인자를 지정해야 해요:

2. cloudflared를 서비스로 실행하기

1. cloudflared 서비스를 설치해요.

   cloudflared service install
   

   참고

   Linux에서 cloudflared systemd 서비스를 설치하려면 보통 상승된 권한(elevated privileges)이 필요해요. sudo로 install 명령을 실행하면 $HOME이 /root를 가리키게 되어 /home/<USER>/.cloudflared/config.yml에 만든 구성 파일을 cloudflared가 찾지 못할 수 있어요. 이 경우 구성 경로를 명시적으로 전달할 수 있어요:

   sudo cloudflared --config /home/<USER>/.cloudflared/config.yml service install
   

2. 서비스를 시작해요.

   systemctl start cloudflared
   

3. (선택) 서비스 상태를 확인해요.

   systemctl status cloudflared
   

다음 단계(Next steps)

이제 터널을 통해 트래픽을 라우팅할 수 있어요. IP 경로를 추가하거나 구성을 변경했다면 새 구성을 로드하도록 서비스를 재시작해요:

systemctl restart cloudflared

더 알아보기 (Learn more)

Linux에서는 cloudflared service install로 systemd 서비스를 등록하고 systemctl로 시작·상태·재시작을 관리해요. sudo로 설치할 때는 $HOME이 /root로 바뀌므로 --config 경로를 명시해야 해요.