# Meshery v1.0.10

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

호환성 변경 7 · 중요 수정 2 · 기능·개선 1 · 의존성 갱신 4 · 기타 10

## 호환성 변경 (7)

### 로컬 서버 평가의 기본 엔진으로 Go 정책 엔진 사용

- 영향 대상: Makefile의 `server` 타깃으로 시작한 로컬 서버 (추정)

> - make go engine default for evaluation in local server @aabidsofi19 (#18781)

### 로그인 후 리디렉션 검증으로 인증 경로 대상 거부

- 영향 대상: 로그인 후 리디렉션 처리 (추정)

로그인 후 ref가 `/user/login`, `/auth/login`, `/api/user/token`, `/provider` 또는 그 하위 경로를 가리키면 인증이 다시 시작되어 브라우저에서 리디렉션 루프가 발생하고, 원래 목적지가 조용히 사라질 수 있었습니다. 이제 이러한 ref는 `/`로 해석됩니다.

근거: “`resolvePostLoginRedirect` accepted `/user/login`, `/api/user/token`, and `/provider` as valid redirect targets. When `TokenHandler` finished a token exchange but carried a ref pointing at one of those — e.g. after the cloud-side `SaveConnection` 500'd on a `user_id NOT NULL` violation and the client restarted auth — the post-login redirect re-entered `InitiateLogin` and the browser looped, silently losing the original destination.” https://github.com/meshery/meshery/pull/18851

> - fix(auth,extensions): close extension load loop and quiet local-dev log noise @jamieplu (#18851)

### 로컬 make 기반 서버의 빈 `ADAPTER_URLS` 기본값

- 영향 대상: 기본 `ADAPTER_URLS` 목록을 사용하는 로컬 make 기반 서버 구성 (추정)

이전에는 어댑터가 실행 중이 아닐 때 기본 목록으로 인해 연결 거부 오류가 발생했습니다. 이제 서버는 기본적으로 해당 어댑터에 연결을 시도하지 않습니다. 어댑터 주소는 `ADAPTER_URLS`를 통해 지정할 수 있습니다.

근거: “ADAPTER_URLS ?= ""” https://github.com/meshery/meshery/pull/18851

> - fix(auth,extensions): close extension load loop and quiet local-dev log noise @jamieplu (#18851)

### 빈 `OTEL_CONFIG`일 때 서버 트레이싱 기본 비활성화

- 영향 대상: 기본 `OTEL_CONFIG`를 사용하는 로컬 make 기반 서버 설정 (추정)

이전에는 수신 대기 중인 collector가 없어도 시작 시 localhost:4317로 내보내기를 시도해 연결 거부 오류가 반복해서 발생했습니다. `OTEL_CONFIG`가 비어 있지 않으면 트레이싱은 계속 초기화됩니다.

> - fix(auth,extensions): close extension load loop and quiet local-dev log noise @jamieplu (#18851)

### 패턴 가져오기에서 유효한 변형 하나만 허용

- 영향 대상: `/api/pattern/import`를 호출하는 클라이언트

이전에는 두 변형을 모두 포함한 요청에서 URL을 사용했고, 두 변형이 모두 없는 요청에서는 파일을 사용했습니다. 이제 두 경우 모두 명시적인 메시지와 함께 HTTP 400을 반환합니다.

근거: “The new contract: - **File variant** — requires base64-encoded `file` + `file_name` - **URL variant** — requires `url` - **Exactly one of the two** must be present. Both-set / neither-set requests previously fell through to "URL wins if present, otherwise File"; they now return `400` with an explicit message.” https://github.com/meshery/meshery/pull/18845

> - server: adopt MesheryPatternImportRequestBody schema type + enforce oneOf contract @jamieplu (#18845)

### `ExtensionProxy`의 원격 provider 오류 응답 보존

- 영향 대상: 원격 provider를 대상으로 하는 extension API 호출 (추정)

이전에는 원격 provider가 2xx가 아닌 응답을 반환하면 `ExtensionProxy`가 본문을 버리고 일반적인 500 응답을 반환했습니다. 그 결과 클라이언트가 오류를 JSON으로 파싱하려고 할 수 있었습니다. 이제 provider의 본문과 상태 코드가 변경 없이 전달됩니다.

근거: “`ExtensionProxy` now returns the remote provider's response faithfully for all status codes instead of dropping non-2xx bodies and wrapping them in a generic error.” https://github.com/meshery/meshery/pull/18803

> - fix(extensions): forward upstream responses and return JSON errors @alexquincy (#18803)

### `ExtensionsHandler` 전송 실패 시 상태 코드 500의 JSON 응답

- 영향 대상: 확장 엔드포인트 응답을 JSON으로 파싱하는 클라이언트 (추정)

원격 프로바이더에 연결할 수 없을 때 `ExtensionsHandler`는 RTK Query가 JSON으로 파싱할 수 없는 일반 텍스트 `Error: ...` 응답 본문을 반환했습니다. 업스트림 프로바이더의 2xx가 아닌 응답은 원래 상태 코드와 본문이 그대로 전달됩니다.

근거: “`ExtensionsHandler` now returns transport failures as `{"error": "..."}` JSON instead of a plain-text `Error: ...` body, so clients using `fetch`/RTK Query can parse it.” https://github.com/meshery/meshery/pull/18803

> - fix(extensions): forward upstream responses and return JSON errors @alexquincy (#18803)

## 중요 수정 (2)

### 확장 아이콘 URL 정규화 수정

- 영향 대상: /로 시작하는 확장 아이콘 경로 (추정)

확장 프로그램의 `item.icon` 경로가 `/`로 시작하면 URL을 만들 때 슬래시가 하나 더 붙어 브라우저가 같은 에셋을 두 번 요청했고, 그중 한 요청은 무기한 멈출 수 있었습니다. 이제 `normalizeURI(item.icon)`으로 URL을 만들며, PR에서는 요청이 두 번에서 한 번으로 줄었다고 보고합니다.

> - fix(auth,extensions): close extension load loop and quiet local-dev log noise @jamieplu (#18851)

### Meshery UI의 익스텐션 CSS 하위 경로 import 해결

- 영향 대상: `tippy.js` 또는 `@xterm/xterm`에서 CSS 하위 경로를 import하는 Meshery 익스텐션

익스텐션이 `tippy.js/animations/shift-away.css` 또는 `@xterm/xterm/css/xterm.css` 같은 CSS 하위 경로를 import하면 호스트에서 해당 경로를 확인하지 못해 플러그인이 로드되지 않았습니다.

> - fix(ui): host tippy.js + xterm CSS subpaths for extensions @jamieplu (#18852)

## 기능·개선 (1)

- Kanvas 외부화를 위한 공유 의존성 제공 (사용 조건: 이 변경이 포함된 Meshery UI 릴리스가 나온 뒤에만 적용해야 하는 대응 Kanvas 측 변경)

## 의존성 갱신 (4)

그 외 4건 · 보안 언급 없음

- `- [Chore]: Update to Sistent v0.18.8 @l5io (#18799)`
- `- Bump github.com/jackc/pgx/v5 from 5.7.6 to 5.9.0 @[dependabot[bot]](https://github.com/apps/dependabot) (#18779)`
- `- Bump github.com/go-git/go-git/v5 from 5.16.5 to 5.18.0 @[dependabot[bot]](https://github.com/apps/dependabot) (#18802)`
- `- Bump github.com/moby/spdystream from 0.5.0 to 0.5.1 @[dependabot[bot]](https://github.com/apps/dependabot) (#18778)`

## 기타 (10)

- Meshery README의 서식, 문법 및 이미지 대체 텍스트 표준화
- 토큰 처리 후 Provider capabilities 캐시 사전 적재
- 사이드바 릴리스 링크 아이콘을 테마의 흰색으로 표시
- 대시보드 그리드 크기 조정 안정화
- UI ESLint 문제 수정
- 이벤트 쿼리 실패 시 빈 활동 목록을 사용하는 `WorkspaceActivityWidget`
- UI 아이콘 및 시스템 import의 `@sistent/sistent` 이전
- 프리뷰 배포 워크플로 상태 메시지
- 격주 회의 휴식 기간 안내를 반영한 빌드 및 릴리스 문서 업데이트
- 문서 홈페이지의 레이블과 링크를 Models로 변경

---

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