# NATS v2.12.3

2025-12-17 · [元のリリースノート](https://github.com/nats-io/nats-server/releases/tag/v2.12.3) · [全体のまとめ](https://ratatosk.io/ja/releases/nats/v2.12.3)

セキュリティ 4 · 破壊的変更 6 · 重大な修正 27 · 機能・改善 13 · 依存関係の更新 8 · その他の変更 11

## アップグレード前の確認事項

### アップグレードガイド

- **2.11.x を利用するユーザー向け 2.12 アップグレードガイド**
  > Refer to the [2.12 Upgrade Guide](https://docs.nats.io/release-notes/whats_new/whats_new_212) for backwards compatibility notes with 2.11.x.

  - `GOMEMLIMIT` による GC 閾値の制御: システムで利用可能なメモリ量、または Kubernetes ではメモリ予約量に応じて、`GOMEMLIMIT` を調整するとよい場合があると説明されています。
  - ダウングレード後のストリーム状態ファイル再構築: v2.12 から v2.11 にダウングレードした後の最初の再起動時に、すべてのストリームメッセージブロックが再スキャンされます。そのため、CPU 使用量が増加し、再起動したノードが正常と報告するまでに時間がかかることがあります。データ損失は発生しません。

## セキュリティ (4)

### [medium] WebSocket の圧縮爆弾によるメモリ消費の修正

- 2026-02-23 · [リリース後にセキュリティアドバイザリGHSA-qrvq-68c2-7grwが公開](https://github.com/nats-io/nats-server/security/advisories/GHSA-qrvq-68c2-7grw)
- 影響対象: 圧縮フレームを受信する WebSocket 接続
- [CVE-2026-27571](https://www.cve.org/CVERecord?id=CVE-2026-27571), [GHSA-qrvq-68c2-7grw](https://github.com/nats-io/nats-server/security/advisories/GHSA-qrvq-68c2-7grw)

以前は、圧縮率の高いフレームを展開すると、最大ペイロードサイズを超えたとしてサーバーが拒否する前に非常に大きなバッファーが生成されることがあり、過剰なメモリ消費やサーバーの停止につながるおそれがありました。現在は、設定された最大ペイロードサイズ（未指定の場合はデフォルトの最大値）に達した時点で展開を停止し、`ErrMaxPayload` を返します。

> - WebSocket connections will now correctly limit the buffer size during decompression (#7625, thanks to Pavel Kokout at Aisle Research)

セキュリティアドバイザリ:

> This was fixed in the v2.11 series with v2.11.12 and in the v2.12 series with v2.12.3.

https://github.com/nats-io/nats-server/security/advisories/GHSA-qrvq-68c2-7grw

### `$MQTT.` サブジェクトに対する MQTT クライアントおよび非クライアント接続の暗黙の権限

- 影響対象: MQTT クライアントおよびルート接続、リーフ接続を含む非クライアント接続

従来、設定済みのサブスクライブ権限では、JetStream コンシューマーのサブスクリプションで使われる `$MQTT_sub.` プレフィックスを明示的に許可する必要がありました。現在は、これらの接続では `$MQTT.` で始まるサブジェクトへの publish と subscribe が許可エントリーなしで可能ですが、`deny` ACL は引き続き適用されます。通常の NATS Core クライアントには暗黙の許可は与えられません。

> - Permissions to `$MQTT.` subscriptions are now handled implicitly, with the exception of `deny` ACLs which still permit restriction (#7637)

### TLS 暗号スイート選択の更新

- 影響対象: 安全でない、または新たに利用可能になった暗号スイートに依存する TLS 接続 (推定)

`crypto/tls` の新しい暗号スイートが自動的に追加されます。一方、安全でない暗号スイートは、`allow_insecure_cipher_suites` が有効になっていない限り、デフォルトで無効になります。

> Use cipher suites from crypto/tls : New cipher suites are now automatically added. Additionally, insecure cipher suites are disabled by default, but can be allowed when enabling allow_insecure_cipher_suites .

https://docs.nats.io/release-notes/whats_new/whats_new_212

### 接続ログに識別情報を追加

- 影響対象: クライアント接続関連のログおよび接続終了ログ (推定)

クライアント接続関連のログにはアカウント名とユーザーが含まれ、接続終了ログにはリモートサーバー名が含まれます。

> Account name and user logging: Any logging related to a client connection, for example when reaching maximum connections or for authentication errors, will now include the account name and user of that client connection. Connection closed logging now includes the remote server name.

https://docs.nats.io/release-notes/whats_new/whats_new_212

## 破壊的変更 (6)

### JetStream メタ層、ピア削除要求への応答前にクォーラムを待機

- 影響対象: JetStream メタ層が処理するピア削除要求を発行する構成 (推定)

従来は、ピアの削除がクォーラムに達する前にメタリーダーが成功を報告することがありました。その結果、クラスターの構成は変わらないまま、ユーザーや自動化プロセスがクラスターの規模が縮小したと思い込むおそれがありました。

> - The meta layer will now only respond to peer remove requests after quorum has been reached (#7581)

### ディスク操作に合わせたフィルストアの削除会計

- 影響対象: フィルストアでのメッセージ削除 (推定)

以前は、トゥームストーンの書き込みに失敗しても表面化しないことがありました。また、安全な消去に失敗すると、ディスク上の状態よりも会計上の値が先行することがありました。トゥームストーンの書き込みに失敗した場合は、エラーとして通知されるようになりました。

> - The filestore now will process message removal on disk before updating accounting, which improves error handling (#7595, #7601)

### Filestore と consumer の操作でのメッセージブロック読み込みエラーの伝播

- 影響対象: キャッシュされていないメッセージブロックを読み込む Filestore および consumer の操作 (推定)

キャッシュされていないメッセージブロックの読み込みに失敗した場合、該当する操作は処理を続行せず、エラーを返すか伝播するようになりました。

> - Improved error handling within the loading of message blocks if not already cached (#7631)

### MQTT の最大ペイロード制限の適用

- 影響対象: 最大ペイロードサイズを設定した MQTT クライアント (推定)

以前は、NATS メッセージ全体のサイズが最大ペイロードサイズを超える MQTT publish が、接続チェックで失敗せずに黙って受け入れられることがありました。現在は、このような publish はチェックで失敗します。

> - The maximum payload size is now correctly enforced for MQTT clients (#7555, thanks to @yixianOu)

### Raft による同時メンバーシップ変更のブロック

- 影響対象: JetStream のピア削除操作を含む、Raft のメンバーシップ変更を行う環境

以前は、別のメンバーシップ変更が進行中でも新たな変更を提案できました。現在は、リーダーが同時に行われた変更を破棄します。また、JetStream のピア削除では、メンバー変更の進行中を示すエラーが返されることがあります。

根拠: “A simple approach based to avoid concurrent membership changes. The leader simply drops a membership change if there is another membership change in progress. A membership is in progress if it has been proposed, but not committed yet.” https://github.com/nats-io/nats-server/pull/7565

> - Raft will no longer allow multiple membership changes to take place concurrently (#7565, #7609)

### レプリケートされたインメモリストリームの復旧の信頼性向上

- 影響対象: レプリケートされたインメモリストリーム

サーバーが1台を除いてすべて再起動された後も、ストリームのデータが確実に追いつくようになりました。この復旧中は、クォーラムだけでなく、ストリームを複製しているすべてのサーバーが利用可能である必要があります。

> -
> Stream/consumer scaleup and reset disk/state protection: The server now has better protections against leader elections based on empty state. This also improves reliability of replicated in-memory streams. Usually a quorum of servers needs to be online and contain data. Now all but one server can be restarted and the in-memory stream's data can reliably be caught back up. However, during such a scenario all servers involved with replication of that stream will need to be available, not just what's needed for quorum. This lets the servers decide the best course of action to preserve all data.

https://docs.nats.io/release-notes/whats_new/whats_new_212

## 重大な修正 (27)

### 不正なサブジェクトフィルターの誤マッチを修正

- 影響対象: 末尾以外にフルワイルドカードを含む不正なサブジェクトフィルター

不正なフィルター `foo.>.bar` は、マッチ件数が0件になるはずが、予期せず `bar` にマッチすることがありました。現在は `bar` にマッチしません。

> - Invalid subject filters containing non-terminating full wildcard no longer produce unexpected matches (#7585)

### Filestoreでのメッセージブロック全体の削除時におけるsubjectとスケジュールの追跡情報の更新

- 影響対象: メッセージブロック全体を削除する Filestore

上限を適用する場合を含め、メッセージブロック全体を削除すると、subject ごとの状態が更新されず、スケジュール済みメッセージのメタデータが残ることがありました。

> - When purging whole message blocks, the subject tracking and scheduled messages are now updated correctly (#7593)

### 削除済みピアからの応答をRaftのクォーラム計算から除外

- 影響対象: ピアメンバーシップを持つRaftグループ

Raft がピアメンバーシップから削除されたノードから append-entry 応答を受信した場合、エラーのない応答が誤ってクォーラムに数えられることがありました。

> - Raft will no longer count responses from peer-removed nodes towards quorum (#7589)

### ファイルストアでの保留中書き込みの消失を修正

- 影響対象: `AsyncFlush` を設定したファイルストア

`sync_interval` における `syncBlocks` の実行と十分に長いプロセスの一時停止が重なると、保留中の書き込みが失われることがありました。`syncBlocks` は保留中の書き込みをフラッシュし、書き込みが保留中の間はブロックファイルのファイルディスクリプターを閉じないようになり、書き込みの消失を防ぎます。

> - The filestore will no longer unexpectedly lose writes when `AsyncFlush` is enabled after a process pause (#7594)

### 暗黙の確認応答のクォーラム計算でリーダーのメンバーシップを確認

- 影響対象: リーダーがメンバー外にいる Raft グループ (推定)

以前は、リーダーがメンバーでなくなった後も、クォーラムの計算でリーダーの暗黙の確認応答を数えることがありました。

> - Raft quorum counting has been refactored so the implicit leader ack is now only counted if still a part of the membership (#7600)

### Raft ピア削除時の状態の即時永続化

- 影響対象: `ProposePeerRemove` による Raft ピアの削除

以前は、リーダーが `ProposePeerRemove` でピアを削除した後に再起動すると、古いピア情報やクォーラム情報が読み込まれ、コミット済みのメンバーシップ変更が失われる可能性がありました。

> - Raft now writes the peer state immediately when handling a peer-remove to ensure the removed peers cannot unexpectedly reappear after a restart (#7602)

### 複製ストリームの破棄ポリシーによる不整合を修正

- 影響対象: `DiscardNewPerSubject` と `MaxMsgsPerSubject` を設定した複製ストリーム

スナップショットの追いつき処理中に、スナップショット取得後にメッセージが削除され、その破棄ポリシーによって発行がブロックされているサブジェクトにクライアントが繰り返しメッセージを発行すると、追いつき中のフォロワーが同じシーケンス番号に別のメッセージを保存し、ほかのサーバーと不整合になることがありました。リーダーは、破棄ポリシーに適合しないメッセージをフォロワーに提案する前に拒否するようになり、不整合が起きる可能性が低くなりました。

> - The `DiscardNewPerSubject` retention policy is now enforced by the leader before proposing rather than by individual replicas, reducing the potential for stream desync (#7607)

### Raftによる最後のピア削除の拒否

- 影響対象: 最後に残ったピアを対象とするRaftのピア削除操作

従来は削除が受け入れられ、クラスターが無効な状態になる可能性がありました。現在は、そのピアはメンバーシップに残ります。

> - Raft will no longer allow peer-removing the one remaining peer (#7610)

### 大規模なコンパクション中の Filestore メッセージ損失の修正

- 影響対象: コンパクション中の Filestore ブロック

コンパクションによってファイルのストレージの半分を超える量が回収された場合、切り詰め後、コンパクション済みのデータがすべて書き込まれる前に強制終了すると、メッセージが失われる可能性がありました。現在は、コンパクション済みのデータを別のファイルに書き込んでから、元のファイルとアトミックに置き換えます。

> - Compactions that reclaim over half of the available space now use an atomic write to avoid losing messages if killed (#7627)

### Raft のピアセットで削除済みリーダーを再登録しない修正

- 影響対象: ピアの削除とリーダーシップ移譲が進行中の Raft グループ

ピアの削除がコミットされた後、リーダーシップの移譲が処理される前にハートビートが発生すると、フォロワーがピアセット内に削除済みリーダーを再作成することがありました。この順序で発生しても、再作成されなくなりました。

> - Raft groups should no longer readmit a previously removed peer if a heartbeat occurs between the peer removal and the leadership transfer (#7649)

### レプリケートされたファイルベースのストリームのスナップショット同期ずれの修正

- 影響対象: レプリケートされたファイルベースのストリーム

ストリームのスナップショット中にメッセージを削除すると、ストリームの同期がずれる可能性がありました。また、スナップショット処理中の削除は拒否されていました。

> - Potential stream desyncs that could happen during stream snapshotting have been fixed (#7655)

### 破損した MQTT 保持メッセージのキャッシュ本文を修正

- 影響対象: 保持メッセージのキャッシュを使用するクラスター構成の MQTT デプロイメント

一致する MQTT サブスクリプションの開始後に S-2 が保持メッセージをキャッシュしていた場合、同じ subject に対する新しい保持メッセージが S-1 から届くと、キャッシュされた本文に余分な `\r\n` やランダムなデータが残ることがありました。新しい本文をキャッシュにコピーし、末尾の `\r\n` を削除するようになりました。

> - A bug which could corrupt retained messages in clustered deployments has been fixed (#7622)

### 再起動後の MQTT QoS2 メッセージ配信の修正

- 影響対象: MQTT QoS2 サブスクリプション

サーバーの再起動後にサブスクリプションを再起動すると、オフライン中に永続化されたメッセージも、新たに届くメッセージも受信できませんでした。現在は、永続化されたメッセージを取得し、新しいメッセージも受信できます。

> - A bug where QoS2 messages could not be retrieved after a server restart has been fixed (#7643)

### サブジェクト変換を伴うアカウント間 MQTT 保持メッセージの修正

- 影響対象: 別アカウントをソースとする、サブジェクト変換付きの MQTT 保持メッセージストリーム

復旧時には、ストリームメッセージのサブジェクトからプレフィックスを取り除いて、トピックとサブジェクトが再作成されます。

> - Retained messages will now work correctly even when sourced from a different account and has a subject transform (#7636)

### JetStream の確認応答における `@<subject>` サフィックス重複の修正

- 影響対象: ゲートウェイとルートまたはリーフを経由する通信があり、ローカルサブスクリプションにキャプチャされたストリームインポートを使う JetStream 構成

確認応答の返信がゲートウェイを越え、ローカルサブスクリプションにキャプチャされたストリームインポートが使われ、その返信がさらにルートまたはリーフを経由した場合、サフィックスの重複によってプロトコルエラーが発生していました。

> - A protocol error caused by an invalid transform of acknowledgement reply subjects when originating from a gateway connection has been fixed (#7579)

### JetStream スナップショット処理での割り当て・ノード欠落時の panic 解消

- 影響対象: 割り当てまたはノードが欠落しているストリームの JetStream スナップショット処理

panic する代わりに `errCatchupStreamStopped` を返します。

> - A panic when processing snapshots with missing nodes or assignments has been fixed (#7588)

### ほぼ空の Filestore ストリームにおけるシーケンス復旧の修正

- 影響対象: シーケンス 2 まで compaction または purge された、ほぼ空の Filestore ストリーム

サーバーが compaction または purge の後、tombstone を書き込む前に強制終了された場合、シーケンスを復旧できませんでした。この状況で復旧できるよう、tombstone が書き込まれるようになりました。

> - Tombstones are now correctly written for recovering the sequences after compacting or purging an almost-empty stream to seq 2 (#7627)

### Filestore の空ブロック上書きの修正

- 影響対象: filestore ストリーム

`SkipMsg(seq)`、`Compact(seq)`、`SkipMsg(seq+1)` の後、空ブロックに対してもう一度 `SkipMsg(seq+1)` を実行すると、ファイル先頭のデータが上書きされ、ディスク上のファイルが破損したように見えるとともに、`indexCacheBuf corrupt record state` がログに記録されることがありました。この一連の操作を行っても、誤ったオフセットでブロックが上書きされたり、破損エラーが発生したりしなくなりました。

> - Combining skip sequences and compactions will no longer overwrite the block at the wrong offset, correcting a `corrupt record state` error (#7627)

### Raft ピア追加時に互いに重ならない過半数が生じる問題の修正

- 影響対象: ネットワーク分断中にピアを追加する Raft グループ

ネットワーク分断中にピアを追加すると、Raft グループ内に互いに重ならない過半数が残ることがありました。

> - Add peer operations to Raft can no longer result in disjoint majorities (#7632)

### Filestore の圧縮で古いシーケンスと削除マップ項目を修正

- 影響対象: 圧縮中の Filestore メッセージブロック

圧縮時に最後のシーケンスが小さくなった後も `mb.last.seq` が高い値のままになり、削除済みの末尾エントリーが `mb.dmap` に残ることがありました。その結果、インデックスが不整合になり、「no idx present」エラーが発生してリロードが必要になる場合がありました。現在は、必要に応じて最後のシーケンスを更新し、末尾の削除エントリーを整理します。

> - Filestore compaction now correctly adjusts the high and low sequences for a message block, as well as cleaning up the deletion map accordingly (#7634)

### スナップショット中の `syncBlocks` スケジューリングの修正

- 影響対象: `syncBlocks` を使用するファイルストア

スナップショット中に `syncBlocks` が実行されると、サーバーを再起動するまで再度実行されませんでした。

> - Potential stream desyncs that could happen during stream snapshotting have been fixed (#7655)

### 保持メッセージの権限チェックで発生するパニックの修正

- 影響対象: MQTT の保持メッセージに対する権限チェック (推定)

アカウントまたはユーザーを更新する設定の再読み込み中、保存済みの保持メッセージへのアクセスに必要な権限をユーザーが持っていない場合、権限が一切定義されていない場合も含め、チェック時にパニックが発生することがありました。

> - Fixed a panic that could occur when reloading config if the user did not have permission to access retained messages (#7596)

### 非 JetStream リーフアカウント経由の MQTT JetStream API マッピング修正

- 影響対象: JetStream を利用できないリーフアカウントから、JetStream を有効にしたハブアカウントへマッピングされた MQTT アカウント

JetStream を利用できないリーフアカウントで `JS.API.>` を JetStream を有効にしたハブ上の `JS.HUB.API.>` にマッピングしている場合、以前はリクエストにマッピングが適用されないまま送信され、MQTT クライアントが接続できませんでした。現在はマッピングを適用した状態でサーバーを経由するため、クライアントが接続できます。

> - Fixed account mapping for JetStream API requests when traversing non-JetStream-enabled servers (#7598)

### QoS0 MQTT トピックのアカウント間サブジェクトマッピングへの対応

- 影響対象: アカウント間のインポート／エクスポートでサブジェクトマッピングを使用する QoS0 MQTT パブリッシャーおよびコンシューマー

以前は、アカウント A から `foo/x` にパブリッシュすると、アカウント B にはマッピング後の `bar/x` ではなく `foo/x` として届いていました。現在、コンシューマーには `bar/x` のような、マッピング後のサブジェクトに対応するトピックが届きます。

> - QoS0 messages are now mapped correctly across account imports/exports with subject mappings (#7605)

### MQTT の保持メッセージ復元時におけるメッセージ数の確認

- 影響対象: MQTT の保持メッセージ復元 (推定)

再起動後、シーケンス番号に欠落があると、保持メッセージがすべて復元されていても、復元完了チェックがタイムアウトすることがありました。

> - Loading retained messages no longer fails after restarting due to last sequence checks (#7616)

### ファイルベースのストリームキャッシュ向けの可変ポインター

- 影響対象: ファイルベースのストリーム

ガベージコレクション中やメモリに負荷がかかっているとき、サーバーは filestore キャッシュを早期に破棄できるため、メモリを OS に返却し、メモリ不足の回避に役立ちます。アセット数やパブリッシュ／アクセスのパターンによって、報告される RSS は低くなる場合も高くなる場合もあります。

> -
> Elastic pointers in the filestore: File-based streams now use elastic pointers for its write-through caches. This allows the server to better respond during garbage collection, these caches can be evicted early to avoid out-of-memory conditions (see upgrade considerations below).
> -
> With the new elastic pointers in the filestore, it is expected that a NATS Server running 2.12 may show a different memory usage pattern to before. In some systems this may result in lower resident set size (RSS) reported, in others it may result in higher, depending on the number of assets and publish/access patterns.

https://docs.nats.io/release-notes/whats_new/whats_new_212

### メモリ逼迫時の filestore キャッシュ解放

- 影響対象: filestore キャッシュを使用する NATS Server の構成

必要に応じてキャッシュを解放することで、利用率の急上昇によってメモリ不足の強制終了が発生する可能性を低減できます。リソースに余裕がある場合は、読み取りアクセスを高速化するため、キャッシュをより積極的に保持できます。

> For the first time, the server will be able to respond to memory pressure by freeing filestore caches on demand and returning the memory to the operating system. This reduces the chance that sudden spikes in utilisation will result in an out-of-memory (OOM) kill. However, this means that the server can more optimistically retain caches in memory when available resources allow in order to facilitate improved read access times.

https://docs.nats.io/release-notes/whats_new/whats_new_212

## 機能・改善 (13)

- WebSocket ping 間隔の設定 (利用条件: `websocket` ブロックのゼロ以外の `ping_interval`)
- ストリームのアトミックなバッチ発行 (利用条件: ストリーム設定オプション `AllowAtomicPublish`)
- ストリームのカウンター加算・減算の仕様 (利用条件: `AllowMsgCounter` ストリーム設定オプション)
- ストリームメッセージのスケジューリング (利用条件: `AllowMsgSchedules` ストリーム設定オプション)
- プルコンシューマー向け優先順位付きポリシー
- `server_metadata` マップの追加
- ミラーリングストリームのプライマリへの昇格
- クラスタールートとゲートウェイの再接続における指数バックオフ (利用条件: クラスタールートまたはゲートウェイで `connect_backoff` を `true` に設定)
- グローバルアカウントからのシステムイベント
- NATS サーバー統計情報への `GOMAXPROCS` と `GOMEMLIMIT` の追加
- サブジェクト全体を使う `partition(n)` と `random(n)` の変換関数
- `isolate_leafnode_interest` によるリーフノードの interest 分離
- 設定再読み込みによるリモートリーフノードの無効化 (利用条件: 設定再読み込みで `disabled: true` を設定すること)

## 依存関係の更新 (8)

ほか8件（いずれもセキュリティへの言及なし）

- `- 1.25.5 (#7604)`
- `- github.com/google/go-tpm v0.9.7 (#7578)`
- `- github.com/nats-io/nkeys v0.4.12 (#7578)`
- `- golang.org/x/crypto v0.45.0 (#7578)`
- `- github.com/klauspost/compress v1.18.2 (#7604)`
- `- github.com/antithesishq/antithesis-sdk-go v0.5.0-default-no-op (#7604)`
- `- golang.org/x/crypto v0.46.0 (#7648)`
- `- golang.org/x/sys v0.39.0 (#7648)`

## その他の変更 (11)

- サブジェクトでフィルタリングされたソースのシーケンススキャン高速化
- JetStream メタレイヤーでの復旧操作のステージングと重複排除
- JetStream コンシューマーの interest チェックの高速化
- クラスターモードでのストリーム作成時のデータ競合を修正
- Filestore のセキュア消去におけるサブジェクト追跡の維持
- ストリームヘルスチェックにおけるレプリカ読み取りの読み取りロックによる保護
- Filestore キャッシュの `errNoCache` 発生時の期限切れ
- シーケンス不一致時の Filestore インデックス再構築と読み込み再試行
- v2.12 の機能を使用するストリームとコンシューマーのダウングレード時の非対応扱い
- レプリケートストリームのデータの非同期ディスク書き込み
- JetStream の strict mode のデフォルト有効化

---

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