chore: prepare v2.1.12

Author: 0xJacky

app/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nginx-ui-app-next",
   "type": "module",
-  "version": "2.1.11",
+  "version": "2.1.12",
   "packageManager": "[email protected]+sha512.5ea8b0deed94ed68691c9bad4c955492705c5eeb8a87ef86bc62c74a26b037b08ff9570f108b2e4dbd1dd1a9186fea925e527f141c648e85af45631074680184",
   "scripts": {
     "dev": "vite --host",

app/src/version.json

@@ -1 +1 @@
-{"version":"2.1.11","build_id":1,"total_build":450}
+{"version":"2.1.12","build_id":1,"total_build":451}

docs/.vitepress/config/en.ts

@@ -18,6 +18,7 @@ export const enConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
           items: [
             { text: 'What is Nginx UI?', link: '/guide/about' },
             { text: 'Getting Started', link: '/guide/getting-started' },
+            { text: 'Install with Homebrew', link: '/guide/install-homebrew' },
             { text: 'Install Script', link: '/guide/install-script-linux' }
           ]
         },

docs/.vitepress/config/zh_CN.ts

@@ -23,6 +23,7 @@ export const zhCNConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
           items: [
             { text: '何为 Nginx UI?', link: '/zh_CN/guide/about' },
             { text: '即刻开始', link: '/zh_CN/guide/getting-started' },
+            { text: '使用 Homebrew 安装', link: '/zh_CN/guide/install-homebrew' },
             { text: '安装脚本', link: '/zh_CN/guide/install-script-linux' }
           ]
         },

docs/.vitepress/config/zh_TW.ts

@@ -23,6 +23,7 @@ export const zhTWConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
           items: [
             { text: '何為 Nginx UI?', link: '/zh_TW/guide/about' },
             { text: '即刻開始', link: '/zh_TW/guide/getting-started' },
+            { text: '使用 Homebrew 安裝', link: '/zh_TW/guide/install-homebrew' },
             { text: '安裝指令碼', link: '/zh_TW/guide/install-script-linux' }
           ]
         },

docs/guide/getting-started.md

@@ -30,17 +30,79 @@ information: [debian/conf/nginx.conf](https://salsa.debian.org/nginx-team/nginx/
 
 ## Installation
 
-We recommend using the [installation script](./install-script-linux) for Linux users, in which case you can directly
-control the host machine's Nginx. You can also [install via Docker](#install-with-docker), where our provided image
-includes Nginx and can be used bundled. For advanced users, you may also visit the [latest release](https://github.com/0xJacky/nginx-ui/releases/latest)
-to download the latest distribution and [run executable directly](#run-executable-directly), or [manually build it](./build).
+We provide several installation methods to suit different needs:
+
+- **macOS/Linux**: Use [Homebrew](./install-homebrew) for the easiest installation
+- **Linux**: Use the [installation script](./install-script-linux) to directly control the host machine's Nginx
+- **Docker**: [Install via Docker](#install-with-docker) with our bundled image that includes Nginx
+- **Advanced**: Download from [latest release](https://github.com/0xJacky/nginx-ui/releases/latest) and [run executable directly](#run-executable-directly), or [manually build it](./build)
 
 In the first runtime of Nginx UI, please visit `http://<your_server_ip>:<listen_port>`
 in your browser to complete the follow-up configurations.
 
 In addition, we provide [an example](./nginx-proxy-example) of using Nginx to reverse proxy Nginx UI,
 which can be used after installation is complete.
 
+## Install with Homebrew
+
+For macOS and Linux users, you can install Nginx UI using Homebrew, which provides the easiest installation experience.
+
+::: tip
+
+This installation method is available for macOS and Linux. For other operating systems, please use alternative installation methods.
+
+:::
+
+### Install
+
+```bash
+brew install 0xjacky/tools/nginx-ui
+```
+
+### Start Service
+
+```bash
+# Start the service
+brew services start nginx-ui
+
+# Or run in foreground
+nginx-ui
+```
+
+### Stop Service
+
+```bash
+brew services stop nginx-ui
+```
+
+### Upgrade
+
+```bash
+brew upgrade nginx-ui
+```
+
+### Uninstall
+
+```bash
+# Stop the service first
+brew services stop nginx-ui
+
+# Uninstall the package
+brew uninstall nginx-ui
+
+# Optionally remove the tap
+brew untap 0xjacky/tools
+```
+
+::: warning
+
+After uninstalling, configuration files and data will be preserved in:
+- **macOS**: `~/Library/Application Support/nginx-ui/`
+- **Linux**: `~/.local/share/nginx-ui/` or `~/.config/nginx-ui/`
+
+If you want to completely remove all data, please delete these directories manually.
+
+:::
 
 ## Install with Docker