@intlayer/docs 9.5.5 → 9.5.7

package/docs/ko/benchmark/nextjs.md

@@ -112,19 +112,19 @@ Webpack이나 Turbopack을 사용하고 `generateStaticParams`가 정의되어
 이 벤치마크에서는 다음과 같은 라이브러리를 비교했습니다:
 
 - `Base App` (i18n 라이브러리 없음)
-- `next-intlayer` (v9.5.1)
-- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/next-intl.md) (v9.5.1)
-- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/next-i18next.md) (v9.5.1)
-- `next-i18next` (v16.3.0)
-- `next-intl` (v4.14.2)
-- `@lingui/core` (v6.6.0)
-- `next-translate` (v3.2.0)
-- `next-international` (v1.3.1)
-- `@inlang/paraglide-js` (v2.15.1)
-- `@tolgee/react` (v7.2.0)
-- `@lingo.dev/compiler` (v0.4.12)
-- `wuchale` (v0.26.6)
-- `gt-next` (v11.1.24)
+- [`next-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/next-i18next.md) (v9.5.6)
+- [`next-i18next`](https://github.com/i18next/next-i18next) (v16.3.0)
+- [`next-intl`](https://github.com/amannn/next-intl) (v4.14.2)
+- [`@lingui/core`](https://github.com/lingui/js-lingui) (v6.6.0)
+- [`next-translate`](https://github.com/aralroca/next-translate) (v3.2.0)
+- [`next-international`](https://github.com/QuiiBz/next-international) (v1.3.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.15.1)
+- [`@tolgee/react`](https://github.com/tolgee/tolgee-js) (v7.2.0)
+- [`@lingo.dev/compiler`](https://github.com/lingodotdev/lingo.dev) (v0.4.12)
+- [`wuchale`](https://github.com/wuchalejs/wuchale) (v0.26.6)
+- [`gt-next`](https://github.com/generaltranslation/gt) (v11.1.24)
 
 Next.js 버전 `16.3.4`와 App Router를 사용했습니다.
 

package/docs/ko/benchmark/solid.md

@@ -65,7 +65,7 @@ style="border:none;"
 
 ## TL;DR
 
-- **Intlayer**: 고급 기능과 최적화가 필요한 전문 Solid 애플리케이션을 위한 추천 선택(v9.5.0).
+- **Intlayer**: 고급 기능과 최적화가 필요한 전문 Solid 애플리케이션을 위한 추천 선택(v9.5.6).
 - **@solid-primitives/i18n**: 단순한 프로젝트를 위한 훌륭한 경량 대안이지만 지연 로딩과 같은 고급 기능이 부족합니다.
 - **solid-i18next**: 표준적이지만 무거운 옵션(Intlayer의 약 3.5배)으로 React i18next와 동일한 단점을 공유합니다.
 - **Paraglide**: 혁신적인 접근 방식이지만 DX가 복잡하고 일부 설정에서 트리 쉐이킹 문제가 발생합니다.
@@ -100,10 +100,10 @@ i18n 누수 문제를 빠르게 파악하기 위해 [여기](https://intlayer.or
 이 벤치마크에서는 다음과 같은 라이브러리를 비교했습니다:
 
 - `Base App` (i18n 라이브러리 없음)
-- `solid-intlayer` (v9.5.0)
-- `@solid-primitives/i18n` (v2.2.1)
-- `i18next` (v26.0.8) + `@mbarzda/solid-i18next` (v1.4.1)
-- `@inlang/paraglide-js` (v2.25.1)
+- [`solid-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/solid-intlayer/exports.md) (v9.5.6)
+- [`@solid-primitives/i18n`](https://github.com/solidjs-community/solid-primitives/tree/main/packages/i18n) (v2.2.1)
+- [`i18next`](https://github.com/i18next/i18next) (v26.0.8) + [`@mbarzda/solid-i18next`](https://github.com/mbarzda/solid-i18next) (v1.4.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 프레임워크는 `Solid`이며 **10개의 페이지**와 **10개의 언어**를 가진 다국어 앱을 사용했습니다.
 

package/docs/ko/benchmark/svelte.md

@@ -65,7 +65,7 @@ style="border:none;"
 
 ## TL;DR
 
-- **Intlayer**: 가장 성능 효율적인 선택(v9.5.0)으로, 발자국(footprint)이 가장 작습니다.
+- **Intlayer**: 가장 성능 효율적인 선택(v9.5.6)으로, 발자국(footprint)이 가장 작습니다.
 - **Paraglide**: 트리 쉐이킹(tree-shaking)을 위한 강력한 후보이지만, 개발자 경험이 더 복잡하고 반응성 오버헤드가 있습니다.
 - **svelte-i18n**: Svelte를 위한 표준적이고 기능이 완비된 솔루션이지만, 번들 무게가 훨씬 더 큽니다(Intlayer의 약 4.5배).
 
@@ -99,9 +99,9 @@ i18n 누수 문제를 빠르게 파악하기 위해 [여기](https://intlayer.or
 이 벤치마크에서는 다음과 같은 라이브러리를 비교했습니다:
 
 - `Base App` (i18n 라이브러리 없음)
-- `svelte-intlayer` (v9.5.0)
-- `svelte-i18n` (v4.0.1)
-- `@inlang/paraglide-js` (v2.25.1)
+- [`svelte-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/svelte-intlayer/exports.md) (v9.5.6)
+- [`svelte-i18n`](https://github.com/kaisermann/svelte-i18n) (v4.0.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 프레임워크는 `Svelte`이며 **10개의 페이지**와 **10개의 언어**를 가진 다국어 앱을 사용했습니다.
 

package/docs/ko/benchmark/tanstack.md

@@ -65,7 +65,7 @@ history:
 
 ## TL;DR
 
-- **Intlayer**: TanStack Start에서 최고의 성능과 가장 작은 번들 크(v9.5.1)를 제공합니다.
+- **Intlayer**: TanStack Start에서 최고의 성능과 가장 작은 번들 크(v9.5.6)를 제공합니다.
 - **react-i18next** & **use-intl**: 큰 에코시스템을 가진 성숙한 대안이지만, 훨씬 더 무겁고 최적화가 복잡합니다.
 - **Paraglide**: 혁신적인 트리 쉐이킹 아이디어이지만 실제로는 작동하지 않습니다. TanStack Start에서 복잡한 DX와 반응성 오버헤드가 발생합니다.
 - **피해야 할 솔루션**: **General Translation (GT)** 및 **Lingo.dev**. 심각한 성능 문제, AI 쿼터 제한 및 벤더 종속성(vendor lock-in) 때문입니다.
@@ -100,18 +100,19 @@ i18n 누수 문제를 빠르게 파악하기 위해 [여기](https://intlayer.or
 이 벤치마크에서는 다음과 같은 라이브러리를 비교했습니다:
 
 - `Base App` (i18n 라이브러리 없음)
-- `react-intlayer` (v9.5.1)
-- `@intlayer/use-intl` (v9.5.1)
-- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/lingui.md) (v9.5.1)
-- `react-i18next` (v17.0.13)
-- `use-intl` (v4.14.2)
-- `@lingui/core` (v6.6.0)
-- `@inlang/paraglide-js` (v2.15.1)
-- `@tolgee/react` (v7.2.0)
-- `react-intl` (v10.1.26)
-- `wuchale` (v0.26.6)
-- `gt-react` (v10.18.3)
-- `lingo.dev` (v0.138.7)
+- [`react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/use-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/lingui.md) (v9.5.6)
+- [`@intlayer/react-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/react-i18next.md) (v9.5.6)
+- [`react-i18next`](https://github.com/i18next/react-i18next) (v17.0.13)
+- [`use-intl`](https://github.com/amannn/next-intl/tree/main/packages/use-intl) (v4.14.2)
+- [`@lingui/core`](https://github.com/lingui/js-lingui) (v6.6.0)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.15.1)
+- [`@tolgee/react`](https://github.com/tolgee/tolgee-js) (v7.2.0)
+- [`react-intl`](https://github.com/formatjs/formatjs) (v10.1.26)
+- [`wuchale`](https://github.com/wuchalejs/wuchale) (v0.26.6)
+- [`gt-react`](https://github.com/generaltranslation/gt) (v10.18.3)
+- [`lingo.dev`](https://github.com/lingodotdev/lingo.dev) (v0.138.7)
 
 프레임워크는 `TanStack Start`이며 **10개의 페이지**와 **10개의 언어**를 가진 다국어 앱을 사용했습니다.
 

package/docs/ko/benchmark/vue.md

@@ -65,7 +65,7 @@ style="border:none;"
 
 ## TL;DR
 
-- **Intlayer**: 내장된 스코핑(scoping)과 동적 로딩을 제공하는 가장 가벼운 솔루션(v9.5.0).
+- **Intlayer**: 내장된 스코핑(scoping)과 동적 로딩을 제공하는 가장 가벼운 솔루션(v9.5.6).
 - **vue-i18n**: 풍부한 에코시스템을 가진 업계 표준이지만, 대규모 애플리케이션에서 코드 분할 최적화가 어렵고 상당히 무거워질 수 있습니다.
 - **fluent-vue**: 혁신적인 메시지 구성을 제공하지만 타입 안전성이 부족하고 극도로 무거운 솔루션입니다.
 
@@ -99,10 +99,10 @@ i18n 누수 문제를 빠르게 파악하기 위해 [여기](https://intlayer.or
 이 벤치마크에서는 다음과 같은 라이브러리를 비교했습니다:
 
 - `Base App` (i18n 라이브러리 없음)
-- `vue-intlayer` (v9.5.0)
-- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/vue-i18n.md) (v9.5.1)
-- `vue-i18n` (v11.4.0)
-- `fluent-vue` (v3.8.2)
+- [`vue-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vue-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/vue-i18n.md) (v9.5.6)
+- [`vue-i18n`](https://github.com/intlify/vue-i18n) (v11.4.0)
+- [`fluent-vue`](https://github.com/fluent-vue/fluent-vue) (v3.8.2)
 
 프레임워크는 `Vue`이며 **10개의 페이지**와 **10개의 언어**를 가진 다국어 앱을 사용했습니다.
 

package/docs/ko/chrome_extension.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2026-09-22
+updatedAt: 2026-09-22
+title: Chrome & Firefox 확장 프로그램, i18n & SEO 스캐너
+description: Intlayer Chrome 확장 프로그램을 사용하여 모든 웹사이트의 i18n 설정을 검사하세요. 프레임워크, i18n 라이브러리, 로케일, hreflang 및 SEO 태그를 감지하고 전체 i18n SEO 감사를 실행합니다.
+keywords:
+  - Chrome 확장 프로그램
+  - i18n 스캐너
+  - hreflang 검사기
+  - 다국어 SEO
+  - Intlayer
+  - 현지화
+  - 개발 도구
+slugs:
+  - doc
+  - chrome-extension
+history:
+  - version: 9.5.6
+    date: 2026-09-22
+    changes: "초기 이력"
+author: aymericzip
+---
+
+# Chrome & Firefox 확장 프로그램: i18n & SEO 스캐너
+
+## 개요
+
+[**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc)는 **Intlayer**의 공식 Chrome 확장 프로그램입니다. 웹사이트에서 실행하여 사이트가 국제화를 어떻게 처리하는지 확인할 수 있습니다. 어떤 프레임워크와 i18n 라이브러리를 사용하는지, 어떤 로케일을 제공하는지, 다국어 SEO 태그가 올바르게 설정되었는지 즉시 점검할 수 있습니다.
+
+Intlayer 사용 여부와 상관없이 모든 웹사이트에서 작동합니다.
+
+![Intlayer Chrome 확장 프로그램](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension.png?raw=true)
+
+[Chrome 확장 프로그램 링크](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc)
+
+[Firefox 부가 기능 링크](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/)
+
+## 주요 기능
+
+- **기술 감지**: 프레임워크(Next.js, Nuxt, Astro, SvelteKit, Angular, Vue.js, Qwik, React, Gatsby, WordPress) 및 i18n 라이브러리(Intlayer, i18next, Vue I18n, @nuxtjs/i18n, Angular @angular/localize, next-intl / next-i18next, Weglot, Localize, WPML, Polylang)를 식별합니다. 각 감지 항목은 전역 변수, 쿠키, DOM 마커 등 이를 유발한 증거를 보여줍니다.
+- **로케일**: `lang` 속성, hreflang 및 `og:locale` 태그, URL 로케일 접두사, 로케일 쿠키 또는 스토리지 항목에서 찾은 로케일을 나열합니다.
+- **SEO i18n 태그**: `html lang`, `html dir`, 표준(canonical) 링크, hreflang 태그, `x-default`, `og:locale` 및 현지화된 내부 링크 비율을 검사합니다.
+- **로케일 간 이동**: hreflang 태그를 기반으로 현재 페이지를 클릭 한 번으로 현지화된 버전으로 전환합니다.
+- **사이트맵 검색**: 사이트의 사이트맵에 나열된 모든 페이지를 검색하고 현재 탭에서 엽니다.
+- **전체 감사**: [i18n SEO Scanner](https://intlayer.org/i18n-seo-scanner)와 동일한 감사를 실행하고 실시간 점수를 표시합니다.
+
+## 설치
+
+<Tabs group="browser">
+  <Tab label="Chrome" value="chrome">
+
+Chrome 웹 스토어에서 [**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc)를 설치한 후 툴바에 고정하세요.
+
+이 확장 프로그램은 Chrome 및 Chrome 웹 스토어 확장을 지원하는 모든 Chromium 기반 브라우저(Edge, Brave, Arc, Opera)에서 작동합니다.
+
+  </Tab>
+  <Tab label="Firefox" value="firefox">
+
+Firefox 부가 기능에서 [**Intlayer i18n Scanner**](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/)를 설치한 후 툴바에 고정하세요.
+
+  </Tab>
+</Tabs>
+
+## 사용법
+
+### 페이지 검사
+
+1. 검사하려는 웹사이트를 엽니다.
+2. 툴바의 **Intlayer i18n Scanner** 아이콘을 클릭합니다.
+3. 팝업에 현재 페이지에 대한 **감지된 기술**, **로케일**, **SEO i18n 태그** 섹션이 표시됩니다.
+
+감지는 브라우저에서 로컬로 실행되며, 현재 활성 탭에서만 동작합니다.
+
+### 로케일 간 이동
+
+![Intlayer Chrome 확장 프로그램 탐색](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_navigation.png?raw=true)
+
+**탐색** 섹션에는 현재 페이지의 hreflang 태그에서 읽은 **현지화된 버전**이 표시됩니다. 로케일을 클릭하면 해당 버전이 현재 탭에서 열립니다.
+
+**사이트맵 페이지**에서 사이트맵의 URL을 검색하고, 결과를 클릭해 해당 페이지를 엽니다.
+
+### 전체 감사 실행
+
+![Intlayer Chrome 확장 프로그램 감사 점수](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_audit_score.png?raw=true)
+
+**전체 감사** 섹션으로 스크롤하고 **전체 i18n 감사 실행**을 클릭합니다. 각 검사가 완료될 때마다 결과가 실시간으로 스트리밍되며 다음 그룹으로 분류됩니다.
+
+- **페이지**: `html lang` 및 `dir` 속성, 현재 로케일, hreflang 태그, `x-default`, 표준 링크, 현지화된 내부 링크, 언어 선택기, 국기 아이콘 및 JavaScript 번들에 포함된 미사용 로케일 콘텐츠.
+- **Robots.txt**: 존재 여부 및 로케일 경로가 크롤링 가능하게 유지되는지 여부.
+- **사이트맵**: 존재 여부, 나열된 모든 로케일, 대체 링크 및 `x-default`.
+- **도메인**: 사이트 전체에서 발견된 로케일 수.
+
+각 검사는 통과, 경고 또는 실패로 표시되며, 점수는 페이지의 전반적인 i18n SEO 상태를 요약합니다.
+
+## 개인정보 보호 및 권한
+
+확장 프로그램은 최소한의 권한만 요청합니다.
+
+- **activeTab** 및 **scripting**: 감지기는 사용자가 보고 있는 탭에서 팝업을 열 때만 실행됩니다.
+- **back.intlayer.org**: 전체 감사를 실행할 때만 사용됩니다. 현재 페이지의 URL이 검사를 위해 Intlayer API로 전송됩니다.
+
+브라우징 기록은 수집되지 않으며 백그라운드에서 실행되는 항목이 없습니다.
+
+## FAQ
+
+<FAQ>
+
+<Question title="웹사이트에서 Intlayer를 사용해야 하나요?">
+
+아닙니다. 어떤 프레임워크나 i18n 라이브러리를 사용하든 상관없이 모든 웹사이트를 검사할 수 있습니다.
+
+</Question>
+<Question title="기술이 감지되지 않는 이유는 무엇인가요?">
+
+감지는 전역 변수, 쿠키, 메타 태그, DOM 마커 등 페이지가 브라우저에 노출하는 정보에 의존합니다. 일부 프로덕션 빌드는 이러한 마커를 제거하므로 라이브러리를 사용 중이더라도 흔적이 남지 않을 수 있습니다.
+
+</Question>
+<Question title="감사에서 발견된 문제를 어떻게 해결하나요?">
+
+대부분의 검사는 라우팅 또는 메타데이터 설정과 관련이 있습니다. Intlayer를 사용하면 hreflang, 표준 링크, `x-default`, 현지화된 링크, 사이트맵 및 robots.txt가 [설정](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에서 자동으로 생성됩니다. 사용 중인 프레임워크(예: [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_16.md), [Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nuxt.md), [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_tanstack.md))의 통합 가이드를 참조하세요.
+
+</Question>
+
+</FAQ>
+
+## 관련 도구
+
+- [VS Code 확장 프로그램](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md)
+- [MCP 서버](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)
+- [LSP 서버](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)

package/docs/ko/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-12
+updatedAt: 2026-09-21
 title: CLI - 다국어 웹사이트를 위한 모든 Intlayer CLI 명령어
 description: Intlayer CLI를 사용하여 다국어 웹사이트를 관리하는 방법을 알아보세요. 이 온라인 문서의 단계를 따라 몇 분 만에 프로젝트를 설정하세요.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "init infra 명령어 추가"
   - version: 9.5.2
     date: 2026-09-12
     changes: "`ci` 명령어를 `--ci` 플래그로 대체"
@@ -151,6 +154,7 @@ Intlayer는 여러 설정 파일 형식을 허용합니다:
 ### 구성
 
 - **[Intlayer 초기화 (Init)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/init.md)** - 자동 구성을 사용하여 프로젝트에 Intlayer를 설정합니다.
+- **[인프라 설정 (Set Up Infrastructure)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/infra.md)** - 데스크톱 앱을 설치하거나 Docker(올인원 또는 Compose)로 CMS를 셀프 호스팅합니다
 - **[구성 관리](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/configuration.md)** - Intlayer 구성을 가져오고 CMS로 전송합니다.
 
 ### 문서 관리
@@ -177,6 +181,7 @@ Intlayer는 여러 설정 파일 형식을 허용합니다:
 ```json fileName="package.json"
 "scripts": {
   "intlayer:init": "npx intlayer init",
+  "intlayer:infra": "npx intlayer init infra",
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",

package/docs/ko/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Intlayer CLI init infra 명령어를 사용하여 데스크톱 앱을 설치하거나 Docker(올인원 컨테이너 또는 Docker Compose 스택)로 Intlayer CMS를 셀프 호스팅하는 방법을 알아봅니다.
+keywords:
+  - CLI
+  - 인프라
+  - 셀프 호스팅
+  - 데스크톱 앱
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "init infra 명령어 추가"
+author: aymericzip
+---
+
+# Intlayer CLI Init Infra 명령어
+
+## 설명
+
+`init infra` 명령어는 로컬 머신에 Intlayer 인프라를 설정합니다. 사용 중인 플랫폼용 호스팅 설치 프로그램(macOS / Linux는 `https://intlayer.org/install.sh`, Windows는 `https://intlayer.org/install.ps1`)을 다운로드하고 터미널에 연결하여 실행하므로 설치 프로그램 메뉴와 진행 상황이 그대로 표시됩니다.
+
+설치 프로그램은 Intlayer 실행 방법을 선택하도록 안내합니다:
+
+- **데스크톱 앱**: 운영체제 및 CPU에 맞는 네이티브 대시보드를 다운로드하여 열거나 설치합니다. 데스크톱 빌드는 Intlayer Cloud 백엔드와 통신합니다.
+- **올인원 Docker**: 단일 볼륨 기반의 단일 컨테이너에서 대시보드 + API + MongoDB + Redis + MinIO를 실행합니다. 시크릿이 생성된 `./intlayer.env`를 작성하고 `intlayer/cms-all` 이미지를 가져옵니다.
+- **Docker Compose**: 확장 가능한 셀프 호스팅을 위한 서비스당 하나의 컨테이너 구성입니다. `./intlayer/`에 `docker-compose.yml` 및 `.env`를 작성하고 이미지를 가져옵니다.
+
+호스팅된 설치 프로그램이 설정 흐름의 유일한 정보원입니다. CLI는 동일한 단계를 다시 구현하지 않고 설치 프로그램을 실행하므로 `npx intlayer init infra`와 `curl -fsSL https://intlayer.org/install.sh | sh`는 완전히 동일하게 작동합니다.
+
+## 사용법
+
+```bash packageManager="npm"
+npx intlayer init infra [options]
+```
+
+```bash packageManager="yarn"
+yarn intlayer init infra [options]
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer init infra [options]
+```
+
+```bash packageManager="bun"
+bun x intlayer init infra [options]
+```
+
+`npx intlayer init --interactive` 체크리스트의 **인프라 (데스크톱 앱 / 셀프 호스팅)** 항목에서도 동일한 단계가 제공됩니다.
+
+## 옵션
+
+- `-m, --mode <mode>` - 선택 사항. 설치 프로그램 메뉴를 건너뛰고 특정 모드를 직접 실행합니다. 허용되는 값: `desktop`, `docker`(올인원) 또는 `compose`. 다른 값을 입력하면 지원되는 모드 목록과 함께 오류가 발생합니다.
+
+## 예시
+
+### 대화형으로 모드 선택
+
+```bash
+npx intlayer init infra
+```
+
+### 데스크톱 앱 설치
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### 올인원 컨테이너로 셀프 호스팅
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Docker Compose로 셀프 호스팅
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## 출력 예시
+
+```bash
+npx intlayer init infra --mode compose
+◇  Installer downloaded
+▸ Fetching docker-compose.yml into ./intlayer
+▸ Writing ./intlayer/.env
+▸ Pulling images
+
+  Everything is installed. Two steps left.
+
+  1. Configure a mailer in:
+
+       ./intlayer/.env
+
+     Either RESEND_API_KEY (resend.com) or the MAIL_SMTP_* block — the first
+     account cannot be verified without a working mailer.
+  2. Start the stack:
+
+       cd ./intlayer && docker compose up -d
+
+  Then open http://localhost:3000 — first boot initialises the
+  datastores, so give it a minute. The first account you create becomes the
+  super admin.
+
+    Logs      docker compose logs -f
+    Stop      docker compose down
+    Upgrade   docker compose pull && docker compose up -d
+```
+
+## 설치 프로그램 설정
+
+설치 프로그램은 몇 가지 환경 변수를 읽으며, CLI는 이를 그대로 전달합니다. 명령을 실행하기 전에 셸에서 설정하세요:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| 변수                      | 기본값                    | 적용 대상 | 설명                                                |
+| ------------------------- | ------------------------- | --------- | --------------------------------------------------- |
+| `INTLAYER_MODE`           | _(질문됨)_                | 모두      | `desktop`, `docker` 또는 `compose`, `--mode`와 동일 |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop   | 앱 설치 프로그램이 저장되는 위치                    |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker    | 가져올 올인원 이미지                                |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker    | 환경 설정 파일을 작성할 위치                        |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker    | 컨테이너 이름                                       |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker    | `/data`에 마운트된 네임드 볼륨                      |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker    | 대시보드 호스트 포트                                |
+| `INTLAYER_API_PORT`       | `3100`                    | docker    | API 호스트 포트                                     |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker    | MinIO S3 API 호스트 포트                            |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker    | MinIO 콘솔 호스트 포트                              |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose   | `docker-compose.yml` 및 `.env`가 작성되는 위치      |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | 둘 다     | compose 파일 및 env 템플릿을 가져오는 Git ref       |
+
+> 포트 변수는 매핑의 **호스트** 측만 변경합니다. 게시된 이미지에는 `http://localhost:3000`, `http://localhost:3100`, `http://localhost:9000`이 대시보드 번들에 컴파일되어 있으므로 자체 이미지를 빌드하지 않는 한 기본값을 유지하세요: [셀프 호스팅 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md#limitations)를 참조하세요.
+
+## 요구 사항
+
+- **데스크톱 앱**은 [Node.js](https://nodejs.org)가 필요합니다: 앱은 대시보드 서버를 내장하고 있으며 머신의 `node` 바이너리로 시작합니다.
+- **Docker 모드**는 [Docker](https://docs.docker.com/get-docker/)가 필요합니다(Windows에서는 WSL 2 백엔드의 Docker Desktop). Compose 모드에는 `docker compose` 플러그인도 필요합니다.
+
+## 참고 사항
+
+- 명령을 다시 실행해도 안전합니다: 기존 환경 파일은 절대 덮어쓰지 않으므로 업그레이드 경로로도 사용됩니다(최신 이미지를 가져오고 시크릿을 유지함).
+- 설치 프로그램은 임시 디렉터리에 다운로드되며 결과에 관계없이 종료 시 삭제됩니다.
+- 명령어의 종료 코드는 설치 프로그램의 종료 코드입니다. 다운로드 자체가 실패하면 CLI에서 직접 설치 프로그램을 실행할 수 있도록 해당하는 `curl … | sh`(또는 `irm … | iex`) 명령을 출력합니다.
+- Docker 모드에서는 로그인 이메일을 전송하기 위해 메일러가 필요합니다. 설치 프로그램이 완료된 후 생성된 환경 파일에서 Resend 또는 SMTP를 구성하세요: [글로벌 메일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md#global-mailer)를 참조하세요.
+
+## 관련 문서
+
+- [셀프 호스팅 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md) - 각 모드의 아키텍처, 초기 실행 단계 및 제한 사항
+- [Intlayer 초기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/init.md) - 상위 `init` 명령어 및 대화형 체크리스트
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md) - 방금 설치한 대시보드의 기능

package/docs/ko/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Intlayer 초기화
 description: 프로젝트에서 Intlayer를 초기화하는 방법을 알아봅니다.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "init infra 하위 명령어 추가"
   - version: 8.6.4
     date: 2026-03-31
     changes: "--no-gitignore 옵션 추가"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 이 명령어는 모든 설정 파일을 구성하지만 `.gitignore`는 수정하지 않습니다.
 
+### 인프라 설정 (데스크톱 앱 또는 셀프 호스팅):
+
+```bash
+npx intlayer init infra
+```
+
+호스팅된 설치 프로그램(macOS / Linux의 `https://intlayer.org/install.sh`, Windows의 `install.ps1`)을 다운로드하고 실행하여 Intlayer 실행 방법을 선택하도록 안내합니다:
+
+- **데스크톱 앱** - Intlayer Cloud에 연결된 네이티브 대시보드를 로컬 머신에 설치합니다.
+- **올인원 Docker** - 단일 컨테이너 내에 대시보드 + API + MongoDB + Redis + MinIO가 모두 포함됩니다.
+- **Docker Compose** - 확장 가능한 셀프 호스팅을 위한 서비스당 하나의 컨테이너 구성입니다.
+
+`--mode` 옵션으로 메뉴를 건너뛸 수 있습니다:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+`npx intlayer init --interactive`에서도 동일한 단계가 제공됩니다. 설치 프로그램 설정은 [`init infra` 레퍼런스](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/infra.md)를, 각 모드가 설정하는 세부 내용은 [셀프 호스팅 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md)를 참조하세요.
+
 ## 출력 예시:
 
 ```bash