Text Matrix
技术笔记 行业快讯 视频精读 财富自由 思考与随笔 搜索
Text Matrix

目录

S-UI：SagerNet/Sing-Box 多协议 Web 管理面板快速上手

 收录于 技术笔记
   约 6468 字   预计阅读 17 分钟 

S-UI：SagerNet/Sing-Box 多协议 Web 管理面板快速上手

学习目标

读完本文后，你应该能够：

  • 理解 S-UI 的系统定位：它是 SagerNet/Sing-Box 的可视化管控工具，而不是代理协议实现
  • 独立完成 S-UI 在 Linux/macOS/Windows/Docker 环境下的安装与基础配置
  • 使用 S-UI 面板完成一个 VLESS + TLS 的 inbound 完整接入流程
  • 区分 S-UI 的适用场景与不适用场景，判断它是否适合你的需求
  • 解决 S-UI 使用中的常见坑点（端口占用、订阅链接打不开、Docker 数据目录权限等）

目录

系统定位

S-UI 是一个构建在 SagerNet/Sing-Box 之上的高级 Web 管理面板，目前在 GitHub 已有约 8900 颗星、1500 个 Fork。项目核心目标是让用户通过图形界面管理多种代理协议节点，无需手工编辑配置文件即可完成节点接入、流量监控和订阅分发。

本文面向有代理协议使用基础、想通过 Web 面板集中管理多个节点的技术用户，介绍如何快速完成安装、配置核心功能和日常使用边界。

系统定位

S-UI 本质上是一个前端交互层 + 后端 Go 服务，它调用 Sing-Box 的 API 来管理节点配置和收集流量数据。Sing-Box 负责底层代理能力，S-UI 负责把这些能力暴露成可操作的图形界面。

所以 S-UI 是 Sing-Box 的可视化管控工具，不是代理协议实现。它的主要能力在于：

  • 多协议统一接入：一个面板管理 VLESS、VMess、Trojan、Shadowsocks、Hysteria、TUIC 等多种协议节点。
  • 多客户端/ inbound 管理：同面板下管理多个客户端，每个客户端可以单独设置流量限额和过期时间。
  • 订阅服务：内置订阅生成器，支持 link/json/clash+info 三种格式。
  • 流量可视化：实时展示每个 inbound 的流量使用情况以及系统状态。
  • 多语言界面：支持英语、波斯语、越南语、简体中文、繁体中文、俄语。

⚠️ 项目免责声明明确指出：该软件仅用于个人学习与沟通，请勿用于非法用途，请勿在生产环境中使用。

快速安装

Linux / macOS 一键脚本

bash <(curl -Ls https://raw.githubusercontent.com/alireza0/s-ui/master/install.sh)

脚本会自动检测操作系统和 CPU 架构，适配 amd64、arm64、armv7、armv6、armv5、386、s390x 等平台。安装完成后面板运行在 2095 端口，订阅服务运行在 2096 端口，默认账号密码均为 admin。

Windows

  1. 从 GitHub Releases 下载最新的 Windows 包（如 s-ui-windows-amd64.zip）。
  2. 解压到任意目录。
  3. 以管理员身份运行 install-windows.bat，按向导完成安装。
  4. 安装完成后访问 http://localhost:2095/app。

Docker 部署

mkdir s-ui && cd s-ui
wget -q https://raw.githubusercontent.com/alireza0/s-ui/master/docker-compose.yml
docker compose up -d

容器暴露的端口为 2095（面板）、2096（订阅）、443、80，数据目录映射到 db/ 和 cert/。

环境变量配置

变量类型默认值说明
SUI_LOG_LEVELstring"info"日志级别：debug/info/warn/error
SUI_DEBUGbooleanfalse开启调试模式
SUI_BIN_FOLDERstring"bin"二进制文件目录
SUI_DB_FOLDERstring"db"数据库文件目录
SINGBOX_APIstring-外部 Sing-Box API 地址

核心功能一览

支持的协议

S-UI 对接 Sing-Box，支持以下协议族：

通用协议：Mixed、SOCKS、HTTP、HTTPS、Direct、Redirect、TProxy

V2Ray 系协议：VLESS、VMess、Trojan、Shadowsocks

其他协议：ShadowTLS、Hysteria、Hysteria2、Naive、TUIC

同时支持 XTLS 协议，以及透明代理、SSL 证书、端口管理等高级路由配置。

inbound 管理

每个 inbound 代表一个客户端接入点。面板支持为每个 inbound 设置：

  • 通信协议和加密参数
  • 流量上限（traffic cap）和到期时间
  • 启用/禁用状态

inbound 列表页会实时展示每个客户端的连接数和流量消耗，方便判断哪些节点压力较大。

订阅服务

面板内置订阅生成器，无需额外配置即可对外提供订阅链接。支持的格式：

  • 通用 link：原始节点链接
  • JSON：节点配置 JSON 格式
  • Clash + info：Clash 格式并附带节点信息

订阅服务默认端口 2096、路径 /sub/。可以通过环境变量或配置文件修改端口和路径。

主题与多语言

面板支持 Dark/Light 主题切换，界面语言目前支持英、中（简/繁）、波斯、越南、俄语共 6 种语言。

一个 inbound 的完整接入流程

以创建一个 VLESS + TLS 的 inbound 为例，走一遍面板的标准操作路径：

  1. 登录面板（默认 http://localhost:2095/app，账号 admin/admin）。
  2. 进入 Inbound 管理页，点击 Add Inbound。
  3. 选择协议类型为 VLESS，填写节点标签和端口。
  4. 设置传输层参数（TLS 证书路径、域名、SNI 等）。
  5. 填写客户端 UUID（可用面板一键生成）。
  6. 设置流量限额和过期时间（可选）。
  7. 保存。此时面板会通过 Sing-Box API 注册这个 inbound，并返回节点链接或订阅地址。

订阅格式的选择取决于客户端：普通代理工具通常使用 link 格式，Clash 系列客户端使用 Clash 格式。

这个流程覆盖了面板最常用的场景。如果需要做端口映射、域名分流或 PROXY Protocol 配置，可以在 inbound 高级设置里找到对应选项。

常见坑点

端口被占用：安装脚本不会自动检查 2095/2096 端口是否已被占用。如果安装失败，先确认端口状态或手动修改配置。

订阅链接打不开：检查防火墙是否放行 2096 端口，订阅路径是否被 URL 过滤工具拦截。Clash 格式的订阅在部分客户端里可能需要 Base64 解码后才能使用。

Docker 部署时数据目录权限：映射 db/ 目录时如果遇到写入权限问题，确认容器内运行用户对主机目录有写权限，或者在 docker-compose 里以 user: uid:gid 方式指定。

多客户端流量统计：面板统计的是 S-UI 已注册的 inbound 流量，如果节点直连绕过 Sing-Box，流量不会被计入。

适用边界

S-UI 适合以下场景：

  • 个人或小团队管理 3~10 个代理节点，需要图形化配置而不是改配置文件。
  • 需要为不同用户/设备分配独立账号和流量配额。
  • 需要集中生成多个客户端的订阅链接。

不适合以下场景：

  • 需要在生产环境长期运行（项目明确不建议）。
  • 需要对海量节点做精细化路由策略（面板提供基础的路由配置，但深度定制仍需编辑 Sing-Box 配置文件）。
  • 对安全审计有严格要求的环境（面板默认账密简单，建议安装后立即修改密码并启用 TLS）。

项目结构速览

S-UI 后端采用 Go 编写，主要目录结构如下：

目录作用
api/REST API 路由定义
app/inbound/用户/订阅等业务逻辑
cmd/命令行入口
config/配置加载与校验
core/核心业务逻辑
database/数据持久化（SQLite）
network/网络相关处理
service/系统服务（定时任务、健康检查）
sub/订阅生成器
web/前端静态文件（编译后）
middleware/HTTP 中间件

前端代码在独立的 s-ui-frontend 仓库，作为 git submodule 引入主项目。

维护状态

项目最近一次提交为 2026-05-19，距今约 2 天（数据采集时），维护活跃度高。GitHub Issues 约有 39 个 open issues，说明社区反馈活跃。License 为 GPL-3.0。

自测题

请回答以下问题，检验你对 S-UI 的掌握程度：

问题 1：S-UI 和 Sing-Box 的关系是什么？

查看答案S-UI 本质上是一个**前端交互层 + 后端 Go 服务**，它调用 Sing-Box 的 API 来管理节点配置和收集流量数据。Sing-Box 负责底层代理能力，S-UI 负责把这些能力暴露成可操作的图形界面。所以 S-UI 是 Sing-Box 的可视化管控工具，不是代理协议实现。

问题 2：S-UI 安装后，面板和订阅服务分别运行在哪个端口？

查看答案面板运行在 **2095 端口**，订阅服务运行在 **2096 端口**。默认账号密码均为 `admin`。

问题 3：S-UI 支持哪些订阅格式？

查看答案支持三种格式：1) **通用 link**：原始节点链接；2) **JSON**：节点配置 JSON 格式；3) **Clash + info**：Clash 格式并附带节点信息。

问题 4：在 S-UI 中创建一个 VLESS + TLS 的 inbound，需要哪些步骤？

查看答案1. 登录面板（默认 http://localhost:2095/app，账号 admin/admin） 2. 进入 **Inbound** 管理页，点击 **Add Inbound** 3. 选择协议类型为 **VLESS**，填写节点标签和端口 4. 设置传输层参数（TLS 证书路径、域名、SNI 等） 5. 填写客户端 UUID（可用面板一键生成） 6. 设置流量限额和过期时间（可选） 7. 保存。此时面板会通过 Sing-Box API 注册这个 inbound，并返回节点链接或订阅地址

问题 5：使用 S-UI 时，哪些场景下它不适合？

查看答案- ❌ 需要在生产环境长期运行（项目明确不建议） - ❌ 需要对海量节点做精细化路由策略（面板提供基础的路由配置，但深度定制仍需编辑 Sing-Box 配置文件） - ❌ 对安全审计有严格要求的环境（面板默认账密简单，建议安装后立即修改密码并启用 TLS）

练习

练习 1：基础环境搭建

任务：在你的本地环境（Linux/macOS/Windows/Docker）安装 S-UI，并完成首次登录。

步骤：

  1. 选择一种安装方式（一键脚本/Docker/Windows 包）
  2. 完成安装，记录面板地址、端口、默认账号密码
  3. 首次登录，修改默认密码
  4. 检查面板是否正常显示：多协议支持、多客户端管理、流量可视化、主题切换

预期结果：成功登录面板，能够看到所有核心功能模块。

练习 2：第一个 inbound 接入

任务：创建一个 VLESS + TLS 的 inbound，并生成订阅链接。

步骤：

  1. 准备一个域名和 TLS 证书（可以使用 Let’s Encrypt 免费证书）
  2. 在面板中进入 Inbound 管理页，点击 Add Inbound
  3. 选择协议类型为 VLESS，填写节点标签和端口
  4. 设置传输层参数（TLS 证书路径、域名、SNI 等）
  5. 填写客户端 UUID（可用面板一键生成）
  6. 保存，获取节点链接或订阅地址
  7. 在客户端（如 V2RayN、Clash）中导入订阅链接，测试连接

预期结果：客户端成功连接，能够访问互联网。

练习 3：流量监控与客户端管理

任务：创建多个客户端，设置流量限额和过期时间，并监控流量使用情况。

步骤：

  1. 在已创建的 inbound 中，添加 3 个客户端（每个客户端有独立的 UUID）
  2. 为每个客户端设置流量上限（如 100GB）和过期时间（如 30 天后）
  3. 使用这些客户端连接，消耗部分流量
  4. 在面板中查看流量使用情况：每个客户端的连接数和流量消耗
  5. 测试流量超限或过期后的行为

预期结果：面板能够正确显示流量使用情况，并在超限或过期后阻止连接。

进阶路径

如果你想深入掌握 S-UI 并扩展到更复杂的代理管理场景，可以按以下路径进阶：

第一步：理解 Sing-Box 核心架构（1-2 周）

  • 深入阅读 Sing-Box 官方文档，理解其配置格式和核心概念（inbound、outbound、routing、dns 等）
  • 理解 S-UI 如何通过 API 与 Sing-Box 交互
  • 尝试手动编辑 Sing-Box 配置文件，对比面板生成的配置

第二步：掌握 S-UI 高级功能（2-3 周）

  • 学习如何配置端口映射、域名分流、PROXY Protocol
  • 理解透明代理的配置方式
  • 学习如何对接 SSL 证书自动续期（如 ACME）
  • 掌握多用户管理和流量统计的底层实现

第三步：生产环境部署与优化（3-4 周）

  • 学习如何在不熟环境长期运行 S-UI + Sing-Box
  • 配置 HTTPS + TLS 保护面板访问
  • 设置防火墙规则，只开放必要端口
  • 配置自动备份，定期备份数据库和配置文件
  • 监控系统资源（CPU、内存、带宽），及时发现异常

第四步：定制化开发与扩展（4-8 周）

  • 阅读 S-UI 源码，理解其后端 Go 架构和前端 Vue 实现
  • 尝试开发自定义功能：如支付宝/微信支付对接、流量报警、IP 黑名单等
  • 学习如何编译自定义版本，移除不需要的功能或添加新特性
  • 参与开源社区，提交 PR 或 Issue

第五步：构建完整的代理解决方案（持续）

  • 整合 S-UI + Sing-Box + DNS 加密 + IP 清洗
  • 学习负载均衡和故障转移策略
  • 研究抗封锁技术（如 VLESS + XTLS、ShadowTLS 等）
  • 关注 S-UI 和 Sing-Box 的最新动态，及时升级

资料口径说明

本文在编写时基于以下来源和假设，请读者注意信息的边界：

  1. 信息来源与时效性：本文基于 S-UI GitHub 仓库（https://github.com/alireza0/s-ui）的 README 和源码分析，数据截至 2026-05-19。项目仍在活跃开发中，本文描述的功能、配置方式可能随版本更新而变化，请以最新源码和官方文档为准。

  2. 技术细节验证：本文描述的 S-UI 功能（多协议支持、订阅服务、流量监控等）基于源码中的 api/、app/、packages/ 目录结构，但实际配置参数和 API 接口可能因版本不同而有所差异。建议在实际使用前阅读对应版本的官方文档。

  3. 安全建议的有效性：本文提到的安全建议（修改默认密码、启用 TLS、配置防火墙等）是基于通用安全最佳实践，并非来自 S-UI 官方文档。实际部署时，请参考官方安全指南和你的具体环境。

  4. 未覆盖的内容：本文未深入讨论以下主题：

    • Sing-Box 的高级路由配置（如地理封锁、应用分流等）
    • S-UI 的高可用部署（如主从备份、容器编排等）
    • 与第三方系统的集成（如支付系统、工单系统等）
    • 在 ARM 架构设备（如树莓派）上的部署优化
    • 法律合规性分析（代理工具的使用需遵守当地法律法规）

  5. 术语使用说明：

    • “Sing-Box” 指一个支持多协议的网络代理核心（https://github.com/SagerNet/sing-box）
    • “S-UI” 指基于 Sing-Box 的 Web 管理面板
    • “inbound” 指客户端接入点，即用户连接的端点
    • “订阅” 指自动生成客户端配置文件的服务

  6. 更新记录：

    • 2026-05-22：初始版本，基于 S-UI 最新版本编写
    • 2026-06-30：增加学习目标、目录、自测题、练习、进阶路径、资料口径说明章节，优化为教学文档

参考链接

  • GitHub：https://github.com/alireza0/s-ui
  • 前端仓库：https://github.com/alireza0/s-ui-frontend
  • Telegram 群组（官方支持）：https://t.me/XrayUI
  • API 文档：https://github.com/alireza0/s-ui/wiki/API-Documentation
更新于 2026-07-21
 Sing-Box, SagerNet, 代理面板, 多协议, 网络工具
返回 | 主页

下一步

如果这篇内容对你有帮助，继续往更完整的路径里走。

你可以从专题页继续系统阅读，也可以通过联系页反馈想跟进的主题、工具和合作方向。

AI Agent 专题 Coding Agent 专题 开源 AI 工具 联系

继续阅读

与这篇内容相关的文章

技术笔记

CFnew - Cloudflare Workers 代理订阅管理面板

CFnew 是一款基于 Cloudflare Workers 和 Pages 的代理订阅管理工具，支持 VLESS、Trojan、xhttp 多协议，可生成 Clash、Surge、Sing-box 等多种客户端配置。本文详细解析其架构、部署流程、配置策略和高级用法。

技术笔记

The Book of Secret Knowledge：运维安全从业者的终极工具索引

The Book of Secret Knowledge 是 trimstray 在 GitHub 上维护的一个巨型工具索引仓库，收录 CLI/GUI 工具、Web 服务、渗透测试、系统加固等领域的精选资源，面向系统管理员、DevOps 和安全研究员。本文从项目定位、章节结构、核心亮点三个维度进行全面解读，并给出阅读建议与适用边界分析。