# Meshery v0.9.2

2026-03-24 · [릴리스 노트 원문](https://github.com/meshery/meshery/releases/tag/v0.9.2) · [전체 정리](https://ratatosk.io/ko/releases/meshery/v0.9.2)

보안 1 · 호환성 변경 3 · 중요 수정 4 · 의존성 갱신 3 · 기타 15

## 보안 (1)

### 로그인 리디렉션에서 안전한 앱 내부 `ref` 경로만 허용

- 영향 대상: 쿼리 매개변수 `ref`를 받는 로컬 및 원격 프로바이더 로그인 흐름

이전에는 로컬 프로바이더가 안전성 검사를 통과한 디코딩된 `ref` 값으로만 리디렉션했지만, 원격 프로바이더는 비어 있지 않은 원시 `ref` 값을 리디렉션 URL로 사용했습니다.

> - Fix:local provider boot hang @hortison (#18157)

## 호환성 변경 (3)

### 원격 프로바이더 재시도 시 요청 복제

- 영향 대상: 원격 프로바이더 요청

원격 프로바이더 요청이 HTTP 401 응답을 받은 뒤 토큰 갱신에 성공했을 때, 이전에는 재시도에 원래 요청과 본문을 재사용했습니다. 이제 재생 가능한 본문은 `GetBody`에서 다시 가져오고, 본문이 없는 요청에는 `http.NoBody`를 사용합니다. 재생할 수 없는 본문이면 오류가 발생합니다.

> - local provider boot hang @hortison (#18162)

### `mesheryctl` system 명령의 오류 전파

- 영향 대상: `mesheryctl system context` 및 `mesheryctl system check` 사용

영향을 받는 오류 경로가 발생하면 이 명령들은 오류를 로그에 남긴 뒤 nil을 반환해, 실패가 감춰지고 성공 종료 코드가 반환될 수 있었습니다. 이제 오류를 CLI에 반환하므로 명령이 실패를 보고합니다.

> - fix(mesheryctl): return proper error in system context command @Omkar-Ugal (#18154)

### 원격 프로바이더 토큰 갱신 시 비-200 응답 거부

- 영향 대상: 원격 프로바이더 토큰 갱신 (추정)

이전에는 HTTP 500만 명시적인 오류를 반환했고, 다른 상태 코드는 토큰 응답 디코딩을 진행했습니다. 이제 모든 비-200 응답이 상태 코드와 읽을 수 있는 경우 앞뒤 공백을 제거한 응답 본문을 포함해 오류를 반환합니다.

근거: “- if r.StatusCode == http.StatusInternalServerError { - return "", ErrTokenRefresh(fmt.Errorf("failed to refresh token. Status code 500")) - }” https://github.com/meshery/meshery/pull/18162

> - local provider boot hang @hortison (#18162)

## 중요 수정 (4)

### [드러나지 않던 결함] Meshery UI Node.js 엔진 범위 수정

- 영향 대상: Node.js를 사용하는 Meshery UI 설치 또는 빌드 (추정)

ESLint와 Next.js 툴체인 업그레이드로 Node 18 및 초기 Node 20.x에서 설치와 빌드가 오류 메시지 없이 실패했습니다. 이제 UI 패키지에 Node.js 엔진 범위로 `^20.19.0 || ^22.13.0 || >=24`가 명시됩니다.

> - fix(ui): update engines.node to match ESLint 10 and Next 16 requirements @[copilot-swe-agent[bot]](https://github.com/apps/copilot-swe-agent) (#18164)

### 리모트 프로바이더 401 처리에서 갱신 불가 토큰의 리프레시 생략

- 영향 대상: 리모트 프로바이더 요청

요청의 토큰이 비어 있거나 디코딩할 수 없거나, 비어 있지 않은 refresh token이 없는 상태에서 401 응답을 받으면 원래 응답을 반환합니다.

> - local provider boot hang @hortison (#18162)

### 원격 프로바이더 토큰 갱신 시 공백 제거 및 빈 값 거부

- 영향 대상: 원격 프로바이더 토큰 갱신

이전에는 캐시된 토큰과 반환된 `TokenCookieName` 값에 앞뒤 공백이 있어도 그대로 사용했습니다. 갱신된 값이 비어 있거나 누락된 경우에도 저장하고 반환했습니다.

> - local provider boot hang @hortison (#18162)

### 로컬 프로바이더 UI 부트스트랩 멈춤 수정

- 영향 대상: 부트스트랩 중인 Meshery UI 세션(로컬 프로바이더 부팅 포함)

UI가 부트스트랩 중 멈출 수 있었습니다. 이제 부트스트랩 실패가 로그에 기록되고, 초기화가 완료되거나 예외가 발생하면 외부 로더가 해제됩니다. 세션 초기화가 10초 넘게 로딩 상태로 유지되면 초기화가 느리다는 메시지가 표시되고, 경고가 15초마다 반복됩니다.

> - Fix:local provider boot hang @hortison (#18157)

## 의존성 갱신 (3)

그 외 3건 · 보안 언급 없음

- `- [UI] Chore Sistent v0.18.0 @hortison (#18172)`
- `- upgrade/react 19, next 16, eslint 10 @hortison (#18163)`
- `- Chore: Upgrade to meshery/schemas v0.9.0 @hortison (#18152)`

## 기타 (15)

- Preference-persister 테스트에 Given/When/Then 코멘트와 데이터베이스 정리 추가
- UI TypeScript 린트 설정 및 억제 항목 조정
- UI 빌드 도구를 `webpack`에서 `turbopack`으로 전환
- `next.config.js`에서 지원 중단 예정이던 `eslint` 키 제거
- 레지스트리 트리 뷰의 `SimpleTreeView` 및 v8 API 마이그레이션
- UI TypeScript deprecation 오류 무시 설정
- 컴포넌트 정의 조회 실패를 디버그 레벨로 기록
- ESLint 미사용 변수 규칙의 파일 유형별 분리
- Meshery UI 사용자 및 시스템 이벤트 요청의 API 엔드포인트 사용
- 서버 JSON 응답 헤더 및 identity-profile 라우트 별칭
- 브라우저 세션마다 `getLoggedInUser` 캐시 항목 하나
- 세션이 없을 때 기본 설정을 더 이상 저장하지 않음
- UI 파일 전반의 TypeScript 린팅 업데이트
- Meshery Code Contributor 에이전트에 PostgreSQL 도구 추가
- 모델 페이지의 관련 모델 및 추천 읽을거리 섹션 업데이트

---

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