S-UI 代理管理平台从零部署完全指南

一、系统环境适配指南：如何确保设备满足运行要求

兼容性验证清单

在启动S-UI部署前，请确认您的系统符合以下技术规范：

配置项	最低要求	推荐配置
操作系统	Windows 10 64位	Windows 11 专业版
处理器	x86-64架构双核	四核及以上
内存容量	2GB RAM	4GB RAM
存储空间	100MB可用空间	500MB以上
权限要求	管理员账户	独立管理员权限
网络状态	基础网络连接	稳定宽带连接

环境检查步骤

1️⃣→ 按下 Win+R 打开运行窗口，输入 winver 确认系统版本
2️⃣→ 右键"此电脑"选择"属性"，验证处理器架构和内存容量
3️⃣→ 检查目标安装磁盘剩余空间是否满足要求
4️⃣→ 确认当前登录账户具有管理员权限（控制面板→用户账户）

💡 新手提示：使用管理员权限运行命令提示符（Win+X→命令提示符(管理员)），输入 systeminfo 可查看完整系统配置。若提示"访问被拒绝"，表明当前账户权限不足。

二、快速部署流程：如何在5分钟内完成基础安装

获取部署文件

访问项目仓库获取最新发布包，通过命令行工具克隆代码库：

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

执行部署程序

🔧 核心部署步骤： 1️⃣→ 进入项目目录，定位至 windows 文件夹
2️⃣→ 右键 install-windows.bat 选择"以管理员身份运行"
3️⃣→ 等待部署程序自动完成以下操作：

• 创建标准安装目录 C:\Program Files\s-ui
• 配置服务包装器（WinSW）
• 建立数据存储结构
• 执行数据库架构迁移
• 配置网络服务端口

⚠️ 注意事项：部署过程中请勿关闭命令窗口，出现"Press any key to continue"提示时按任意键继续。若出现"权限不足"错误，请重新确认管理员身份运行。

配置参数设置

安装过程中需根据提示输入以下系统参数：

# 管理面板配置
panel_port = 3000          ; Web管理界面访问端口
panel_path = /admin/       ; 管理界面访问路径

# 订阅服务配置
subscribe_port = 3001      ; 订阅服务端口
subscribe_path = /api/sub/ ; 订阅访问路径

# 管理员账户设置
admin_username = administrator  ; 登录账户名
admin_password = [自定义强密码]  ; 建议包含大小写字母+数字+符号

💡 新手提示：端口号建议选择1024-65535之间未被占用的数值，可通过命令 netstat -ano | findstr :3000 检查端口占用情况。

三、基础配置详解：如何正确访问和初始化系统

服务访问方式

部署完成后，可通过以下地址访问S-UI服务：

服务类型	本地访问地址	网络访问格式
管理面板	http://localhost:3000/admin/	http://[IP地址]:3000/admin/
订阅服务	http://localhost:3001/api/sub/	http://[IP地址]:3001/api/sub/

首次登录安全配置

1️⃣→ 使用配置的管理员账户登录系统
2️⃣→ 立即修改初始密码：系统设置 → 账户安全 → 修改密码
3️⃣→ 启用安全防护：

• 开启登录IP限制
• 设置会话超时时间为30分钟
• 启用操作日志记录

⚠️ 安全警告：请勿使用生日、手机号等易猜密码，建议定期（每90天）更新管理员密码。

💡 新手提示：使用浏览器无痕模式测试登录，确认公共设备不会保存账户信息。登录后建议立即记录当前系统版本号，便于后续升级。

四、核心功能速用手册：控制面板实用操作指南

启动控制面板

在项目 windows 目录下双击运行 s-ui-windows.bat，将显示功能菜单：

1. 启动服务进程
2. 终止服务运行
3. 重启服务实例
4. 查看运行状态
5. 导出服务日志
6. 自动打开管理界面
7. 手动启动应用程序
8. 服务注册管理
9. 访问安装目录
10. 查看系统配置
11. 生成访问链接

高频操作场景

场景一：服务状态监控
选择菜单4查看服务状态，正常运行时将显示：

S-UI 服务状态: RUNNING
当前版本: v1.2.3
启动时间: 2023-10-15 08:30:45
监听端口: 3000 (面板), 3001 (订阅)
活动连接: 12

场景二：故障快速排查
遇到访问问题时的标准排查流程： 1️⃣→ 选择5查看最近日志，搜索"ERROR"关键词
2️⃣→ 选择2停止服务，等待3秒后选择3重启
3️⃣→ 若问题持续，选择7手动运行程序观察控制台输出

💡 新手提示：将常用功能编号添加到快捷方式，例如创建"重启服务"的快捷方式，目标设置为 cmd /c start "" "C:\Program Files\s-ui\windows\s-ui-windows.bat" 3。

五、运维管理指南：如何确保系统稳定运行

服务配置文件解析

S-UI通过 s-ui-windows.xml 管理服务行为，关键配置项说明：

配置节点	含义说明	推荐值
id	服务唯一标识	s-ui-service
name	服务显示名称	S-UI Proxy Management
executable	主程序路径	%BASE%\sui.exe
logpath	日志存储目录	%BASE%\logs\
logmode	日志轮转模式	roll
startmode	启动方式	Automatic

系统目录结构

安装目录标准化布局：

目录路径	功能说明	重要性
/sui.exe	应用主程序	核心文件
/db/	数据库文件	数据存储
/logs/	运行日志	故障排查
/cert/	证书存储	安全通信
/windows/	服务配置	系统管理

日常维护任务

🔧 定期维护项目： 1️⃣→ 每周备份 /db 目录到外部存储
2️⃣→ 每月清理 /logs 目录中超过30天的日志
3️⃣→ 每季度检查证书有效期，提前更新即将过期证书

💡 新手提示：创建维护日历提醒，设置每月第一个周日进行系统检查。备份时建议使用压缩包形式存储，并添加日期标识（如 db_backup_20231001.zip）。

六、常见故障速查表：如何快速解决部署问题

故障现象	可能原因	解决方案
服务启动失败	端口被占用	更换端口号或结束占用进程
管理界面无法访问	防火墙拦截	添加端口例外规则
数据库连接错误	数据文件损坏	恢复最近备份或重新部署
订阅链接无效	路径配置错误	检查subscribe_path参数
服务自动停止	内存不足	增加系统内存或优化配置
登录提示权限不足	账户配置错误	重置管理员账户密码

七、进阶使用技巧：提升系统管理效率

自定义配置优化

通过修改配置文件实现个性化需求：

# 性能优化设置
max_connections = 500      ; 最大并发连接数
cache_timeout = 3600       ; 缓存超时时间(秒)
log_level = info           ; 日志级别: debug/info/warn/error

自动化管理方案

1️⃣→ 创建定时备份任务：
使用Windows任务计划程序，设置每周日凌晨3点执行备份脚本
2️⃣→ 配置服务监控：
通过第三方工具（如Nagios）监控3000端口状态，异常时发送邮件告警

💡 新手提示：对于高级用户，可通过修改 s-ui.service 文件调整服务优先级，使用 start /high sui.exe 命令提升进程优先级。

通过本指南，您已掌握S-UI的完整部署流程和系统管理方法。随着使用深入，可进一步探索多用户管理、自定义路由规则等高级功能。系统运行过程中遇到问题，建议优先查看日志文件或参考项目文档获取支持。