GhostlyDDns로 Cloudflare 동적 DNS 자동화
개인정보 보호 중심 .NET 10 CLI 도구로 Cloudflare DNS 기록을 동적 IP와 동기화합니다. 텔레메트리 없음, YAML 설정, 크로스 플랫폼 지원.
GhostlyDDns는 개인정보 보호에 중점을 둔 .NET 8 명령줄 에이전트로, 기존 Cloudflare A 및 AAAA 기록을 네트워크 엣지의 공인 IP와 동기화합니다. Ghostly Tools 제품군의 일부로, 개발자와 크리에이터, 셀프 호스팅 사용자에게 관리형 서비스 없이 신뢰할 수 있는 Cloudflare 동적 DNS 자동화 경로를 제공합니다.
런타임은 WAN 주소를 감시하며 여러 엔드포인트를 통해 IPv4 및 IPv6 변화를 감지하고, 업데이트가 필요할 때만 Cloudflare API를 호출합니다. Serilog 진단, 체계적인 지수 백오프, 일관된 종료 코드로 무인 운영에 필요한 가시성을 제공합니다.
GhostlyInc의 Ghostly Tools 개인정보 보호 소프트웨어인 GhostlyDDns는 외부 SaaS에 자격 증명을 노출하지 않고도 지속적인 Cloudflare 정확성이 필요한 셀프 호스팅 네트워크를 위한 경량 자동화 계층을 제공합니다.
목차
에디션 및 라이선스
운영체제에 맞는 GhostlyDDns 빌드를 선택하세요. 모든 Gumroad 라이선스는 GhostlyDDns 1.x 버전의 평생 업데이트를 포함하며 동일한 YAML 설정을 모든 에디션에서 사용할 수 있습니다.
모든 라이선스에 GhostlyDDns 1.x 버전 평생 업데이트가 포함됩니다.
주요 기능
개인정보 중심 운영
텔레메트리, 계정 연동, 외부 제어 없이 인프라에서 GhostlyDDns를 완전 운영하세요.
변경 감지 업데이트
다중 엔드포인트 IP 탐지, 메모리 캐싱, 체계적 백오프로 중복된 Cloudflare API 호출을 제거합니다.
크로스 플랫폼 배포
Windows, Linux, ARM64용 단일 파일 .NET 8 바이너리를 제공해 어디서나 동일한 설정 파일을 재사용할 수 있습니다.
활용 사례
GhostlyDDns는 WAN 주소 변경 시 수동 DNS 업데이트를 없애 셀프 호스팅 팀, 에이전시, 원격 근무자의 가동 시간을 유지합니다.
- ISP 임대 갱신 후에도 라우터 원격 관리 없이 홈랩 VPN 게이트웨이를 항상 연결 상태로 유지하세요.
- 동적 사무실 연결에서 애플리케이션을 운영하면서 Cloudflare에서 화이트 라벨 클라이언트 포털을 유지하세요.
- 모바일 장애 조치 시에도 스트리밍 인제스트 도메인을 최신 상태로 유지해 방송 장비나 크리에이티브 스튜디오를 보호하세요.
- 단일 경량 자동화 에이전트로 여러 고객 존을 운영하는 관리형 서비스 제공자를 지원합니다.
CLI 명령어
GhostlyDDns CLI는 설정 생성, 테스트 실행, 단일 실행, 지속 모니터링을 위한 명령어를 제공합니다. 다양한 플래그로 내장 도움말을 확인할 수 있습니다.
ghostly-ddns init-config [--path|--p|-p <path>]
ghostly-ddns dry --config|--c|-c <path>
ghostly-ddns once --config|--c|-c <path>
ghostly-ddns run --config|--c|-c <path>
ghostly-ddns --help | --h | -h
ghostly-ddns --version | --v | -v설정 스키마
모든 런타임 설정은 단일 YAML 파일에 저장됩니다. Cloudflare API 토큰, 폴링 간격, IP 탐지 설정, 로그 보존 기간, 관리할 레코드를 지정하세요. GhostlyDDns는 시작 시 스키마를 검증하고 누락된 값에 대해 경고를 제공합니다.
cloudflare:
api_token: CF_API_TOKEN
update:
interval_seconds: 120
ip_detection:
detect_ipv4: true
detect_ipv6: false
v4_endpoints:
- https://api.ipify.org
- https://ipv4.icanhazip.com
v6_endpoints:
- https://api6.ipify.org
logging:
retention_days: 30
records:
- name: home.example.com
type: A
proxied: true
ttl: auto검증 규칙은 API 토큰 존재, 최소 하나의 레코드 정의, TTL 값이 auto 또는 60 이상, 활성화된 탐지기마다 최소 하나의 엔드포인트 포함을 보장합니다.
로그 및 진단
Serilog가 구조화된 콘솔 출력과 logs 디렉터리 내 롤링 파일 로그를 제공합니다. 기본 보존 기간은 30일이며 YAML 설정으로 조정 가능합니다.
로그는 감지된 IP, 변경 없을 때 건너뛴 업데이트, Cloudflare 상태 코드, 지수 백오프에 따른 재시도 활동을 기록해 무인 운영에 적합하도록 지원합니다.
배포 가이드
GhostlyDDns는 Linux systemd 타이머와 Windows 작업 스케줄러 템플릿 가이드를 제공해 팀이 빠르게 자동화를 표준화할 수 있습니다.
Linux systemd 서비스
바이너리를 usr/local/bin에 설치하고 설정 파일을 etc/GhostlyDDns에 두며 전용 서비스 계정으로 에이전트를 실행하세요.
[Unit]
Description=GhostlyDDns updater
After=network-online.target
[Service]
Type=simple
ExecStart=/usr/local/bin/ghostly-ddns run --config /etc/GhostlyDDns/config.yaml
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetLinux systemd 타이머
타이머를 서비스와 연결해 반복 실행을 예약하고 Cloudflare 연결 장애 시 지수 백오프를 적용하세요.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetWindows 작업 스케줄러
공식 XML 템플릿을 가져오거나 최고 권한으로 몇 분마다 run 명령을 실행하고 실패 시 재시작하는 작업을 만드세요.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
/RL HIGHEST ^
/F- 프로그램 경로 C GhostlyDDns ghostly-ddns.exe
- 인수 run --config C GhostlyDDns config.yaml
- 로그는 실행 파일 옆 logs 디렉터리에 저장됩니다
자주 묻는 질문
GhostlyDDns 기능, Cloudflare 요구사항, 운영 방식을 빠르게 확인해 배포 전 준비하세요.
GhostlyDDns 지원 정보
다음 단계
원하는 GhostlyDDns 에디션을 선택하고 Gumroad에서 바이너리를 다운로드한 후 GhostlyInc의 다른 개인정보 보호 도구와 함께 배포하세요.
관련 자료
개인정보 중심 인프라와 DNS 관리를 위한 가이드를 확인하세요