# Meshery v1.0.82

2026-11-18 · [릴리스 노트 원문](https://github.com/meshery/meshery/releases/tag/v1.0.82) · [전체 정리](https://ratatosk.io/ko/releases/meshery/v1.0.82)

보안 6 · 호환성 변경 6 · 중요 수정 10 · 기능·개선 2 · 기타 10

## 보안 (6)

### `MeshModelGenerationHandler` 요청 본문 크기 제한 및 검증

- 영향 대상: `MeshModelGenerationHandler`로 보내는 요청

이전에는 핸들러가 요청 본문을 크기 제한 없이 읽어 서비스 거부 및 메모리 부족 위험이 있었습니다. 이제 4MB를 초과하는 본문은 HTTP 413으로 거부합니다. 또한 컴포넌트를 생성하기 전에 본문 읽기 실패, 빈 본문, 공백만 있는 본문, null 본문 또는 빈 데이터 슬라이스에 대해 HTTP 400을 반환합니다.

> - [Server] Bound request body size and guard against DoS in MeshModelGenerationHandler @Supersaiyan101 (#23864)

### 사용자 테스트 선호도 핸들러의 nil 프로바이더 패닉 수정

- 영향 대상: 서버 사용자 테스트 선호도 엔드포인트

`UserTestPreferenceStore`, `UserTestPreferenceGet` 또는 `UserTestPreferenceDelete`를 nil 프로바이더로 호출하면 nil 역참조로 패닉이 발생할 수 있었습니다. 이제 이 핸들러는 구조화된 `ErrNilProvider` 오류와 HTTP 500을 반환합니다.

> - [Server] Guard unchecked nil provider dereferences, nil logger panics, and unbounded body reads in UserTestPreference handlers @Amansingh0807 (#23861)

### 대용량 `UserTestPreferenceStore` 요청 본문 크기 제한

- 영향 대상: `UserTestPreferenceStore` 엔드포인트

이전에는 핸들러가 크기 제한을 넘는 요청 본문 전체를 읽을 수 있었습니다. 이제 4 MiB를 초과하는 본문에는 전체를 읽고 처리하는 대신 HTTP 413을 반환합니다.

> - [Server] Guard unchecked nil provider dereferences, nil logger panics, and unbounded body reads in UserTestPreference handlers @Amansingh0807 (#23861)

### `UserTestPreference` nil 로거 패닉 수정

- 영향 대상: nil 로거로 실행될 수 있는 `UserTestPreference` 핸들러 (추정)

이 핸들러에서 nil 로거에 로깅을 호출하면 패닉이 발생할 수 있었습니다.

> - [Server] Guard unchecked nil provider dereferences, nil logger panics, and unbounded body reads in UserTestPreference handlers @Amansingh0807 (#23861)

### `UserTestPreferenceHandler`의 미지원 메서드 거부

- 영향 대상: 사용자 테스트 기본 설정 엔드포인트

클라이언트가 엔드포인트에 지원되지 않는 메서드를 보내면 JSON 형식의 HTTP 405 응답을 받습니다.

> - [Server] Guard unchecked nil provider dereferences, nil logger panics, and unbounded body reads in UserTestPreference handlers @Amansingh0807 (#23861)

### 서버 측 URL 가져오기를 공개 대상으로 제한

- 영향 대상: Meshery Server에서 디자인, 필터 또는 패턴을 위한 URL 가져오기

사설, 루프백, 링크 로컬 및 예약된 대상은 리디렉션을 거쳐 도달하는 경우에도 차단됩니다. 응답 크기는 10 MiB로 제한됩니다. 필터와 패턴은 리디렉션을 최대 5회, 제한 시간을 30초까지 허용하며, 디자인은 리디렉션을 최대 10회, 제한 시간을 60초까지 허용합니다.

> - [Server] Restrict filter URL imports to public destinations @itsCodeTide (#23874)

## 호환성 변경 (6)

### MeshSync 플러시의 캐시 보존 및 리싱크 시 nil 핸들러 오류

- 영향 대상: Kubernetes 연결의 MeshSync 플러시 작업 및 `ResyncMeshsync()` 호출

연결이 끊긴 Kubernetes 연결을 플러시하면 이전에는 캐시된 리소스가 삭제될 수 있었지만, 이제는 리소스를 삭제하지 않고 HTTP 409를 반환합니다. MeshSync 데이터 핸들러가 nil이면 `ResyncMeshsync()`는 명시적인 오류를 반환합니다.

근거: “Return HTTP `409 Conflict` with a descriptive error when a flush is requested for a disconnected connection.” https://github.com/meshery/meshery/pull/23846

> - [Server] Fix MeshSync flush handling for disconnected connections and nil handler @Nixantsingh943 (#23846)

### `mesheryctl model search` 추가 위치 인수 거부

- 영향 대상: `mesheryctl model search` (추정)

이전에는 `aws ec2`처럼 따옴표로 묶지 않은 위치 인수를 추가로 전달하면 `aws`를 검색하고 성공적으로 종료했습니다. 이제 잘못된 인수 오류를 반환합니다. 인수 하나만 전달하는 검색과 여러 단어를 따옴표로 묶은 검색은 계속 작동합니다.

근거: “Keep the existing missing-name error for zero arguments, single-argument searches, and quoted multi-word searches unchanged.” https://github.com/meshery/meshery/pull/22565

> - [mesheryctl] Validate model search positional arguments @Karman580 (#22565)

### CLI의 불완전한 성능 프로파일 조회 및 삭제 차단

- 영향 대상: CLI 성능 프로파일 조회 및 삭제 (추정)

순회 도중 일치하는 프로파일이 바뀌거나 페이지네이션 데이터가 일관되지 않으면 CLI가 일부 일치 항목만 반환하거나 삭제를 진행할 수 있었습니다. 이제 CLI는 오류를 반환하고 삭제를 중단합니다.

근거: “Profiles were added, deleted, or reordered during lookup, or the provider returned inconsistent pagination data” https://github.com/meshery/meshery/pull/22775

> - [mesheryctl] Fix profile lookup when paginating performance results @FayezBast (#22775)
> - [mesheryctl] Fix profile lookup when paginating performance results @FayezBast (#22775)

### Meshery CLI의 미구성 어댑터 검사 거부

- 영향 대상: 현재 컨텍스트에서 Meshery CLI 어댑터 검사

이전에는 요청한 이름과 일치하는 구성된 어댑터가 없으면 명령이 “No components configured in current context”를 출력하고 종료 코드 0으로 끝났습니다. 따라서 이름을 잘못 입력했거나 배포되지 않은 어댑터도 검사를 통과한 것처럼 보였습니다. 이제는 잘못된 인수 오류를 반환하고 종료 코드 1로 끝납니다. 구성된 어댑터는 이름이나 위치로 계속 검사할 수 있습니다.

근거: “when a specific adapter was requested and none matched, return `utils.ErrInvalidArgument` with `adapter "<name>" is not configured in the current context`.” https://github.com/meshery/meshery/pull/23849

> - [mesheryctl] Fail system check --adapter for an adapter that is not configured @Eternity0207 (#23849)

### `mesheryctl` Kubernetes 로그 레이블에 파드 및 컨테이너 이름 추가

- 영향 대상: `mesheryctl`로 가져오거나 추적하는 Kubernetes 로그 (추정)

버퍼링된 로그 항목과 스트리밍 로그 항목에 이 레이블이 사용되어, 각 항목을 어느 컨테이너가 생성했는지 더 명확해집니다.

근거: “Prefix Kubernetes logs with both pod and container names in snapshot and follow modes.” https://github.com/meshery/meshery/pull/23847

> - [mesheryctl] Include container names in Kubernetes logs @itsCodeTide (#23847)

### Grafana 및 Prometheus 대용량 응답에 오류 반환

- 영향 대상: Meshery의 Grafana 및 Prometheus 텔레메트리 통합

업스트림 응답이 16 MiB를 초과하면 이전에는 클라이언트가 처음 16 MiB를 성공 응답으로 반환해 유효하지 않은 JSON이 생성될 수 있었습니다. 이제 클라이언트는 부분 본문 없이 명시적인 오류를 반환하며, 텔레메트리 UI에는 오류 세부 정보와 권장 다음 단계가 표시됩니다.

근거: “This PR fixes Grafana and Prometheus responses over 16 MiB being silently truncated, which could produce invalid JSON.” https://github.com/meshery/meshery/pull/22762

> - fix(server):Reject oversized telemetry responses @FayezBast (#22762)
> - fix(server):Reject oversized telemetry responses @FayezBast (#22762)

## 중요 수정 (10)

### [드러나지 않던 결함] 정책 및 관계 처리에서 배열 와일드카드 경로 해석

- 영향 대상: 와일드카드 경로로 배열 요소를 대상으로 지정하는 정책 또는 선언적 관계

이 수정 전에는 배열 대상을 향한 정방향 뮤테이션이 알림 없이 누락될 수 있었고, 관계를 삭제해도 변경된 필드가 설계 문서에 남을 수 있었습니다. 이제 매칭과 뮤테이션에서 와일드카드 경로를 해석하며, 삭제 시 정리 작업도 동일하게 해석된 값을 대상으로 할 수 있습니다.

> - [Server] Resolve array wildcard paths during policy mutation and deletion cleanup @nishant-devv (#23670)

### 시스템 재설정으로 저장된 현재 컨텍스트가 더 이상 바뀌지 않음

- 영향 대상: 현재 컨텍스트가 아닌 컨텍스트를 지정한 `mesheryctl system reset --context` 사용 (추정)

이전에는 `X`를 재설정하면 해당 컨텍스트도 `current-context`로 저장되어, 한 명령에만 사용하려던 컨텍스트가 이후 명령에서도 선택된 상태로 남았습니다. `--context`를 지정하지 않으면 동작은 변경되지 않습니다.

> - [mesheryctl] Keep the current context when system reset uses --context @Eternity0207 (#23653)

### Meshery UI 쿼리 매개변수 직렬화 수정

- 영향 대상: 선택적 또는 배열 쿼리 매개변수에 대해 Meshery UI `fetchViews` 요청을 보내거나 `urlEncodeArrayParam`을 사용하는 경우

`visibility` 같은 선택적 매개변수를 생략하면 배열 매개변수에 nullish 가드가 없어 잘못된 쿼리 문자열이 생성될 수 있었습니다. 이제 해당 요청은 빈 쿼리 구간을 생략하고, 배열 키와 값을 인코딩하며, 잘못된 `?&` 접두부를 방지합니다. 매개변수가 없으면 쿼리 문자열도 추가하지 않습니다.

> - [UI] Guard urlEncodeArrayParam against undefined input and prevent malformed query strings @madhavzanwar (#23674)

### 패턴 핸들러의 nil provider 및 nil user 오류 처리 수정

- 영향 대상: 패턴 소스 및 클론 핸들러

두 핸들러 모두 provider가 nil인 상태에서 요청을 받으면 nil 포인터 역참조 대신 HTTP 500을 반환합니다. 패턴 소스 핸들러는 user가 nil인 요청을 받으면 HTTP 401을 반환합니다.

> - [Server] Guard nil provider, validate path UUIDs, and propagate status codes in pattern handlers @patelshivani2283-lab (#23891)

### 패턴 핸들러 오류 상태 코드에 provider 오류 반영

- 영향 대상: 패턴 소스 조회·복제·다운로드 핸들러

이전에는 provider 작업에서 오류가 발생해도 provider 오류의 상태 코드와 관계없이 이 핸들러들이 HTTP 404 또는 500을 하드코딩해 반환했습니다. 이제는 `providerStatusOrInternal(err)`에서 반환하는 상태 코드를 사용합니다.

> - [Server] Guard nil provider, validate path UUIDs, and propagate status codes in pattern handlers @patelshivani2283-lab (#23891)

### nil 검사로 보호되는 패턴 핸들러 로깅

- 영향 대상: `h.log` 로거가 nil인 패턴 핸들러 (추정)

이전에는 해당 핸들러에서 로거를 호출할 때 nil 검사를 하지 않았습니다.

> - [Server] Guard nil provider, validate path UUIDs, and propagate status codes in pattern handlers @patelshivani2283-lab (#23891)

### Meshery 성능 프로파일의 페이지 간 조회 수정

- 영향 대상: 페이지가 나뉜 `mesheryctl perf result`에서 `--page`를 사용하는 조회

이전에는 `mesheryctl perf result NAME --page 2`를 실행했을 때, 프로파일이 해당 페이지에 없으면 실제로 존재하는 프로파일도 찾을 수 없다고 나올 수 있었습니다. 이제 프로파일은 모든 페이지에서 검색하지만, 결과는 선택한 페이지에서 가져옵니다.

> - [mesheryctl] Fix profile lookup when paginating performance results @FayezBast (#22775)

### 저장 실패 시 분석 환경설정 스위치의 저장값 복원

- 영향 대상: Meshery UI의 익명 사용 통계 또는 성능 결과 환경설정

이전에는 `POST /api/user/prefs` 요청이 실패하면 스위치가 서버에 저장되지 않은 값으로 남았습니다. 저장이 진행 중일 때는 두 스위치가 모두 비활성화되어 추가 토글이 무시됩니다. 저장에 성공하면 새 설정이 유지됩니다.

> - [UI] Turn analytics preference switches back when saving fails @mayank609 (#23640)

### `LazyComponentForm`의 가져온 컴포넌트 스키마 변경 방지

- 영향 대상: Meshery UI 디자인 중 `LazyComponentForm`이 이미 파싱된 객체 형태의 컴포넌트 스키마를 받는 경우

`rawSchema`가 이미 객체인 경우, 후속 속성 및 타입 정규화 과정에서 가져온 컴포넌트 객체가 제자리에서 변경될 수 있었습니다. 이제 폼은 얕은 복사본을 정규화합니다.

> - [UI] Shallow-copy object schema and guard array properties in LazyComponentForm @abhinavkdeval08-design (#23363)

### 연결 간 공유 Meshery Operator의 수명 주기 보호

- 영향 대상: 여러 연결이 Kubernetes 클러스터를 공유하고 Meshery Operator를 사용하는 Meshery Server 배포

이전에는 연결을 끊거나 삭제하거나 임베디드 모드로 전환할 때 `helm uninstall`이 실행되어 다른 연결에서 사용하는 오퍼레이터까지 제거될 수 있었습니다. 같은 릴리스를 동시에 설치하면 경합이 발생할 수도 있었습니다. 이제 이러한 전환을 해도 공유 오퍼레이터가 설치된 상태로 유지되며, 같은 릴리스의 배포는 클러스터별로 직렬화됩니다.

> - fix(server): keep Meshery Operator installed across shared-cluster connection lifecycle @yi-nuo426 (#23261)

## 기능·개선 (2)

- Pattern 소스 핸들러의 Helm 소스 유형 별칭 인식
- URL에서 raw `.wasm` 필터 가져오기 지원

## 기타 (10)

- MeshSync 캐시 플러시 후 리소스를 지우고 재동기화
- MeshSync 캐시 플러시 조율 변경 되돌림
- 패턴 소스 및 다운로드 핸들러에 UUID 검증 추가
- GraphQL 컨트롤 플레인 리졸버의 클러스터 조회 배치 처리
- `mesheryctl model generate --skip-registration`의 빈 응답 처리 수정
- Design 배포 프롬프트에 일치하는 각 디자인의 패턴 파일 표시
- Kubernetes Helm 업데이트 중 설정된 콜백 URL 유지
- `LazyComponentForm`의 스키마 속성 처리
- Kubernetes 리소스 조회 오류를 읽기 쉽게 표시
- 모바일 문서 콘텐츠 여백 증가

---

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