Docker 컨테이너 레이블을 바탕으로 Cloudflare Tunnel 경로, DNS 레코드, Access 정책을 자동 생성하는 셀프 호스팅 도구입니다.
qdm12/ddns-updater
웹 UI를 제공하며 다양한 DNS 제공업체의 A/AAAA 레코드를 주기적으로 갱신하는 경량 셀프 호스팅 프로그램입니다.
대체할 수 있는 제품:DynDNS
- 스타
- 3,258
- 포크
- 286
- 열린 이슈
- 244
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
DDNS Updater는 DNS A 및 AAAA 레코드가 현재 공인 IP 주소를 가리키도록 유지합니다. 가정이나 사무실 인터넷 회선에서 동적 IP를 사용하는 경우 유용합니다. 단일 바이너리 또는 Docker/Kubernetes 컨테이너로 실행할 수 있으며, 설정된 주기(기본값 5분)마다 공인 IP를 확인하고 DNS 레코드가 해당 주소로 해석되지 않을 때만 DNS 제공업체의 API를 호출합니다.
Cloudflare, Namecheap, GoDaddy, Route53, DuckDNS, DigitalOcean, Hetzner를 비롯해 다양한 제공업체를 지원하며, 각 제공업체별 설정 가이드를 제공합니다. 설정은 JSON 파일이나 단일 환경 변수로 지정하고, 웹 UI에서 각 레코드의 상태를 확인할 수 있습니다. Shoutrrr를 통해 알림을 보낼 수 있으며, healthcheck로 도메인이 올바르게 해석되는지 확인할 수 있습니다.
핵심 기능
- 01수십 개 DNS 제공업체의 A 및 AAAA 레코드를 갱신합니다.
- 02데스크톱 및 모바일 레이아웃을 지원하는 웹 UI에서 레코드 상태를 확인할 수 있습니다.
- 03의존성이 없는 바이너리 또는 amd64, arm64 및 기타 아키텍처용 소형 Docker 이미지로 실행할 수 있습니다.
- 04DNS 조회 결과에 현재 IP가 이미 반영되어 있으면 API 호출을 건너뛰어 요청 제한을 피합니다.
- 05Shoutrrr를 통한 알림 전송과 healthchecks.io 핑을 지원합니다.
활용 사례
- ISP가 IP 주소를 변경하더라도 홈 서버나 셀프 호스팅 서비스를 계속 연결 가능한 상태로 유지합니다.
- 지원되는 제공업체의 레코드를 관리하는 DDNS 클라이언트를 Docker 또는 Kubernetes 클러스터에서 실행합니다.
- Raspberry Pi나 기타 소형 ARM 기기를 사용해 라우터가 없는 네트워크의 레코드를 갱신합니다.
빠른 시작
- 1
Go로 프로그램을 설치합니다
go install github.com/qdm12/ddns-updater/cmd/ddns-updater@latest - 2
데이터 디렉터리를 만들고 그 안에 config.json 파일을 생성합니다
- 3
프로그램을 실행합니다
./ddns-updater
사용 전 알아둘 점
- 무엇이든 업데이트하기 전에 DNS 제공업체의 인증 정보가 포함된 JSON 설정을 작성해야 합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- ddns-updater은(는) 무엇인가요?
- 웹 UI를 제공하며 다양한 DNS 제공업체의 A/AAAA 레코드를 주기적으로 갱신하는 경량 셀프 호스팅 프로그램입니다. DDNS Updater는 DNS A 및 AAAA 레코드가 현재 공인 IP 주소를 가리키도록 유지합니다. 가정이나 사무실 인터넷 회선에서 동적 IP를 사용하는 경우 유용합니다. 단일 바이너리 또는 Docker/Kubernetes 컨테이너로 실행할 수 있으며, 설정된 주기(기본값 5분)마다 공인 IP를 확인하고 DNS 레코드가 해당 주소로 해석되지 않을 때만 DNS 제공업체의 API를 호출합니다.
- ddns-updater은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- ddns-updater은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- ddns-updater은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. ddns-updater의 마지막 커밋은 2026년 9월 16일입니다.
- ddns-updater은(는) 어디에 사용할 수 있나요?
- ISP가 IP 주소를 변경하더라도 홈 서버나 셀프 호스팅 서비스를 계속 연결 가능한 상태로 유지합니다. 지원되는 제공업체의 레코드를 관리하는 DDNS 클라이언트를 Docker 또는 Kubernetes 클러스터에서 실행합니다. Raspberry Pi나 기타 소형 ARM 기기를 사용해 라우터가 없는 네트워크의 레코드를 갱신합니다.
- ddns-updater는 어떻게 설치하나요?
- Go로 프로그램을 설치합니다: go install github.com/qdm12/ddns-updater/cmd/ddns-updater@latest 데이터 디렉터리를 만들고 그 안에 config.json 파일을 생성합니다 프로그램을 실행합니다: ./ddns-updater
- ddns-updater은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/qdm12/ddns-updater
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
홈랩과 NAS용 셀프 호스팅 네트워크 게이트웨이: DDNS, 포트 포워딩, 리버스 프록시, ACME 인증서, WAF 등을 단일 바이너리로 제공합니다.
VPS나 전용 서버에서 웹 앱 배포, 데이터베이스·Docker 컨테이너·DNS·백업·보안을 관리하는 셀프 호스팅 서버 제어판입니다.
Proxmox, Docker, Kubernetes, TrueNAS, vSphere를 실시간으로 모니터링하는 셀프 호스팅 대시보드
드래그 앤 드롭 레이아웃, 80개 이상의 서비스 연동, 기본 제공 아이콘과 사용자 인증을 지원하는 셀프 호스팅 홈 대시보드입니다.
Docker, Swarm, Podman, Kubernetes, ACI 컨테이너 환경을 관리하는 가벼운 웹 UI입니다.