DNSHE Free Domains로 무료 서브도메인 등록하고 DNS API 연결하기

개인 프로젝트를 외부에 잠깐 보여줄 때 매번 도메인부터 막힙니다. DNSHE Free Domains는 무료 서브도메인과 DNS 레코드 관리, API 자동화를 한곳에서 다뤄서 테스트 주소를 자주 만드는 개발자에게 맞습니다.

개요

DNSHE Free Domains는 DNSHE가 운영하는 public suffix 아래에서 무료 서브도메인을 등록하고 DNS 레코드를 관리하는 서비스입니다. README에는 A, AAAA, CNAME, MX, TXT, NS, SRV, CAA 레코드 지원과 대시보드 기반 관리, API 기반 자동화가 같이 적혀 있습니다.

저라면 운영 서비스의 대표 도메인보다 CI/CD, 데모, 봇 webhook, 테스트 API 주소에 먼저 붙이겠습니다. 서버 공개와 도메인 연결에는 n8n 셀프 호스팅 설치 글 뒤의 네트워크 계층도 필요합니다. DNSHE는 그 앞단의 이름 관리에 가깝습니다.

1. 쓸 만한 지점

무료 도메인 서비스는 대개 수동 등록에서 끝나는데, DNSHE는 API와 DNS 레코드 관리를 README 전면에 둡니다. 작은 SaaS, 임시 API endpoint, 자동화 테스트 주소를 자주 갈아 끼우는 경우에 잘 맞습니다.

• 무료 서브도메인: 기본 무료 도메인 서비스는 신용카드가 필요 없다고 안내합니다.
• 지원 suffix: README 기준 .de5.net, .us.ci, .cc.cd, .bot.cd를 공개 등록 후보로 둡니다.
• DNS 레코드: A, AAAA, CNAME, MX, TXT, NS, SRV, CAA 관리.
• 자동화: API로 서브도메인, DNS record, quota, WHOIS 확인 경로 제공.

짧게 말하면 데모 주소용입니다.

2. 준비 사항

DNSHE 계정이 필요합니다. Client Area에서 Domain Hub를 열고 사용 가능한 prefix와 suffix를 고르면 됩니다. README는 등록 가능 여부, 제한, 갱신 규칙이 대시보드와 서비스 정책을 따른다고 적습니다. 등록 전에는 대시보드를 다시 봐야 합니다.

API 자동화를 붙이려면 API Key와 API Secret을 만들어야 합니다. 공식 API 문서는 Header 인증을 권장하고, URL parameter나 request body로 api_key, api_secret을 넘기는 방식은 더 이상 지원하지 않는다고 적습니다. 토큰을 URL에 넣는 예전 방식으로 CI 로그에 남기는 지점이 가장 위험합니다.

3. 기본 사용 방법

대시보드에서는 다섯 단계만 거칩니다.

• DNSHE 또는 Client Area에서 계정을 만듭니다.
• Domain Hub를 엽니다.
• 사용 가능한 prefix를 검색합니다.
• suffix를 고른 뒤 서브도메인을 등록합니다.
• DNS 레코드를 넣고 갱신 규칙을 확인하시면 됩니다.

자동화는 API 문서의 base URL을 씁니다. 예시는 실제 키 대신 placeholder만 둡니다.

curl -X GET "https://api005.dnshe.com/index.php?m=domain_hub&endpoint=subdomains&action=list" \
  -H "X-API-Key: <API_KEY>" \
  -H "X-API-Secret: <API_SECRET>"

DNS 레코드 생성은 endpoint=dns_records&action=create 경로를 씁니다.

curl -X POST "https://api005.dnshe.com/index.php?m=domain_hub&endpoint=dns_records&action=create" \
  -H "X-API-Key: <API_KEY>" \
  -H "X-API-Secret: <API_SECRET>" \
  -H "Content-Type: application/json" \
  -d '{"subdomain_id": 1, "type": "A", "content": "<서버_IP>"}'

4. 기존 대안과 비교

GitHub Pages나 Cloudflare Pages는 배포와 호스팅 흐름이 강합니다. 반대로 DNSHE는 이름과 DNS 레코드 관리에 초점이 있습니다. 이미 개인 도메인과 Cloudflare Zone을 쓰고 있다면 DNSHE로 갈아탈 이유는 약합니다.

DuckDNS류 dynamic DNS는 집 서버 IP 갱신에 편합니다. DNSHE는 suffix 선택지와 API 문서, DNS record 범위가 장점입니다. 제 기준으로는 집 서버 고정 접속보다 테스트 서비스 이름을 여러 개 만들 때 더 어울립니다.

5. 적용 제외 대상

운영 브랜드 도메인, 결제 페이지, 로그인 페이지에는 맞지 않습니다. README도 phishing, fraud, fake login pages, malware, spam, DDoS, proxy abuse, resale 같은 사용을 금지합니다. 공유 루트 도메인이라 평판 리스크도 같이 봐야 합니다.

장기 운영 서비스라면 본인 소유 도메인을 쓰시면 됩니다. 무료 서브도메인은 테스트와 공개 데모까지 쓰는 게 안전합니다.

확인

아래 항목만 확인해주시면 됩니다.

• Domain Hub에서 선택한 full domain이 active 상태인지 확인합니다.
• A 또는 CNAME 레코드가 목표 서버나 배포 주소를 가리키는지 확인합니다.
• API 호출 결과가 "success": true이면 인증 헤더와 endpoint 조합은 정상입니다.