name: phoenix-shield
description: 具备智能回滚能力的自愈式备份与更新系统。通过自动监控更新后的系统健康状况，并在需要时从备份中恢复，从而防止更新失败。功能包括金丝雀部署测试、健康基线、智能回滚和7x24小时自动监控。适用于执行关键系统更新、管理生产部署或确保服务高可用性的场景。通过预检、完整性验证和自动恢复工作流来防止停机。

PhoenixShield 🔥🛡️

"如凤凰涅槃，您的系统将从其备份中重生"

具备智能回滚能力的自愈式备份与更新系统。

为什么选择 PhoenixShield？

问题： 系统更新可能失败，导致服务中断和停机。

解决方案： PhoenixShield 提供了一个完整的安全网，在出现问题时自动回滚。

优势：
- 🔄 自动恢复 - 更新失败时自我修复
- 🧪 金丝雀测试 - 在生产前测试更新
- 📊 健康监控 - 更新后24小时监控
- ⚡ 智能回滚 - 仅回滚已更改的组件
- 🛡️ 零停机 - 尽可能实现优雅降级

快速开始

1. 初始化 PhoenixShield

phoenix-shield init --project myapp --backup-dir /var/backups

2. 创建更新前快照

phoenix-shield snapshot --name "pre-update-$(date +%Y%m%d)"

3. 使用自动恢复功能进行安全更新

phoenix-shield update \
  --command "npm update" \
  --health-check "curl -f http://localhost/health" \
  --auto-rollback

4. 监控更新后状态

phoenix-shield monitor --duration 24h --interval 5m

核心功能

1. 预检

在任何更新之前，PhoenixShield 会验证：

phoenix-shield preflight

检查项：
- ✅ 可用磁盘空间
- ✅ 无关键进程运行
- ✅ 备份存储可访问
- ✅ 网络连通性
- ✅ 服务健康基线

2. 智能备份

# 完整系统快照
phoenix-shield backup --full

# 增量备份（仅更改的文件）
phoenix-shield backup --incremental

# 仅配置备份
phoenix-shield backup --config

备份内容包括：
- 配置文件
- 数据库转储
- 系统状态
- 进程列表
- 网络连接
- 健康指标基线

3. 金丝雀部署

首先在隔离环境中测试更新：

phoenix-shield canary \
  --command "apt upgrade" \
  --test-duration 5m \
  --test-command "systemctl status nginx"

4. 生产环境更新

在安全网下执行更新：

phoenix-shield deploy \
  --command "npm install -g openclaw@latest" \
  --health-checks "openclaw --version" \
  --health-checks "openclaw health" \
  --rollback-on-failure

5. 更新后监控

自动监控阶段：

phoenix-shield monitor --start

6. 智能回滚

当更新失败时，PhoenixShield 会：

1. 尝试软恢复 - 重启服务
2. 配置回滚 - 恢复配置
3. 软件包回滚 - 降级软件包
4. 完全恢复 - 完整系统还原
5. 应急模式 - 最小化服务，通知管理员

# 手动回滚
phoenix-shield rollback --to-snapshot "pre-update-20260205"

# 检查将回滚的内容（试运行）
phoenix-shield rollback --dry-run

工作流示例

安全的 OpenClaw 更新

#!/bin/bash
# 使用 PhoenixShield 保护更新 OpenClaw

phoenix-shield preflight || exit 1

phoenix-shield snapshot --name "openclaw-$(date +%Y%m%d)"

phoenix-shield deploy \
  --command "npm install -g openclaw@latest && cd /usr/lib/node_modules/openclaw && npm update" \
  --health-check "openclaw --version" \
  --health-check "openclaw doctor" \
  --rollback-on-failure

phoenix-shield monitor --duration 2h

Ubuntu 服务器更新

phoenix-shield deploy \
  --command "apt update && apt upgrade -y" \
  --health-check "systemctl status nginx" \
  --health-check "systemctl status mysql" \
  --pre-hook "/root/notify-start.sh" \
  --post-hook "/root/notify-complete.sh" \
  --auto-rollback

多服务器更新

# 使用 PhoenixShield 更新多台服务器
SERVERS="server1 server2 server3"

for server in $SERVERS; do
  phoenix-shield deploy \
    --target "$server" \
    --command "apt upgrade -y" \
    --batch-size 1 \
    --rollback-on-failure
done

配置

创建 phoenix-shield.yaml：

project: my-production-app
backup:
  directory: /var/backups/phoenix
  retention: 10  # 保留最后10个备份
  compression: gzip

health_checks:
  - command: "curl -f http://localhost/health"
    interval: 30s
    retries: 3
  - command: "systemctl status nginx"
    interval: 60s

monitoring:
  enabled: true
  duration: 24h
  intervals:
    critical: 1m    # 0-5 分钟
    normal: 5m      # 5-30 分钟
    extended: 30m   # 30-120 分钟
    stability: 2h   # 2-24 小时

rollback:
  strategy: smart  # smart, full, manual
  auto_rollback: true
  max_attempts: 3

notifications:
  on_start: true
  on_success: true
  on_failure: true
  on_rollback: true

命令参考

与 CI/CD 集成

# GitHub Actions 示例
- name: 安全部署
  run: |
    phoenix-shield preflight
    phoenix-shield snapshot --name "deploy-$GITHUB_SHA"
    phoenix-shield deploy \
      --command "./deploy.sh" \
      --health-check "curl -f http://localhost/ready" \
      --auto-rollback

最佳实践

1. 始终使用预检

# 错误做法
phoenix-shield deploy --command "apt upgrade"

# 正确做法
phoenix-shield preflight && \
phoenix-shield deploy --command "apt upgrade"

2. 生产前测试回滚

phoenix-shield snapshot --name test
phoenix-shield deploy --command "echo test"
phoenix-shield rollback --dry-run  # 查看将发生的情况

3. 监控关键更新

phoenix-shield deploy --command "major-update.sh"
phoenix-shield monitor --duration 48h  # 延长监控时间

4. 维护备份卫生

# 定期清理
phoenix-shield cleanup --keep-last 10 --older-than 30d

# 验证备份
phoenix-shield verify --all

故障排除

"预检失败"

• 检查磁盘空间：df -h
• 验证备份位置是否存在
• 确保没有关键进程运行

"回滚失败"

• 检查备份完整性：phoenix-shield verify
• 从以下位置手动恢复：/var/backups/phoenix/
• 联系管理员进行紧急恢复

"健康检查失败"

• 延长监控：phoenix-shield monitor --duration 48h
• 检查服务日志：journalctl -u myservice
• 考虑部分回滚：phoenix-shield rollback --config-only

架构

┌─────────────────────────────────────┐
│        PhoenixShield 核心           │
├─────────────────────────────────────┤
│ 预检 │ 部署 │ 监控 │ 回滚 │
├─────────────────────────────────────┤
│   备份引擎   │   健康引擎    │
├─────────────────────────────────────┤
│     快照     │     恢复      │
├─────────────────────────────────────┤
│   配置 │ 状态 │ 日志 │ 指标   │
└─────────────────────────────────────┘

安全

• 备份在静态时加密
• 使用校验和进行完整性验证
• 安全处理凭据
• 所有操作的审计追踪

许可证

MIT 许可证 - 个人和商业使用免费。

致谢

由 OpenClaw Agent (@mig6671) 创建
灵感来源于对坚如磐石的系统更新的需求