@intlayer/docs 9.5.5 → 9.5.7

package/docs/zh/benchmark/nextjs.md

@@ -112,19 +112,19 @@ Intlayer 尝试在这些维度上进行优化。
 在此基准测试中，我们对比了以下库：
 
 - `Base App`（无 i18n 库）
-- `next-intlayer` (v9.5.1)
-- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-intl.md) (v9.5.1)
-- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/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/zh/packages/next-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/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/zh/benchmark/solid.md

@@ -64,7 +64,7 @@ history:
 
 ## TL;DR
 
-- **Intlayer**: 需要高级功能和优化的专业 Solid 应用的推荐选择（v9.5.0）。
+- **Intlayer**: 需要高级功能和优化的专业 Solid 应用的推荐选择（v9.5.6）。
 - **@solid-primitives/i18n**: 简单项目的绝佳轻量级替代方案，但缺乏延迟加载等高级功能。
 - **solid-i18next**: 标准但沉重的选项（约为 Intlayer 的 3.5 倍），具有与 React i18next 相同的缺点。
 - **Paraglide**: 创新的方法，但在某些设置中 DX 复杂且存在 tree-shaking 问题。
@@ -99,10 +99,10 @@ history:
 在此基准测试中，我们比较了以下库：
 
 - `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/zh/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/zh/benchmark/svelte.md

@@ -65,7 +65,7 @@ history:
 
 ## TL;DR
 
-- **Intlayer**: 性能最高效的选择（v9.5.0），占用空间最小。
+- **Intlayer**: 性能最高效的选择（v9.5.6），占用空间最小。
 - **Paraglide**: tree-shaking 的有力竞争者，但开发者体验更复杂，且有反应性开销。
 - **svelte-i18n**: 功能完善且是 Svelte 的标准，但包重量大得多（约为 Intlayer 的 4.5 倍）。
 
@@ -99,9 +99,9 @@ history:
 在此基准测试中，我们比较了以下库：
 
 - `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/zh/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/zh/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**: 创新的 Tree-shaking 理念，但在实际应用中并未生效。在 TanStack Start 中 DX 复杂且存在响应性开销。
 - **应当避免**: **General Translation (GT)** 和 **Lingo.dev**。由于严重的性能问题、AI 配额限制以及供应商锁定 (vendor lock-in)。
@@ -100,18 +100,19 @@ history:
 在此基准测试中，我们对比了以下库：
 
 - `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/zh/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/zh/packages/react-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/use-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/lingui.md) (v9.5.6)
+- [`@intlayer/react-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/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/zh/benchmark/vue.md

@@ -65,7 +65,7 @@ style="border:none;"
 
 ## TL;DR
 
-- **Intlayer**: 最轻量级的解决方案（v9.5.0），内置分层（scoping）和动态加载。
+- **Intlayer**: 最轻量级的解决方案（v9.5.6），内置分层（scoping）和动态加载。
 - **vue-i18n**: 具有丰富生态系统的行业标准，但在大型应用中可能会显著变重且难以进行代码拆分优化。
 - **fluent-vue**: 创新的消息组织方式，但缺乏类型安全且极其沉重。
 
@@ -99,10 +99,10 @@ style="border:none;"
 在此基准测试中，我们比较了以下库：
 
 - `Base App`（无 i18n 库）
-- `vue-intlayer` (v9.5.0)
-- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/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/zh/packages/vue-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/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/zh/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）。每次检测都会显示触发它的依据，例如全局变量、cookie 或 DOM 标记。
+- **语言区域**：列出在 `lang` 属性、hreflang 和 `og:locale` 标签、URL 语言前缀以及语言 cookie 或本地存储中发现的语言区域。
+- **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 bundle 中未使用的语言内容。
+- **Robots.txt**：是否存在，以及语言路径是否保持可抓取。
+- **站点地图（Sitemap）**：是否存在、列出的所有语言区域、备用链接和 `x-default`。
+- **域名**：在整个网站中发现的语言区域数量。
+
+每项检查都会标记为通过、警告或未通过，综合评分总结了页面的整体 i18n SEO 健康状况。
+
+## 隐私与权限
+
+该扩展仅申请最少权限：
+
+- **activeTab** 和 **scripting**：检测器仅在您正在查看的标签页上运行，且仅在您打开弹出窗口时运行。
+- **back.intlayer.org**：仅在您运行完整审计时使用。当前页面的 URL 会发送到 Intlayer API 进行扫描。
+
+不会收集任何浏览历史记录，后台也不会运行任何程序。
+
+## 常见问题
+
+<FAQ>
+
+<Question title="网站需要使用 Intlayer 吗？">
+
+不需要。无论网站使用何种框架或 i18n 库，该扩展都可以检查任何网站。
+
+</Question>
+<Question title="为什么有些技术没有被检测到？">
+
+检测依赖于页面在浏览器中公开的信息：全局变量、cookie、meta 标签和 DOM 标记。某些生产构建会移除这些标记，因此库可能在使用中但未留下可见痕迹。
+
+</Question>
+<Question title="如何修复审计发现的问题？">
+
+大多数检查都对应路由或元数据设置。使用 Intlayer 时，hreflang、规范链接、`x-default`、本地化链接、站点地图和 robots.txt 均可从您的[配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)自动生成。请参阅适用于您框架的集成指南，例如 [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nextjs_16.md)、[Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nuxt.md) 或 [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_tanstack.md)。
+
+</Question>
+
+</FAQ>
+
+## 相关工具
+
+- [VS Code 扩展](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/vs_code_extension.md)
+- [MCP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)
+- [LSP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)

package/docs/zh/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 接受多种配置文件格式：
 ### 配置
 
 - **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/init.md)** - 使用自动配置在您的项目中设置 Intlayer
+- **[配置基础设施](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/infra.md)** - 安装桌面应用或使用 Docker（多合一或 Compose）自行托管 CMS
 - **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/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/zh/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**：每个服务一个容器，用于可扩展的自行托管。将 `docker-compose.yml` 和 `.env` 写入 `./intlayer/` 并拉取镜像。
+
+托管安装程序是安装流程的唯一真实来源：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 会原样传递这些变量。在运行命令前请在 shell 中进行设置：
+
+```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/zh/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/zh/self_hosting.md#global-mailer)。
+
+## 相关内容
+
+- [自行托管指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md) - 各模式的架构、首次运行步骤和限制
+- [初始化 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/init.md) - 父级 `init` 命令及其交互式检查清单
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) - 您刚安装的控制面板的功能

package/docs/zh/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/zh/cli/infra.md)，有关各模式设置的内容，请参阅[自行托管指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。
+
 ## 输出示例：
 
 ```bash