# CoreDNS v1.13.2

2025-12-10 · [릴리스 노트 원문](https://github.com/coredns/coredns/releases/tag/v1.13.2) · [전체 정리](https://ratatosk.io/ko/releases/coredns/v1.13.2)

보안 1 · 호환성 변경 4 · 폐기 예정 1 · 중요 수정 5 · 기능·개선 6 · 기타 6

## 보안 (1)

### `forward` 재시도의 무한 바쁜 루프 수정

- 영향 대상: `forward` 플러그인을 사용하는 설정 (추정)

TCP RST 같은 즉각적인 업스트림 연결 오류가 발생하면 `fails` 카운터가 그대로 유지되어 재시도 루프가 계속 실행되고, 시스템 호출이 과도하게 반복될 수 있었습니다. `max_connect_attempts`를 0보다 큰 값으로 설정하면 DNS 요청당 연결 시도 횟수를 제한할 수 있습니다. 기본값 0은 제한을 두지 않습니다.

> * plugin/forward: Prevent busy loop on connection err (https://github.com/coredns/coredns/pull/7704)

## 호환성 변경 (4)

### `plugin/pkg/uniq`의 맵 접근 동기화 및 `New()`의 `*U` 반환

- 영향 대상: `New()`의 반환형을 `uniq.U`로 명시한 `plugin/pkg/uniq` 사용 서드파티 플러그인

리로드 중 여러 고루틴이 내부 맵에 동시에 접근하면 데이터 레이스가 발생할 수 있었습니다.

근거: “var u uniq.U = uniq.New() // ❌ Won't compile with new version” https://github.com/coredns/coredns/pull/7707

> * core: Fix data race with sync.RWMutex for uniq (https://github.com/coredns/coredns/pull/7707)

### Auto 플러그인의 10,000자 초과 `REGEXP` 패턴 거부

- 영향 대상: Auto 플러그인에서 10,000자를 초과하는 `REGEXP` 패턴을 사용하는 구성 (추정)

Corefile의 매우 큰 정규식 패턴으로 인해 CoreDNS의 메모리가 고갈될 수 있었습니다. 이제 10,000자를 초과하는 패턴은 `regexp too large`를 반환합니다.

근거: “A very large regex for the auto plugin in the Corefile could cause CoreDNS to OOM. This change adds an artificial limit of 10k characters for the regex pattern.” https://github.com/coredns/coredns/pull/7737

> * plugin/auto: Limit regex length (https://github.com/coredns/coredns/pull/7737)

### `forward`에서 `NOERROR`를 `failover` 기준으로 지정하는 설정 거부

- 영향 대상: `failover NOERROR`를 사용하는 CoreDNS 설정 (추정)

이전에는 파서가 `NOERROR`를 `failover` 기준으로 인식하지 않아, `failover NOERROR`를 사용하는 설정이 이 검증에서 거부되지 않았습니다. 이제는 설정을 파싱하는 단계에서 실패합니다.

근거: “Previously the parsing logic in the `forward` plugin setup failed to recognise when `NOERROR` was used as a failover RCODE criteria. The check was in the wrong code branch. This PR fixes it and adds validation tests.” https://github.com/coredns/coredns/pull/7622

> * plugin/forward: Disallow NOERROR in failover (https://github.com/coredns/coredns/pull/7622)

### multisocket `NUM_SOCKETS` 최댓값 1024로 제한

- 영향 대상: `NUM_SOCKETS`가 1024를 초과하는 multisocket 구성 (추정)

이전에는 `NUM_SOCKETS` 값에 제한이 없어 CoreDNS가 리스너를 과도하게 생성하고 시작 시 메모리가 부족해질 수 있었습니다.

근거: “+* **NUM_SOCKETS** - the number of servers that will listen on one port. Default value is equal to GOMAXPROCS. Maximum value is 1024.” https://github.com/coredns/coredns/pull/7615

> * plugin/multisocket: Cap num sockets to prevent OOM (https://github.com/coredns/coredns/pull/7615)

## 폐기 예정 (1)

### 올바른 철자의 `MaximumDefaultTTL` 상수 추가

- 영향 대상: dnsutil 패키지의 내보내는 TTL 상수를 사용하는 Go 코드 (추정)
- 제거 시점: 미상

기존 이름인 `MaximumDefaulTTL`도 같은 값인 `1 * time.Hour`을 가진 별칭으로 계속 사용할 수 있으며, 지원 중단 예정입니다. 이제 cache 패키지는 `MaximumDefaultTTL`을 참조합니다.

> * plugin/cache: Correct spelling of MaximumDefaultTTL in cache and dnsutil packages (https://github.com/coredns/coredns/pull/7678)

## 중요 수정 (5)

### Dnstap flush 및 소켓 재연결 수정

- 영향 대상: Dnstap 플러그인을 사용하는 설정

큐가 계속 가득 차 있으면 타이머가 반복해서 재설정되어 flush가 실행되지 않고, 드롭된 메시지에 대한 보고도 늦어졌습니다. 시작할 때 출력 소켓에 연결할 수 없는 상태에서 CoreDNS가 계속 바쁘게 동작하면 몇 시간 동안 소켓 재연결을 시도하지 않을 수도 있었습니다. 이제 큐가 가득 찬 동안 초마다 flush, 오류 보고, 재연결을 수행합니다. 인코더가 없으면 실패한 각 메시지에 오류를 반환해 소켓 재연결을 유도합니다.

> * plugin/dnstap: Better error handling (redial & logging) when Dnstap is busy (https://github.com/coredns/coredns/pull/7619)

### DNS-over-QUIC 재로드 중 크래시 수정

- 영향 대상: DNS-over-QUIC 구성

소켓을 재사용하고 `s.quicListener`가 nil인 상태로 재로드하면 서버가 크래시를 일으키고 패닉에 빠질 수 있었습니다. 이제 `s.quicListener`가 nil이면 `ServePacket`에서 초기화합니다.

> * core: Prevent QUIC reload panic by lazily initializing the listener (https://github.com/coredns/coredns/pull/7680)

### 캐시 백그라운드 프리페치 메타데이터 경합 수정

- 영향 대상: 캐시 플러그인의 백그라운드 프리페치를 사용하는 구성

체인에 있는 다른 플러그인이 백그라운드 프리페치 중 요청 단위 메타데이터에 동시에 접근하거나 기록하면, 읽기와 쓰기가 경합해 치명적인 동시 맵 접근 오류가 발생할 수 있었습니다. 이제 프리페치는 새로운 메타데이터 컨텍스트를 사용하므로, 원래 요청의 메타데이터 맵을 읽는 작업과 프리페치의 쓰기가 서로 격리됩니다.

> * plugin/cache: Isolate metadata in prefetch goroutine (https://github.com/coredns/coredns/pull/7631)

### CNAME `RegexMatch` 규칙 설정 시 정규식 사전 컴파일

- 영향 대상: `RegexMatch` 매치 타입을 사용하는 CNAME 리라이트 규칙 (추정)

이전에는 잘못된 패턴이 규칙을 처음 실행할 때 패닉을 일으킬 수 있었지만, 이제는 설정 오류를 반환합니다. 유효한 패턴은 요청마다 다시 컴파일하지 않으므로 플러그인 성능이 향상됩니다.

> * plugin/rewrite: Pre-compile CNAME rewrite regexp (https://github.com/coredns/coredns/pull/7697)

### Secondary 플러그인 리로드 고루틴 누수 수정

- 영향 대상: `TransferFrom`이 설정된 Secondary 플러그인의 존 (추정)

`TransferFrom`이 설정된 존에서 Secondary 플러그인을 리로드할 때 업데이트 고루틴이 종료되지 않아 누수될 수 있었습니다. 이제 리로드 종료 과정에서 고루틴이 티커를 중지하고 반환합니다.

> * plugin/secondary: Fix reload causing secondary plugin goroutine to leak (https://github.com/coredns/coredns/pull/7694)

## 기능·개선 (6)

- DNS over HTTP/3 서버 지원 (사용 조건: DoH3 사용을 위한 `https3://` 서버 주소 설정)
- `forward` 플러그인의 대상별 TLS 서버 이름 (사용 조건: 각 TLS 대상 URI에 예상 서버 이름을 지정하고, 대상별 SNI를 사용할 때는 `tls_servername`을 생략합니다.)
- `forward` 플러그인의 요청별 업스트림 연결 시도 횟수 제한 (사용 조건: 요청별 제한을 사용하려면 `max_connect_attempts`를 양수로 설정해야 합니다. 기본값 0은 제한이 없음을 의미합니다.)
- `geoip` 플러그인의 ASN 데이터베이스 및 메타데이터 지원 (사용 조건: ASN `.mmdb` 데이터베이스를 설정해야 합니다.)
- GeoIP City 메타데이터에 세부 행정 구역 코드 추가
- Nomad 플러그인에 서비스 필터링 추가 (사용 조건: Nomad 플러그인의 `filter` 설정 구성 필요; Nomad 필터링 구문을 허용하며 기본값은 `""`)

## 기타 (6)

- 프록시 풀 `Yield`의 타이머 할당 방지
- CoreDNS replacer, 바이트 슬라이스 포인터 풀링으로 메모리 할당 방지
- 테스트 코드에서 알려진 타입에 `reflect.TypeFor` 사용
- 캐시 응답 복사 시 불필요한 슬라이스 할당 방지
- `file` 플러그인의 레이블 순회 최적화
- Kubernetes 플러그인의 watch 실패 로그에 원인 오류 포함

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
