커뮤니티 DDNS 설정이 하려던 작업
커뮤니티 게시물에서는 DuckDNS를 사용하는 ddns-updater 애플리케이션의 config.json 예시를 공유했습니다. 핵심 아이디어는 여전히 유효합니다. 업데이터에는 공급자, 도메인, 자격 증명 또는 토큰, IP 버전 정책이 필요하며, 컨테이너가 재시작한 후에도 읽을 수 있는 위치에 영구 설정을 저장해야 합니다.
현재 ZimaOS 중심의 개요는 DuckDNS 하드웨어 및 설정 가이드와 최신 ZimaOS App Store 요구 사항 디렉터리를 참조하세요.
현재 ddns-updater 스키마 사용
업스트림 프로젝트에는 공급자별 설정이 문서화되어 있으므로, 공급자 스키마가 변경되었을 수 있을 때 오래된 예시를 무작정 복사하지 마세요. 현재 DuckDNS 문서에서는 DuckDNS 도메인과 토큰이 필요하며 IP 버전 옵션을 지원합니다. 공식 참고 자료는 ddns-updater DuckDNS 문서입니다. 기본 프로젝트 README에도 지원되는 공급자와 영구 설정 동작이 ddns-updater 프로젝트 문서에 설명되어 있습니다.
{
"settings": [
{
"provider": "duckdns",
"domain": "your-name.duckdns.org",
"token": "YOUR_TOKEN",
"ip_version": "ipv4"
}
]
}자리 표시자를 자신의 값으로 바꾸고, 실제 토큰을 스크린샷, 포럼 게시물, Git 저장소 또는 지원 티켓에 절대 공개하지 마세요.
ZimaOS에서 설정 파일 찾기
원래 스레드에서는 appdata/ddns-updater 경로를 언급했지만, 정확한 호스트 경로는 앱 설치 방식과 스토리지 매핑 방식에 따라 달라질 수 있습니다. 하나의 고정 경로를 가정하지 말고 ZimaOS에서 앱 설정을 열어 컨테이너의 설정 위치에 매핑된 영구 볼륨을 확인하세요. 편집하기 전에 현재 파일을 백업하세요.
업데이트 검증 방법
- JSON 구문 분석 오류 없이 컨테이너가 시작되는지 확인합니다.
- 공급자 인증 또는 도메인 오류가 있는지 업데이터 로그를 확인합니다.
- 다른 네트워크 또는 공용 DNS 확인자에서 호스트 이름을 조회합니다.
- 반환된 A 또는 AAAA 레코드를 현재 공인 주소와 비교합니다.
- 설정이 영구적으로 유지되는지 확인하기 위해 앱을 한 번 재시작합니다.
DDNS는 호스트 이름이 특정 주소를 가리키도록 유지할 뿐이며, 그 자체로 안전한 원격 액세스 경로를 만들어 주지는 않습니다. 최종 목적이 홈 서버에 원격으로 액세스하는 것이라면 서비스를 직접 노출하기 전에 Zima Client 원격 액세스에 설명된 연결 모델과 비교해 보세요.
공급자 변경 및 IPv6
Cloudflare 또는 다른 공급자를 사용하는 경우 DuckDNS 전용 필드를 제거하고 해당 공급자의 스키마를 따르세요. 예를 들어 현재 Cloudflare 설정에서는 영역 식별자와 API 토큰 같은 필드를 사용합니다. 공식 기준은 업스트림 Cloudflare 공급자 문서입니다.
FAQ
appdata/ddns-updater 폴더가 없는 이유는 무엇인가요?
영구 호스트 경로가 커뮤니티 예시에 사용된 경로와 다를 수 있습니다. 추측한 시스템 경로를 만들지 말고 앱의 볼륨 매핑을 확인하세요.
IPv4와 IPv6를 함께 사용할 수 있나요?
예. 하지만 현재 공급자 문서에 따라 IP 버전 옵션을 설정하고, 게시하려는 주소 체계를 ISP가 실제로 제공하는지 확인하세요.
DDNS는 VPN과 같은 것인가요?
아니요. DDNS는 호스트 이름을 변경되는 IP 주소에 매핑합니다. 인증, 암호화, 방화벽 규칙 및 원격 액세스 설계는 별개의 문제입니다.
