# CoreDNS v1.13.2

2025-12-10 · [元のリリースノート](https://github.com/coredns/coredns/releases/tag/v1.13.2) · [全体のまとめ](https://ratatosk.io/ja/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` の map アクセス同期化と戻り値型の変更

- 影響対象: `plugin/pkg/uniq` を使用し、`New()` の戻り値を `uniq.U` と明示的に宣言しているサードパーティープラグイン

再読み込み中、内部マップにアクセスする複数のゴルーチンがデータ競合を引き起こす可能性がありました。

根拠: “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` パターンの拒否

- 影響対象: 10,000文字を超える `REGEXP` パターンを含む auto プラグインの設定 (推定)

Corefile 内の非常に大きな正規表現パターンによって、CoreDNS のメモリが不足する可能性がありました。上限を超えるパターンには `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` による `failover` 条件としての `NOERROR` の拒否

- 影響対象: `failover NOERROR` を使用する CoreDNS の設定 (推定)

以前は、パーサーが `NOERROR` をフェイルオーバー条件として認識しなかったため、この検証では `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 のフラッシュとソケット再接続の修正

- 影響対象: Dnstap プラグインを使用する構成

キューが満杯のままだと、タイマーが繰り返しリセットされてフラッシュが妨げられ、破棄されたメッセージの報告も遅れていました。また、起動時に出力ソケットへ接続できず、CoreDNS がビジー状態のままだと、再接続まで何時間もかかることがありました。現在は、キューが満杯の間、フラッシュ、エラー報告、再接続を毎秒実行します。エンコーダーがない場合は、失敗したメッセージごとにエラーを返し、ソケットの再接続を促します。

> * 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 のままになる再読み込み時に、サーバーがクラッシュしてパニックを起こすことがありました。`ServePacket` で `s.quicListener` が nil の場合に初期化するようになりました。

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

### Cache のバックグラウンドプリフェッチにおけるメタデータ競合の修正

- 影響対象: cache プラグインのバックグラウンドプリフェッチを使用する構成

バックグラウンドプリフェッチ中に、チェーン内の他のプラグインがリクエスト単位のメタデータに同時にアクセスまたは書き込みを行うと、読み取りと書き込みが競合し、並行マップによる致命的なクラッシュが発生する可能性がありました。プリフェッチでは新しいメタデータコンテキストを使うようになり、元のリクエストのメタデータマップの読み取りと、プリフェッチによる書き込みが分離されます。

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

### CNAME の `RegexMatch` ルールでセットアップ時に正規表現を事前コンパイル

- 影響対象: `RegexMatch` マッチタイプを使用する CNAME 書き換えルール (推定)

以前は無効なパターンをルールの初回実行時に使用すると panic が発生する可能性がありましたが、現在はセットアップエラーが返されます。有効なパターンはリクエストごとに再コンパイルされなくなり、プラグインのパフォーマンスが向上します。

> * 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)

- Proxy プールの `Yield` によるタイマー割り当ての回避
- CoreDNS replacer、バイトスライスへのポインターのプールによるメモリー割り当ての回避
- 既知の型に対するテストコードでの `reflect.TypeFor` の使用
- キャッシュ応答のコピーで不要なスライス割り当てを回避
- `file` プラグインのラベル走査を最適化
- Kubernetes プラグインのウォッチ失敗ログに原因エラーを追加

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
