# etcd v3.5.26

2025-12-17 · [릴리스 노트 원문](https://github.com/etcd-io/etcd/releases/tag/v3.5.26) · [전체 정리](https://ratatosk.io/ko/releases/etcd/v3.5.26)

보안 2 · 중요 수정 1 · 의존성 갱신 1 · 기타 4

## 업그레이드 전 확인

### 업그레이드 안내

- **호환성을 깨뜨릴 수 있는 변경에 대한 업그레이드 안내**
  > Please check out [CHANGELOG](https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md) for a full list of changes. And make sure to read [upgrade guide](https://etcd.io/docs/v3.5/upgrades/upgrade_3_5/) before upgrading etcd (there may be breaking changes).

## 보안 (2)

### etcd 인증 로그에서 원본 토큰 제거

- 영향 대상: JWT 및 simple-token 흐름의 etcd 인증 로그 (추정)

이전에는 이 로그 메시지에 원본 토큰이 기록됐지만, 이제는 SHA-256 해시의 첫 12개 16진수 문자를 `token-fingerprint`로 기록합니다.

> - [Print token fingerprint instead of the original tokens in log messages](https://github.com/etcd-io/etcd/pull/20942)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

### SSH Agent 및 GSSAPI 요청 처리 결함 수정

- 영향 대상: `golang.org/x/crypto/ssh/agent`를 새 아이덴티티 요청에 사용하거나 `golang.org/x/crypto/ssh`를 GSSAPI 인증 요청에 사용하는 구성
- [CVE-2025-47914](https://www.cve.org/CVERecord?id=CVE-2025-47914), [CVE-2025-58181](https://www.cve.org/CVERecord?id=CVE-2025-58181)

형식이 잘못된 새 아이덴티티 요청은 SSH Agent 서버에서 패닉을 일으킬 수 있었고, GSSAPI 인증 요청은 SSH 서버의 메모리 사용량을 제한 없이 늘릴 수 있었습니다. `golang.org/x/crypto`를 수정된 버전인 0.45.0으로 업그레이드했습니다.

> - Bump [golang.org/x/crypto to 0.45.0 to address CVE-2025-47914, and CVE-2025-58181](https://github.com/etcd-io/etcd/pull/21023).

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

## 중요 수정 (1)

### 오래된 `v3store` 멤버 항목 정리

- 영향 대상: `v3store`의 etcd 클러스터 멤버십

버전이 `v3.4.39` 이하인 `etcdctl snapshot restore`로 스냅샷을 복원한 뒤, 또는 설명된 크래시 시나리오에서 `v3.5.22` 미만 버전으로 `ForceNewCluster`를 재시작한 뒤 오래된 항목이 남을 수 있었습니다. etcd가 로컬 멤버 속성을 갱신하거나 스냅샷을 적용하거나 `shouldApplyV3`가 true인 `ConfChange`를 적용하면 해당 항목이 삭제됩니다.

> - Fix [zombie members in v3store](https://github.com/etcd-io/etcd/pull/20995)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `- Compile binaries using [go 1.24.11](https://github.com/etcd-io/etcd/pull/20999).`

## 기타 (4)

- v3.5.26용 macOS 설치 예제 업데이트
- Docker 설치 문서에서 기본 및 보조 레지스트리 명시
- Docker 예제에서 etcd v3.5.26 실행
- 스냅샷 명령 도움말의 `etcdutl` 표기 수정

---

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