# sing-box 一键安装及管理脚本

这是一个用于快速部署 and 管理 sing-box 的一键脚本。

## 特点

- 快速安装
- 零学习成本
- 自动化 TLS
- 兼容 sing-box 命令
- 强大的快捷参数
- 支持所有常用协议（VLESS-REALITY, TUIC, Trojan, Hysteria2, Shadowsocks, VMess 等）
- 一键启用 BBR

## 安装命令

系统支持：Ubuntu / Debian / CentOS / Alpine / SUSE (仅限 64 位系统，需以 ROOT 用户运行)。

一键安装及管理命令：
```bash
bash <(wget -qO- https://git.lll.rest/svefnz/sing-box/raw/branch/main/install.sh)
```
或者使用 `curl`：
```bash
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`

```
sing-box script v1.0
Usage: sing-box [options]... [args]...

基本:
   v, version                                      显示当前版本
   ip                                              返回当前主机的 IP
   pbk                                             同等于 sing-box generate reality-keypair
   get-port                                        返回一个可用的端口
   ss2022                                          返回一个可用于 Shadowsocks 2022 的密码

一般:
   a, add [protocol] [args... | auto]              添加配置
   c, change [name] [option] [args... | auto]      更改配置
   d, del [name]                                   删除配置**
   i, info [name]                                  查看配置
   qr [name]                                       二维码信息
   url [name]                                      URL 信息
   log                                             查看日志

更改:
   full [name] [...]                               更改多个参数
   id [name] [uuid | auto]                         更改 UUID
   host [name] [domain]                            更改域名
   port [name] [port | auto]                       更改端口
   path [name] [path | auto]                       更改路径
   passwd [name] [password | auto]                 更改密码
   key [name] [Private key | auto] [Public key]    更改密钥
   method [name] [method | auto]                   更改加密方式
   sni [name] [ ip | domain]                       更改 serverName
   new [name] [...]                                更改协议
   web [name] [domain]                             更改伪装网站

进阶:
   dns [...]                                       设置 DNS
   dd, ddel [name...]                              删除多个配置**
   fix [name]                                      修复一个配置
   fix-all                                         修复全部配置
   fix-caddyfile                                   修复 Caddyfile
   fix-config.json                                 修复 config.json
   import                                          导入 sing-box/v2ray 脚本配置

管理:
   un, uninstall                                   卸载
   u, update [core | sh | caddy] [ver]             更新
   U, update.sh                                    更新脚本
   s, status                                       运行状态
   start, stop, restart [caddy]                    启动, 停止, 重启
   t, test                                         测试运行
   reinstall                                       重装脚本

测试:
   debug [name]                                    显示一些 debug 信息, 仅供参考
   gen [...]                                       同等于 add, 但只显示 JSON 内容, 不创建文件, 测试使用
   no-auto-tls [...]                               同等于 add, 但禁止自动配置 TLS, 可用于 *TLS 相关协议
其他:
   bbr                                             启用 BBR, 如果支持
   bin [...]                                       运行 sing-box 命令, 例如: sing-box bin help
   [...] [...]                                     兼容绝大多数的 sing-box 命令, 例如: sing-box generate uuid
   h, help                                         显示此帮助界面

谨慎使用 del, ddel, 此选项会直接删除配置; 无需确认
```