环境准备阶段
1.1 系统兼容性验证
疯狂转圈圈软件（以下简称"转圈圈"）要求运行在64位操作系统上，支持Windows 10/11（版本1909及以上）、CentOS 7.6+或Ubuntu 20.04 LTS等平台。建议采用物理服务器或云主机部署，虚拟机环境下需确保虚拟化层已启用硬件辅助加速功能。
硬件最低配置要求：
1.2 依赖组件安装
需预先部署以下基础组件：
建议使用官方软件源进行安装，避免第三方修改版本引发的兼容性问题。Linux平台需特别注意SELinux策略配置，建议执行以下命令临时关闭或设置为宽容模式：
```bash
setenforce 0
```
1.3 网络策略配置
开放防火墙端口：
对于云环境部署，需在安全组中同时配置入站/出站规则。建议使用VPC内部专用网络进行节点间通信，避免敏感数据通过公网传输。
软件安装阶段
2.1 获取安装包
从官方认证渠道下载安装包（建议验证SHA-256校验值）：
对于生产环境部署，推荐使用数字签名验证工具检查安装包完整性：
```powershell
Get-AuthenticodeSignature -FilePath .\\SpinnerService_3.2.1_win-x64.exe
```
2.2 执行安装程序
Windows平台：
1. 以管理员身份运行安装向导
2. 选择自定义安装路径（建议避开系统盘）
3. 勾选"创建系统服务"选项
4. 设置服务启动账户为专用服务账号（非administrator）
Linux平台：
```bash
rpm -ivh spinner-svr-3.2.1-el7.x86_64.rpm --prefix=/opt/spinner
systemctl daemon-reload
```
2.3 安装后验证
检查关键目录结构：
运行环境检查命令：
```bash
spinner-cli checkenv --full
```
确认输出中所有检测项均为绿色通过状态。
核心配置管理
3.1 基础参数配置
编辑主配置文件`appsettings.prod.json`：
```json
Cluster": {
NodeId": "NODE-01",
DiscoveryEndpoint": "
},
DataPath": "/data/spinner",
LogLevel": "Information
```
特别注意路径权限设置，建议执行：
```bash
chown spinner:spinner /data/spinner -R
chmod 750 /data/spinner
```
3.2 数据库连接配置
在`database.conf`中设置PostgreSQL连接参数：
```
Host=pg-master.
Port=5432
Database=spinner_prod
Username=spinner_admin
Password=ENC(AES256:U2FsdGVkX18Z7v4a7OyjC7...)
```
密码字段建议使用内置加密工具处理：
```bash
spinner-cli encrypt --text '原始密码'
```
3.3 高可用配置
集群模式下需配置至少3个种子节点：
```yaml
cluster:
seed_nodes:
gossip_interval: 5000ms
failure_detector:
threshold: 3
```
功能调试与验证
4.1 服务启停测试
执行全生命周期管理命令：
```bash
systemctl start spinner.service
systemctl status spinner.service
spinner-cli service stop --force
```
观察系统日志`/var/log/spinner/bootstrap.log`，确认无ERROR级别记录。
4.2 API连通性测试
使用cURL验证REST接口：
```bash
curl -X POST \\
-H "Content-Type: application/json" \\
-d '{"speed": 1500, "duration": "30s"}'
```
预期返回包含`task_id`的JSON响应，状态码应为201 Created。
4.3 压力测试
使用内置负载生成工具：
```bash
spinner-cli stress --threads 50 --duration 5m
```
监控资源消耗情况，确保CPU利用率不超过75%，内存占用稳定在分配量的80%以下。
常见故障处理
5.1 服务启动失败排查
1. 检查`journalctl -u spinner.service`中的错误日志
2. 验证数据库连接是否通畅：`nc -zv pg-master. 5432`
3. 确认端口未被占用：`ss -tulnp | grep 8848`
5.2 性能优化建议
```bash
export JAVA_OPTS="-Xms8g -Xmx8g -XX:+UseG1GC
```
```yaml
network:
zero_copy: true
tcp_quickack: on
```
5.3 升级回滚方案
使用包管理器保留旧版本：
```bash
yum history undo 123
```
回退时需同步还原配置文件，建议每次变更前执行：
```bash
cp -a /etc/spinner /etc/spinner_backup_$(date +%Y%m%d)
```
本指南涵盖了从基础环境准备到高级功能调试的全流程操作要点，实施过程中需严格遵循变更管理规范。建议在预发布环境充分验证后，再执行生产环境部署。定期检查官方安全公告，及时更新至推荐版本以获得最佳稳定性和安全性保障。
