Repolode
qdm12

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. 1

    Go로 프로그램을 설치합니다

    go install github.com/qdm12/ddns-updater/cmd/ddns-updater@latest
  2. 2

    데이터 디렉터리를 만들고 그 안에 config.json 파일을 생성합니다

  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트