@intlayer/docs 9.5.6 → 9.5.7

package/docs/vi/benchmark/nextjs.md

@@ -112,19 +112,19 @@ Cuối cùng, `Intlayer` áp dụng một tối ưu hóa tại thời điểm bu
 Đối với benchmark này, chúng tôi đã so sánh các thư viện sau:
 
 - `Base App` (Không sử dụng thư viện i18n)
-- `next-intlayer` (v9.5.1)
-- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compat/next-intl.md) (v9.5.1)
-- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/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/vi/packages/next-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/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)
 
 Tôi đã sử dụng phiên bản `Next.js` `16.3.4` với App Router.
 

package/docs/vi/benchmark/solid.md

@@ -65,7 +65,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 
 ## TL;DR
 
-- **Intlayer**: Lựa chọn được đề xuất cho các ứng dụng Solid chuyên nghiệp cần các tính năng nâng cao và tối ưu hóa (v9.5.0).
+- **Intlayer**: Lựa chọn được đề xuất cho các ứng dụng Solid chuyên nghiệp cần các tính năng nâng cao và tối ưu hóa (v9.5.6).
 - **@solid-primitives/i18n**: Giải pháp thay thế gọn nhẹ tuyệt vời cho các dự án đơn giản, mặc dù thiếu các tính năng nâng cao như lazy loading.
 - **solid-i18next**: Tùy chọn tiêu chuẩn nhưng nặng (~3.5 lần Intlayer) với các nhược điểm tương tự như React i18next.
 - **Paraglide**: Cách tiếp cận sáng tạo nhưng DX phức tạp và vấn đề tree-shaking trong một số thiết lập.
@@ -100,10 +100,10 @@ Các cú pháp được xây dựng xung quanh `t('a.b.c')` rất tiện lợi n
 Đối với benchmark này, chúng tôi đã so sánh các thư viện sau:
 
 - `Base App` (Không có thư viện 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/vi/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)
 
 Framework là `Solid` với một ứng dụng đa ngôn ngữ gồm **10 trang** và **10 ngôn ngữ**.
 

package/docs/vi/benchmark/svelte.md

@@ -65,7 +65,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 
 ## TL;DR
 
-- **Intlayer**: Lựa chọn hiệu quả nhất về hiệu suất (v9.5.0) với dấu chân (footprint) nhỏ nhất.
+- **Intlayer**: Lựa chọn hiệu quả nhất về hiệu suất (v9.5.6) với dấu chân (footprint) nhỏ nhất.
 - **Paraglide**: Đối thủ nặng ký cho tree-shaking nhưng có trải nghiệm nhà phát triển phức tạp hơn và overhead về tính phản ứng.
 - **svelte-i18n**: Toàn diện và tiêu chuẩn cho Svelte, nhưng mang trọng lượng bundle lớn hơn nhiều (~4.5 lần Intlayer).
 
@@ -99,9 +99,9 @@ Các cú pháp được xây dựng xung quanh `t('a.b.c')` rất tiện lợi n
 Đối với benchmark này, chúng tôi đã so sánh các thư viện sau:
 
 - `Base App` (Không có thư viện 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/vi/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)
 
 Framework là `Svelte` với một ứng dụng đa ngôn ngữ gồm **10 trang** và **10 ngôn ngữ**.
 

package/docs/vi/benchmark/tanstack.md

@@ -65,7 +65,7 @@ Tác động khác là đối với trải nghiệm phát triển (DX): cách b
 
 ## TL;DR
 
-- **Intlayer**: Cung cấp hiệu năng tốt nhất và kích thước bundle nhỏ nhất (v9.5.1) cho TanStack Start.
+- **Intlayer**: Cung cấp hiệu năng tốt nhất và kích thước bundle nhỏ nhất (v9.5.6) cho TanStack Start.
 - **react-i18next** & **use-intl**: Các lựa chọn thay thế thuần thục với hệ sinh thái lớn, nhưng nặng hơn đáng kể và phức tạp hơn để tối ưu hóa.
 - **Paraglide**: Ý tưởng tree-shaking sáng tạo nhưng không hoạt động trong thực tế. DX phức tạp và chi phí phản ứng trên TanStack Start.
 - **Cần tránh**: **General Translation (GT)** và **Lingo.dev** do các vấn đề hiệu năng nghiêm trọng, giới hạn hạn mức AI và bị ràng buộc vào nhà cung cấp (vendor lock-in).
@@ -100,18 +100,19 @@ Các cú pháp được xây dựng xung quanh `const t = useTranslation()` + `t
 Đối với benchmark này, chúng tôi đã so sánh các thư viện sau:
 
 - `Base App` (Không sử dụng thư viện i18n)
-- `react-intlayer` (v9.5.1)
-- `@intlayer/use-intl` (v9.5.1)
-- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/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/vi/packages/react-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/use-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compat/lingui.md) (v9.5.6)
+- [`@intlayer/react-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/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)
 
 Framework được sử dụng là `TanStack Start` với một ứng dụng đa ngôn ngữ gồm **10 trang** và **10 ngôn ngữ**.
 

package/docs/vi/benchmark/vue.md

@@ -65,7 +65,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 
 ## TL;DR
 
-- **Intlayer**: Giải pháp nhẹ nhất (v9.5.0) với tính năng scoping và tải động gốc.
+- **Intlayer**: Giải pháp nhẹ nhất (v9.5.6) với tính năng scoping và tải động gốc.
 - **vue-i18n**: Tiêu chuẩn ngành với hệ sinh thái phong phú, nhưng có thể trở nên nặng hơn đáng kể và khó tối ưu hóa cho code-splitting trong các ứng dụng lớn.
 - **fluent-vue**: Tổ chức thông báo sáng tạo nhưng thiếu an toàn kiểu (type-safety) và hóa ra là một giải pháp cực kỳ nặng.
 
@@ -99,10 +99,10 @@ Các cú pháp được xây dựng xung quanh `const { t } = useI18n()` + `t('a
 Đối với benchmark này, chúng tôi đã so sánh các thư viện sau:
 
 - `Base App` (Không có thư viện i18n)
-- `vue-intlayer` (v9.5.0)
-- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/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/vi/packages/vue-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/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)
 
 Framework là `Vue` với một ứng dụng đa ngôn ngữ gồm **10 trang** và **10 ngôn ngữ**.
 

package/docs/vi/chrome_extension.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2026-09-22
+updatedAt: 2026-09-22
+title: Tiện ích mở rộng Chrome & Firefox, Trình quét i18n & SEO
+description: Kiểm tra cấu hình i18n của bất kỳ trang web nào bằng tiện ích mở rộng Intlayer cho Chrome. Phát hiện framework, thư viện i18n, ngôn ngữ, thẻ hreflang và SEO, đồng thời chạy kiểm tra toàn diện i18n SEO.
+keywords:
+  - Tiện ích mở rộng Chrome
+  - Trình quét i18n
+  - Kiểm tra hreflang
+  - SEO đa ngôn ngữ
+  - Intlayer
+  - Bản địa hóa
+  - Công cụ phát triển
+slugs:
+  - doc
+  - chrome-extension
+history:
+  - version: 9.5.6
+    date: 2026-09-22
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Tiện ích mở rộng Chrome & Firefox: Trình quét i18n & SEO
+
+## Tổng quan
+
+[**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc) là tiện ích mở rộng Chrome chính thức dành cho **Intlayer**. Mở tiện ích trên bất kỳ trang web nào để xem cách trang web đó xử lý quốc tế hóa: sử dụng framework và thư viện i18n nào, hỗ trợ những ngôn ngữ (locales) nào và liệu các thẻ SEO đa ngôn ngữ đã được thiết lập chính xác hay chưa.
+
+Tiện ích hoạt động trên mọi trang web, cho dù trang web đó có sử dụng Intlayer hay không.
+
+![Tiện ích mở rộng Intlayer cho Chrome](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension.png?raw=true)
+
+[Liên kết tiện ích Chrome](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc)
+
+[Liên kết tiện ích Firefox](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/)
+
+## Tính năng
+
+- **Phát hiện công nghệ**: nhận diện framework (Next.js, Nuxt, Astro, SvelteKit, Angular, Vue.js, Qwik, React, Gatsby, WordPress) và thư viện i18n (Intlayer, i18next, Vue I18n, @nuxtjs/i18n, Angular @angular/localize, next-intl / next-i18next, Weglot, Localize, WPML, Polylang). Mỗi phát hiện sẽ hiển thị bằng chứng kích hoạt nó, chẳng hạn như biến toàn cục (global variable), cookie hoặc dấu hiệu DOM.
+- **Ngôn ngữ (Locales)**: liệt kê các ngôn ngữ được tìm thấy trong thuộc tính `lang`, thẻ hreflang và `og:locale`, tiền tố ngôn ngữ trên URL, cùng với cookie hoặc mục lưu trữ ngôn ngữ.
+- **Thẻ SEO i18n**: kiểm tra `html lang`, `html dir`, liên kết chuẩn (canonical), thẻ hreflang, `x-default`, `og:locale` và tỷ lệ các liên kết nội bộ được bản địa hóa.
+- **Điều hướng giữa các locale**: chuyển trang hiện tại sang bất kỳ phiên bản bản địa hóa nào chỉ với một cú nhấp, dựa trên các thẻ hreflang.
+- **Tìm kiếm trong sitemap**: tìm kiếm mọi trang được liệt kê trong sitemap của trang web và mở trang đó trong tab hiện tại.
+- **Kiểm tra toàn diện**: chạy cùng một quy trình kiểm tra như [Trình quét SEO i18n](https://intlayer.org/i18n-seo-scanner) và hiển thị điểm số trực tiếp.
+
+## Cài đặt
+
+<Tabs group="browser">
+  <Tab label="Chrome" value="chrome">
+
+Cài đặt [**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc) từ Chrome Web Store, sau đó ghim tiện ích vào thanh công cụ của bạn.
+
+Tiện ích mở rộng hoạt động trên Chrome và bất kỳ trình duyệt dựa trên Chromium nào hỗ trợ các tiện ích mở rộng của Chrome Web Store (Edge, Brave, Arc, Opera).
+
+  </Tab>
+  <Tab label="Firefox" value="firefox">
+
+Cài đặt [**Intlayer i18n Scanner**](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/) từ Firefox Add-ons, sau đó ghim tiện ích vào thanh công cụ của bạn.
+
+  </Tab>
+</Tabs>
+
+## Sử dụng
+
+### Kiểm tra một trang
+
+1. Mở trang web bạn muốn kiểm tra.
+2. Nhấp vào biểu tượng **Intlayer i18n Scanner** trên thanh công cụ.
+3. Cửa sổ bật lên sẽ hiển thị các phần **Công nghệ được phát hiện**, **Ngôn ngữ** và **Thẻ SEO i18n** cho trang hiện tại.
+
+Quá trình phát hiện chạy cục bộ trong trình duyệt của bạn và chỉ trên tab hiện tại.
+
+### Điều hướng giữa các locale
+
+![Điều hướng của tiện ích mở rộng Intlayer cho Chrome](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_navigation.png?raw=true)
+
+Phần **Điều hướng** liệt kê các **Phiên bản bản địa hóa** của trang hiện tại, được đọc từ các thẻ hreflang của trang. Nhấp vào một locale để mở phiên bản đó trong tab hiện tại.
+
+Trong **Các trang trong sitemap**, nhập để tìm kiếm các URL trong sitemap của trang web, rồi nhấp vào một kết quả để mở.
+
+### Chạy kiểm tra toàn diện
+
+![Điểm kiểm tra của tiện ích mở rộng Intlayer cho Chrome](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_audit_score.png?raw=true)
+
+Cuộn xuống phần **Kiểm tra toàn diện** và nhấp vào **Chạy kiểm tra i18n toàn diện**. Kết quả sẽ hiển thị ngay khi từng mục kiểm tra hoàn tất, được nhóm thành:
+
+- **Trang**: thuộc tính `html lang` và `dir`, ngôn ngữ hiện tại, thẻ hreflang, `x-default`, liên kết canonical, liên kết nội bộ được bản địa hóa, bộ chọn ngôn ngữ, biểu tượng cờ và nội dung ngôn ngữ không sử dụng được đính kèm trong bundle JavaScript.
+- **Robots.txt**: sự hiện diện và kiểm tra xem các đường dẫn ngôn ngữ có thể thu thập dữ liệu (crawlable) hay không.
+- **Sitemap**: sự hiện diện, danh sách từng ngôn ngữ, liên kết thay thế và `x-default`.
+- **Tên miền**: số lượng ngôn ngữ được phát hiện trên toàn bộ trang web.
+
+Mỗi mục kiểm tra được đánh dấu là đạt, cảnh báo hoặc không đạt, và điểm số sẽ tóm tắt tình trạng SEO i18n tổng thể của trang.
+
+## Quyền riêng tư và cấp phép
+
+Tiện ích mở rộng chỉ yêu cầu các quyền tối thiểu:
+
+- **activeTab** và **scripting**: bộ phát hiện chỉ chạy trên tab bạn đang xem và chỉ khi bạn mở cửa sổ bật lên.
+- **back.intlayer.org**: chỉ được sử dụng khi bạn chạy kiểm tra toàn diện. URL của trang hiện tại sẽ được gửi đến Intlayer API để quét.
+
+Không có lịch sử duyệt web nào được thu thập và không có gì chạy ngầm.
+
+## Câu hỏi thường gặp
+
+<FAQ>
+
+<Question title="Trang web có cần phải sử dụng Intlayer không?">
+
+Không. Tiện ích có thể kiểm tra bất kỳ trang web nào, bất kể trang đó sử dụng framework hay thư viện i18n nào.
+
+</Question>
+<Question title="Tại sao một công nghệ không được phát hiện?">
+
+Việc phát hiện dựa trên những gì trang web hiển thị trong trình duyệt: biến toàn cục, cookie, thẻ meta và dấu hiệu DOM. Một số bản build production sẽ loại bỏ các dấu hiệu này, vì vậy một thư viện có thể đang được sử dụng mà không để lại dấu vết rõ ràng.
+
+</Question>
+<Question title="Làm cách nào để khắc phục các vấn đề phát hiện bởi kiểm tra?">
+
+Hầu hết các mục kiểm tra đều tương ứng với cấu hình định tuyến hoặc siêu dữ liệu. Với Intlayer, hreflang, canonical, `x-default`, liên kết bản địa hóa, sitemap và robots.txt được tạo tự động từ [cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md) của bạn. Xem hướng dẫn tích hợp cho framework của bạn, ví dụ: [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_16.md), [Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nuxt.md) hoặc [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_tanstack.md).
+
+</Question>
+
+</FAQ>
+
+## Công cụ liên quan
+
+- [Tiện ích mở rộng VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/vs_code_extension.md)
+- [Máy chủ MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/mcp_server.md)
+- [Máy chủ LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/lsp.md)

package/docs/vi/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-12
+updatedAt: 2026-09-21
 title: CLI - Tất cả các lệnh CLI của Intlayer cho trang web đa ngôn ngữ của bạn
 description: Tìm hiểu cách sử dụng Intlayer CLI để quản lý trang web đa ngôn ngữ của bạn. Làm theo các bước trong tài liệu trực tuyến này để thiết lập dự án của bạn trong vài phút.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Thêm lệnh init infra"
   - version: 9.5.2
     date: 2026-09-12
     changes: "Thay thế lệnh `ci` bằng cờ `--ci`"
@@ -151,6 +154,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 ### Cấu hình
 
 - **[Khởi tạo Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/init.md)** - Thiết lập Intlayer trong dự án của bạn với cấu hình tự động
+- **[Thiết lập cơ sở hạ tầng](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/infra.md)** - Cài đặt ứng dụng máy tính để bàn hoặc tự lưu trữ CMS với Docker (tất cả trong một hoặc Compose)
 - **[Quản lý cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/configuration.md)** - Nhận cấu hình Intlayer của bạn và đẩy lên CMS
 
 ### Quản lý tài liệu
@@ -177,6 +181,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 ```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/vi/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Tìm hiểu cách sử dụng lệnh init infra của Intlayer CLI để cài đặt ứng dụng máy tính để bàn hoặc tự lưu trữ Intlayer CMS với Docker (vùng chứa tất cả trong một hoặc ngăn xếp Docker Compose).
+keywords:
+  - CLI
+  - Cơ sở hạ tầng
+  - Tự lưu trữ
+  - Ứng dụng máy tính để bàn
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Thêm lệnh init infra"
+author: aymericzip
+---
+
+# Lệnh Intlayer CLI Init Infra
+
+## Mô tả
+
+Lệnh `init infra` thiết lập cơ sở hạ tầng Intlayer trên máy của bạn. Nó tải xuống trình cài đặt được lưu trữ cho nền tảng của bạn (`https://intlayer.org/install.sh` trên macOS / Linux, `https://intlayer.org/install.ps1` trên Windows) và chạy nó trong terminal của bạn, hiển thị trực tiếp menu và tiến trình cài đặt.
+
+Trình cài đặt sẽ hỏi bạn muốn chạy Intlayer như thế nào:
+
+- **Ứng dụng máy tính để bàn**: tải xuống bảng điều khiển gốc cho hệ điều hành và CPU của bạn rồi mở hoặc cài đặt nó. Phiên bản máy tính để bàn kết nối với backend Intlayer Cloud.
+- **Docker tất cả trong một (All-in-one)**: bảng điều khiển + API + MongoDB + Redis + MinIO trong một vùng chứa duy nhất với một ổ đĩa lưu trữ. Ghi tệp `./intlayer.env` với các khóa bí mật được tạo và kéo hình ảnh `intlayer/cms-all`.
+- **Docker Compose**: một vùng chứa cho mỗi dịch vụ, để tự lưu trữ có thể mở rộng. Ghi `docker-compose.yml` và `.env` vào `./intlayer/` và kéo các hình ảnh.
+
+Trình cài đặt được lưu trữ là nguồn chân lý duy nhất cho quy trình thiết lập: CLI chạy nó thay vì triển khai lại các bước tương tự, do đó `npx intlayer init infra` và `curl -fsSL https://intlayer.org/install.sh | sh` thực hiện hoàn toàn giống nhau.
+
+## Cách sử dụng
+
+```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]
+```
+
+Bước tương tự cũng được cung cấp trong danh sách kiểm tra của `npx intlayer init --interactive`, tại mục **Cơ sở hạ tầng (ứng dụng máy tính để bàn / tự lưu trữ)**.
+
+## Tùy chọn
+
+- `-m, --mode <mode>` - Tùy chọn. Bỏ qua menu của trình cài đặt và chạy trực tiếp một chế độ. Các giá trị được chấp nhận: `desktop`, `docker` (tất cả trong một) hoặc `compose`. Bất kỳ giá trị nào khác sẽ thoát với lỗi liệt kê các chế độ hợp lệ.
+
+## Ví dụ
+
+### Chọn chế độ tương tác
+
+```bash
+npx intlayer init infra
+```
+
+### Cài đặt ứng dụng máy tính để bàn
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### Tự lưu trữ với vùng chứa tất cả trong một
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Tự lưu trữ với Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## Đầu ra ví dụ
+
+```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
+```
+
+## Cài đặt của trình cài đặt
+
+Trình cài đặt đọc một số biến môi trường mà CLI chuyển tiếp nguyên vẹn. Hãy đặt chúng trong shell của bạn trước khi chạy lệnh:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| Biến                      | Mặc định                  | Áp dụng cho | Mô tả                                                     |
+| ------------------------- | ------------------------- | ----------- | --------------------------------------------------------- |
+| `INTLAYER_MODE`           | _(được hỏi)_              | tất cả      | `desktop`, `docker` hoặc `compose`, tương tự như `--mode` |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop     | Nơi lưu trình cài đặt ứng dụng                            |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker      | Hình ảnh tất cả trong một cần tải                         |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker      | Nơi ghi tệp cấu hình môi trường                           |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker      | Tên vùng chứa                                             |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker      | Ổ đĩa có tên được gắn tại `/data`                         |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker      | Cổng máy chủ cho bảng điều khiển                          |
+| `INTLAYER_API_PORT`       | `3100`                    | docker      | Cổng máy chủ cho API                                      |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker      | Cổng máy chủ cho MinIO S3 API                             |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker      | Cổng máy chủ cho bảng điều khiển MinIO                    |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose     | Nơi ghi `docker-compose.yml` và `.env`                    |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | cả hai      | Nhánh Git dùng để lấy tệp compose và mẫu env              |
+
+> Các biến cổng chỉ thay đổi phía **máy chủ (host)** của ánh xạ. Các hình ảnh đã xuất bản đã biên dịch sẵn `http://localhost:3000`, `http://localhost:3100` và `http://localhost:9000` vào gói bảng điều khiển, vì vậy hãy giữ nguyên mặc định trừ khi bạn tự xây dựng hình ảnh: xem [hướng dẫn tự lưu trữ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md#limitations).
+
+## Yêu cầu
+
+- **Ứng dụng máy tính để bàn** cần [Node.js](https://nodejs.org): ứng dụng nhúng máy chủ bảng điều khiển và khởi chạy nó bằng tệp nhị phân `node` của máy.
+- **Chế độ Docker** cần [Docker](https://docs.docker.com/get-docker/) (Docker Desktop với backend WSL 2 trên Windows). Chế độ Compose cũng cần tiện ích mở rộng `docker compose`.
+
+## Ghi chú
+
+- Chạy lại lệnh là an toàn: tệp môi trường hiện có không bao giờ bị ghi đè, đóng vai trò là cách nâng cấp (trình cài đặt kéo các hình ảnh mới nhất và giữ nguyên khóa bí mật của bạn).
+- Trình cài đặt được tải xuống một thư mục tạm thời và bị xóa ngay sau khi thoát, bất kể kết quả thế nào.
+- Mã thoát của lệnh là mã thoát của trình cài đặt. Nếu quá trình tải xuống không thành công, CLI sẽ in lệnh tương đương `curl … | sh` (hoặc `irm … | iex`) để bạn có thể chạy trực tiếp trình cài đặt.
+- Các chế độ Docker vẫn cần một dịch vụ gửi email để gửi email đăng nhập. Sau khi trình cài đặt hoàn tất, hãy định cấu hình Resend hoặc SMTP trong tệp môi trường được tạo: xem [Trình gửi thư toàn cầu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md#global-mailer).
+
+## Liên quan
+
+- [Hướng dẫn tự lưu trữ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md) - Kiến trúc, các bước khởi chạy đầu tiên và giới hạn của từng chế độ
+- [Khởi tạo Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/init.md) - Lệnh `init` cha và danh sách kiểm tra tương tác của nó
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md) - Bảng điều khiển bạn vừa cài đặt làm được những gì

package/docs/vi/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Khởi tạo Intlayer
 description: Tìm hiểu cách khởi tạo Intlayer trong dự án của bạn.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Thêm lệnh con init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Thêm tùy chọn --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 Thao tác này sẽ thiết lập tất cả các tệp cấu hình nhưng sẽ không sửa đổi tệp `.gitignore` của bạn.
 
+### Thiết lập cơ sở hạ tầng (ứng dụng máy tính để bàn hoặc tự lưu trữ):
+
+```bash
+npx intlayer init infra
+```
+
+Tải xuống và chạy trình cài đặt được lưu trữ (`https://intlayer.org/install.sh`, hoặc `install.ps1` trên Windows), hỏi bạn cách muốn chạy Intlayer:
+
+- **Ứng dụng máy tính để bàn** - cài đặt bảng điều khiển gốc trên máy của bạn, kết nối với Intlayer Cloud.
+- **Docker tất cả trong một (All-in-one)** - bảng điều khiển + API + MongoDB + Redis + MinIO trong một vùng chứa duy nhất.
+- **Docker Compose** - một vùng chứa cho mỗi dịch vụ, để tự lưu trữ có thể mở rộng.
+
+Bỏ qua menu với `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+Bước tương tự cũng được cung cấp bởi `npx intlayer init --interactive`. Xem [tài liệu tham khảo `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/infra.md) để biết cài đặt của trình cài đặt và [hướng dẫn tự lưu trữ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md) để biết những gì mỗi chế độ thiết lập.
+
 ## Ví dụ đầu ra:
 
 ```bash