s-ui Windows部署全攻略：从环境准备到性能调优

1. 环境准备阶段

1.1 系统兼容性检查

部署前需确认目标环境满足以下技术规格：

• 操作系统：Windows 10/11 64位专业版或企业版
• 硬件架构：x86-64 (AMD64) 处理器
• 权限要求：本地管理员账户
• 网络环境：稳定互联网连接（用于依赖下载）

[!TIP] 建议通过系统信息工具(msinfo32.exe)验证硬件架构与系统版本，避免兼容性问题。

1.2 部署决策树

根据硬件配置选择优化方案：

[4GB内存以下] → 基础模式：关闭统计功能 | 禁用日志轮转
[4-8GB内存] → 标准模式：默认配置 | 启用基本监控
[8GB内存以上] → 增强模式：开启全量日志 | 启用性能监控

2. 执行部署阶段

2.1 资源获取与准备

▶️ 克隆项目仓库

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

▶️ 进入项目目录并定位Windows部署资源

cd s-ui/windows

2.2 自动化部署流程

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  运行安装脚本   │────>│ 系统环境检测    │────>│ 创建安装目录    │
│ (管理员身份)    │     │ (端口/权限检查) │     │ (C:\s-ui)       │
└─────────────────┘     └─────────────────┘     └────────┬────────┘
                                                         │
┌─────────────────┐     ┌─────────────────┐     ┌────────▼────────┐
│ 服务启动验证    │<────│ 配置服务包装器  │<────│ 初始化数据库    │
│ (端口监听检测)  │     │ (Windows服务)   │     │ (SQLite)        │
└─────────────────┘     └─────────────────┘     └─────────────────┘

▶️ 执行安装程序

install-windows.bat

2.3 核心配置参数设置

参数类别	配置项	建议值	功能说明
网络配置	管理面板端口	3000	Web管理界面访问端口
网络配置	订阅服务端口	3001	代理订阅服务端口
路径配置	管理访问路由	/admin/	后台管理路径前缀
安全配置	管理员账户	admin	默认管理用户名
存储配置	数据存储路径	C:\s-ui\data	数据库文件存储位置

[!TIP] 安装过程中设置的管理员密码需包含大小写字母、数字和特殊符号，长度不低于8位。

3. 部署验证阶段

3.1 服务状态检查

▶️ 通过服务管理工具验证

Windows服务 → 查找"S-UI Service" → 确认状态为"正在运行"

▶️ 命令行状态查询

sc query s-ui-service

3.2 功能可用性验证

验证项	访问地址	预期结果
管理面板	http://localhost:3000/admin/	显示登录界面
订阅服务	http://localhost:3001/sub/	返回订阅配置信息
健康检查	http://localhost:3000/health	返回"OK"状态

3.3 常见故障排查矩阵

故障现象	可能原因	排查步骤	解决方案
服务启动失败	端口占用	netstat -ano | findstr ":3000"	关闭占用进程或修改端口配置
登录失败	密码错误	查看日志文件：C:\s-ui\logs\auth.log	执行密码重置脚本
面板无法访问	防火墙拦截	检查Windows防火墙入站规则	添加3000-3001端口允许规则
订阅无响应	服务未启动	sc start s-ui-service	检查服务依赖项

4. 进阶配置阶段

4.1 性能优化配置

▶️ 编辑配置文件

notepad C:\s-ui\config\app.ini

关键优化参数：

[performance]
max_connections = 500      # 最大并发连接数
log_level = warn           # 日志级别(debug/info/warn/error)
cache_ttl = 300            # 缓存过期时间(秒)

4.2 服务管理进阶操作

▶️ 服务重启命令

sc stop s-ui-service && sc start s-ui-service

▶️ 设置服务自动恢复

服务属性 → 恢复 → 第一次失败: 重新启动服务 → 重启间隔: 1分钟

4.3 数据备份策略

▶️ 创建自动备份任务

schtasks /create /tn "S-UI Backup" /tr "C:\s-ui\tools\backup.bat" /sc daily /st 02:00

备份文件存储路径：C:\s-ui\backups\（自动保留最近7天备份）

5. 系统维护建议

• 每周执行一次系统日志清理
• 每月检查端口占用情况，优化资源分配
• 每季度进行一次完整数据备份
• 定期关注项目更新，及时应用安全补丁

通过以上步骤，可实现s-ui服务在Windows环境下的稳定部署与高效运维。系统默认配置已针对常规使用场景优化，如无特殊需求，建议保持默认设置以确保最佳兼容性。