v4.0.0 是 Splicore-native 架构的首个正式版本。 普通代理协议以固定的 Splicore v0.3.0-rc.4 为唯一主运行时，NoBrand 负责安装、配置、客户端输出和生命周期管理。
当前稳定版本：v4.0.1。更新内容见 CHANGELOG。
v4.0.1 修复创建节点完成后、“查看节点”和协议快捷命令的客户端配置终端展示；分享链接可直接复制，Mihomo / Clash Meta 配置显示为正常多行 YAML，并改善端点与多配置展示。机器可读 client_profiles 数据保持兼容。
需要干净安装。旧版 NoBrand 多 Core 安装不支持原地升级、自动迁移或由新版直接卸载／转换。
- 使用原 3.x 版本保存／导出现有客户端信息。
- 使用对应旧版本完成卸载。
- 确认旧 NoBrand-owned runtime、service 和 state 已清理。
- 使用当前 v4.x 稳定版干净安装。
- 使用当前 v4.x 稳定版重新生成并导入客户端配置。
检测到 NoBrand 拥有的旧状态、二进制或服务时，新版在创建锁、安装依赖、下载和服务操作前拒绝。第三方独立安装的同名软件不会被当作 NoBrand 资源。
| 协议 / 模式 | 当前实现 | 本轮实际验证 |
|---|---|---|
| Mieru TCP / UDP / BOTH | Splicore；MTU、多路复用、客户端握手模式；默认 traffic off | TCP 新配置流量、重启和 SIGKILL 恢复；UDP/BOTH 配置校验 |
| Snell v4 / v5 | Splicore；v5 服务端按公开合同使用 v4 客户端 wire；QUIC Proxy Mode 不支持 | v5 服务端 TCP/UDP、新配置、重启和恢复 |
| Hysteria2 + Salamander | Splicore；新 CA + 服务器叶证书；独立 auth/obfs secret | TCP/UDP、证书 pin、错误凭据拒绝、重启和恢复 |
| TUIC v5 | Splicore；UUID + password；新 TLS 信任 | TCP/UDP、新配置、重启和恢复 |
| VLESS + TCP + REALITY + Vision | Splicore 原生 Local Tunnel Guard | 新配置流量、安全探针、重启和恢复 |
| VLESS + FinalMask/Sudoku | 项目已有的专用 pinned Xray 例外 | 既有静态/事务测试；不属于普通协议主运行时 |
| SSH Tunnel | 系统 OpenSSH 策略与账号 | 保留原组件，隔离单元/事务测试 |
| Port Forward | Realm / nftables | 保留原组件，隔离单元/事务测试 |
Mieru 流量伪装、低熵、配额、到期、tc 限速及独立 Mita 版本通道不在当前原生界面中；显式请求不支持的配置会报错。HY2 Gecko 为 Core Experimental 能力，端口跳跃为 Core 支持能力，两者均未在 NoBrand 中开放，默认不启用端口范围。
从 GitHub Latest Release 下载正式单文件安装器，再执行安装：
curl -fsSLO https://github.com/ike-sh/NoBrand-OneClick/releases/latest/download/install-nobrand.sh
sudo bash install-nobrand.sh也可从 v4.0.1 Release 下载 install-nobrand.sh 和 SHA256SUMS，在同一目录执行 sha256sum -c SHA256SUMS 后安装。
Alpine Linux 请先安装 bash 与 curl，然后以 root 身份执行 bash install-nobrand.sh。
管理命令与示例配置：
# 也可先安装管理命令
sudo bash install-nobrand.sh manager install
sudo nobrand mieru install --user primary --port 31001 --advertise-host entry.example -y
sudo nobrand snell install --name snell --version 5 --port 31002 --advertise-host entry.example -y
sudo nobrand hy2 install --port 31003 --sni tls.example --advertise-host entry.example -y
sudo nobrand tuic install --name tuic --user primary --port 31004 --advertise-host entry.example -y
sudo nobrand vless-reality install --name reality --target www.microsoft.com --port 31005 --advertise-host entry.example -yentry.example、端口和 TLS/cover 域名是占位值。监听端口与展示端点分开；--advertise-auto 可探测展示地址。REALITY cover 需要可用的 TLS 服务。多个普通协议由一个 nobrand-splicore 服务承载；仅在候选校验时短暂启动私有验证进程。
nobrand status
nobrand doctor
nobrand nodes
nobrand runtime capabilities
nobrand runtime plan
nobrand hy2 show
nobrand vless-reality export --name reality
sudo nobrand runtime restart
sudo nobrand runtime rollback
sudo nobrand backup create /root/nobrand-native.tar.gz
sudo nobrand backup restore /root/nobrand-native.tar.gz
sudo nobrand uninstall客户端导出是显式敏感操作；请私下保存。状态、doctor 和 plan 不输出密码或 REALITY 私钥。备份含私钥、客户端凭据与数据库主密钥，文件权限为 0600。
HY2/TUIC 默认生成新的私有 CA 和非 CA 服务器叶证书，校验 SAN、有效期、KeyUsage、serverAuth、链顺序和私钥匹配。CA 签名私钥生成后删除。sing-box 配置携带 CA 并验证主机名；Mihomo 配置带显式叶证书 SHA256 pin。HY2 URI 使用 insecure=1&pinSHA256=... 表达私有信任的强制 pin，不能删除 pin 或交给忽略 pin 的客户端。优先导入完整配置。自备证书使用显式 canonical desired state；项目不管理 ACME。
REALITY 目标是一个仅监听回环的原生 guard。guard 只将允许的 cover SNI 放行到固定目标，其后紧跟该 guard 的 reject 规则；HTTP、随机 TCP、畸形 TLS 和缺失 SNI 均拒绝。已认证的 VLESS 代理负载仍是正常代理流量，不继承 cover SNI 白名单；这不是旧 Xray defender/private-IP 防火墙的逐字段等价实现。
旧 NoBrand → 新架构：不支持原地迁移。新版只检测并拒绝，不备份、转换或删除旧资源。
新架构 → 未来 Splicore：保留原子 artifact、候选 generation、持久事务和已知可用版本回滚。升级前必须审核新 release manifest；当前仅允许 rc.4，不能任意传入未来版本。相同版本和配置执行校验后 NO-OP。失败的新装恢复到未安装状态，失败的配置更新恢复上一代 Splicore。
bash scripts/build.sh
bash scripts/test.sh自动回归覆盖 31 个 Bash 入口、149 项 Python 测试（含 24 项客户端展示测试）、42 项真实 rc.4 回环 runtime 检查和 114 个 shell 语法检查；同时执行 ShellCheck、构建一致性、脱敏扫描及 GitHub Actions。普通测试保持调用者身份，九个必需 fixture 边界使用已验证的直接 root、非交互 sudo 或兼容 user namespace。真实流量结果及其范围见验收报告。
测试范围与当前限制：
-
专用原生 Linux amd64 systemd 安装／破坏性生命周期／真实 reboot 资格尚未单独完成；回环结果不等同于实机 reboot 认证。
-
arm64 公开 artifact 已有构建与静态检查，runtime 资格尚未完成。
-
OpenRC adapter 与模板受支持，原生运行资格仍待独立环境。
-
HY2 Gecko 与端口跳跃／nftables 端口范围未在 NoBrand 当前界面开放。
-
GitHub Actions 的 Node runtime 警告是非阻断维护事项。
-
历史迁移报告：保留原有 BLOCKED/PENDING 结论，不能当作本轮验收结果。
GPL-3.0。来源与第三方依赖见 THIRD_PARTY_NOTICES.md。