From 97d1804a392b9ed53827b40d4fe01629a8902edb Mon Sep 17 00:00:00 2001
From: svefnz <svefnz@gmail.com>
Date: Wed, 8 Jul 2026 15:57:38 +0800
Subject: [PATCH] docs: document command-line node creation and HAProxy L4
 fallback routing in README

---
 README.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/README.md b/README.md
index 0f12c4f..f5d1008 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,37 @@ bash <(wget -qO- https://git.lll.rest/svefnz/sing-box/raw/branch/main/install.sh
 bash <(curl -fsSL https://git.lll.rest/svefnz/sing-box/raw/branch/main/install.sh)
 ```
 
+## 命令行快捷创建
+
+脚本支持非交互式命令行一键创建节点。如果不需要手动指定某项参数，可直接传入 `auto` 由脚本随机生成。同时，你可以在命令的**最后一个参数**位置传入你的**自定义节点备注名称**（用于生成的订阅/节点链接末尾显示）：
+
+### 1. 创建 VLESS-REALITY (18号节点)
+* **格式**：`sb add reality [端口] [UUID | auto] [SNI域名 | auto] [自定义备注 | auto]`
+* **示例**：
+  ```bash
+  # 自动生成 UUID 和 SNI，并将节点备注命名为 my-reality
+  sb add reality 443 auto auto my-reality
+  ```
+
+### 2. 创建 VLESS-HTTPUpgrade-TLS (16号节点)
+* **格式**：`sb add vhu [域名] [UUID | auto] [路径 | auto] [自定义备注 | auto]`
+* **示例**：
+  ```bash
+  # 自动生成 UUID 和 路径，并将节点备注命名为 my-upgrade
+  sb add vhu yourdomain.com auto auto my-upgrade
+  ```
+
+---
+
+## HAProxy 四层分流回落
+
+当你在安装了 Caddy 的 VPS 上创建 **VLESS-REALITY (443端口)** 节点时，脚本会提示你是否开启 **Caddy 回落分流**：
+1. **端口共用**：开启后，脚本会自动部署并启用 HAProxy 监听外部 `443` 端口进行四层流量分流。
+2. **流量分发**：对于 Reality 代理请求，HAProxy 会将其转发给 sing-box 处理；对于普通网页请求或 Caddy-based TLS 节点请求，HAProxy 会自动将其透传/回落给 Caddy 服务。
+3. **自动变换**：脚本会自动处理 Caddy https 默认端口修改（由 443 改为 4443）及其他 Caddy 独立站配置端口的重定向，无需任何手动编辑，卸载时也会自动还原。
+
+---
+
 ## 帮助信息
 
 使用：`sing-box help`