s-ui Windows部署全攻略：零基础避坑指南

如何明确代理服务部署需求？

在开始部署前，需要清晰定位自身需求场景，以下是常见的应用场景及对应配置重点：

• 个人用户场景：单设备代理需求，关注基础连接稳定性
• 家庭网络场景：多设备共享代理，需配置端口映射（Port Mapping：实现网络地址转换的技术）
• 小型团队场景：需关注用户管理和流量控制功能

通过明确使用场景，可以更精准地配置服务参数，避免资源浪费和功能冗余。

如何验证系统兼容性？

环境预检测脚本

在进行正式安装前，建议先执行环境检测。创建文本文件并命名为check_env.bat，输入以下内容：

@echo off
echo 系统兼容性检测...
systeminfo | findstr /i "OS Name"
systeminfo | findstr /i "系统类型"
netstat -ano | findstr ":2095"
netstat -ano | findstr ":2096"
echo 检测完成。若2095/2096端口已被占用，请先关闭对应进程

右键以管理员身份运行该脚本，检查输出结果是否满足以下条件：

• 操作系统显示为Windows 10/11 64位
• 系统类型包含"x64-based PC"
• 2095和2096端口未被占用（无对应输出行）

⚠️ 风险提示：使用32位系统或低于Windows 10的版本会导致服务无法启动

核心部署流程如何操作？

1. 获取项目代码

git clone https://gitcode.com/GitHub_Trending/su/s-ui

2. 执行系统服务封装组件安装

进入项目目录，找到windows/install-windows.bat文件，右键选择"以管理员身份运行"。安装过程中需设置以下关键参数：

参数类别	参数名称	默认值	推荐值	风险等级	功能说明
访问配置	管理面板端口	2095	2095	低	Web管理界面的访问端口
访问配置	面板访问路径	/app/	/admin/	中	管理后台的URL路径，建议修改增强安全性
访问配置	订阅服务端口	2096	2096	低	订阅功能的服务端口
账户配置	管理员用户名	admin	自定义	高	登录管理面板的用户名
账户配置	管理员密码	-	强密码	高	登录密码，建议包含大小写字母、数字和特殊符号

3. 服务状态验证

安装完成后，执行以下命令验证服务状态：

sc query s-ui

若显示"RUNNING"状态，则表示服务启动成功。

如何探索系统核心功能？

服务管理功能

通过windows/s-ui-windows.bat文件可访问控制面板，主要功能包括：

• 服务启停控制：实现服务的启动、停止和重启操作
• 状态监控：实时显示CPU、内存占用和连接数等关键指标
• 日志查看：提供最近7天的运行日志查询
• 配置备份：支持关键配置文件的导出和导入

目录结构解析

安装完成后，系统会在C:\Program Files\s-ui\创建以下目录结构：

C:\Program Files\s-ui\
├── sui.exe          # 主程序可执行文件
├── db\              # 数据库文件存储目录
├── logs\            # 运行日志文件
├── cert\            # SSL证书存储目录
└── config\          # 配置文件目录
    ├── main.json    # 主配置文件
    └── security.json # 安全相关配置

关键文件说明：

• main.json：包含端口设置、路径配置等核心参数
• security.json：存储用户账户信息和权限配置

常见问题如何系统排查？

故障树分析

graph TD
    A[部署问题] --> B{问题类型}
    B -->|服务启动失败| C[检查日志文件]
    B -->|无法访问面板| D[网络排查]
    B -->|功能异常| E[配置检查]
    
    C --> C1[日志路径: C:\Program Files\s-ui\logs\error.log]
    C --> C2[常见原因: 端口冲突/权限不足]
    
    D --> D1[检查防火墙设置]
    D --> D2[验证端口监听状态]
    D --> D3[测试网络连通性]
    
    E --> E1[配置文件完整性检查]
    E --> E2[参数格式验证]

典型问题解决方案

1. 服务安装失败

   • 症状：安装脚本闪退或提示"拒绝访问"
   • 解决：确保以管理员身份运行，检查目标分区是否有足够空间

2. 面板访问超时

   • 症状：浏览器显示"无法连接"
   • 解决：执行netstat -ano | findstr ":2095"确认端口是否监听，检查Windows防火墙是否允许该端口入站连接

3. 订阅功能异常

   • 症状：客户端无法获取订阅内容
   • 解决：检查2096端口状态，验证config/main.json中的订阅路径配置是否正确

通过以上系统化的部署流程和问题解决方法，即使是零基础用户也能顺利完成s-ui在Windows环境下的部署。建议定期执行windows/s-ui-windows.bat中的"系统维护"功能，确保服务长期稳定运行。