macOS에서 cloudflared를 launch agent로 실행하기

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

출처: 문서

본문

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

전제 조건

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

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

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

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

서비스를 로그인 시 실행하도록, 또는 부팅 시 실행하도록 설치할 수 있어요.

로그인 시 실행(Run at login)

터미널 창을 열고 다음 명령을 실행해요:

cloudflared service install

Cloudflare Tunnel은 launch agent로 설치되며, ~/.cloudflared/의 로컬 사용자 구성을 사용해 로그인할 때마다 시작돼요.

부팅 시 실행(Run at boot)

터미널 창을 열고 다음 명령을 실행해요:

sudo cloudflared service install

Cloudflare Tunnel은 launch daemon으로 설치되며, /etc/cloudflared의 구성을 사용해 시스템이 부팅될 때마다 시작돼요.

3. 서비스를 수동으로 시작하기

다음 명령을 실행해요:

sudo launchctl start com.cloudflare.cloudflared

출력은 /Library/Logs/com.cloudflare.cloudflared.err.log와 /Library/Logs/com.cloudflare.cloudflared.out.log에 기록돼요.

다음 단계(Next steps)

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

sudo launchctl stop com.cloudflare.cloudflared
sudo launchctl start com.cloudflare.cloudflared

더 알아보기 (Learn more)

macOS에서는 cloudflared service install로 launch agent(로그인 시) 또는 sudo로 launch daemon(부팅 시)을 설치해요. launchctl로 시작·중지하고 로그는 /Library/Logs/에 기록돼요.