Cloudflare

다운로드 2
업데이트 2026. 8. 4.

cloudflare-add-blacklist-rule

Cloudflare 서비스에 블랙리스트 규칙을 추가합니다.

문법

cloudflare-add-blacklist-rule profile=STRING ip=STRING [description=STRING]

옵션

profile=STRING
필수 옵션. Cloudflare 접속 프로파일 식별자입니다. 상태를 변경하는 명령어이므로 프로파일을 하나만 지정할 수 있습니다.
ip=STRING
필수 옵션. 차단할 IP 주소입니다. 유효한 IP 형식이어야 합니다.
description=STRING
선택 옵션. 규칙에 대한 설명입니다. Cloudflare 규칙의 메모(notes) 값으로 저장됩니다.

출력 필드

필드타입이름설명
profile문자열접속 프로파일규칙을 추가한 접속 프로파일 이름
success불리언성공 여부규칙 추가 성공 여부 (true/false)

설명

Cloudflare 방화벽 IP 접근 규칙(Access Rules)에 새로운 차단 규칙을 추가합니다. 지정한 IP 주소를 대상으로 모드는 block(차단)으로 고정되어 생성되며, description을 지정하면 규칙의 메모(notes)로 함께 저장됩니다.

규칙이 추가되는 범위는 접속 프로파일 설정에 따라 결정됩니다. 프로파일에 영역 ID(Zone ID)가 설정되어 있으면 해당 영역(zone) 범위에, 없으면 계정(account) 범위에 규칙이 생성됩니다.

Caution
이 명령어는 Cloudflare 방화벽 설정을 실제로 변경합니다. 실행 즉시 지정한 IP에 대한 차단 규칙이 생성되어 트래픽이 차단될 수 있습니다. 여러 zone/account에 의도치 않게 반영되는 것을 막기 위해 프로파일은 하나만 지정할 수 있습니다.

사용 예

예시: 특정 IP 차단 규칙 추가

상황: 악성으로 판단된 IP 주소를 Cloudflare 블랙리스트에 추가하여 차단합니다.

cloudflare-add-blacklist-rule profile=my_profile ip=192.0.2.1 description="blocked by policy"

예상 결과:

profilesuccess
my_profiletrue

결과 해석: successtrue이면 규칙이 정상적으로 생성된 것입니다. 이후 cloudflare-blacklist-rules 명령어로 생성된 규칙을 확인할 수 있습니다.