运维助手 (ops-maintenance) v3.3.10#

专业的运维助手，支持单服务器和多服务器集群监控。

v3.3.8 新功能#

网络诊断#

text

/ops-maintenance network               # 网络诊断（ping/dns/port）
/ops-maintenance network <host>        # 指定主机检测

运维报告#

text

/ops-maintenance report                # 集群状态摘要报告

操作审计#

text

/ops-maintenance audit                 # 查看审计日志统计

Docker 健康巡检#

text

/ops-maintenance docker                # Docker容器健康检查

SSL 证书监控#

text

/ops-maintenance ssl                   # SSL证书检查

安全审计#

text

/ops-maintenance security              # 安全配置审计

远程密码检查#

text

/ops-maintenance user@host password    # 远程服务器密码过期检查

功能命令#

健康检查#

text

/ops-maintenance health              # 本地
/ops-maintenance user@host health    # 远程 SSH

日志分析#

text

/ops-maintenance logs [关键词]       # 本地
/ops-maintenance user@host logs error  # 远程

性能监控 (本地)#

text

/ops-maintenance perf

端口检查#

text

/ops-maintenance ports [端口]        # 本地
/ops-maintenance user@host ports 80  # 远程

进程检查#

text

/ops-maintenance process [名称]      # 本地
/ops-maintenance user@host process nginx  # 远程

磁盘使用#

text

/ops-maintenance disk                # 本地
/ops-maintenance user@host disk      # 远程

密码过期检查#

text

/ops-maintenance password            # 检查所有配置服务器的密码过期状态

远程服务器配置#

方式 1: SSH Config (推荐)#

在 ~/.ssh/config 中配置:

text

Host myserver
    HostName 192.168.1.100
    User root
    Port 22
    IdentityFile ~/.ssh/id_rsa

方式 2: 直接指定#

text

user@192.168.1.100 health
root@server.com:2222 disk

支持的远程操作#

• health: 系统负载、内存、磁盘、服务状态
• logs: 远程日志搜索
• ports: 端口占用检查
• process: 进程查找
• disk: 磁盘使用分析
• password: 远程密码过期检查（v3.3.8新增）

输出格式#

返回 Markdown 格式结果，包含:

• 标题 (emoji + 操作名 + 服务器)
• 代码块中的命令输出
• 关键发现和建议

密码过期检查输出示例#

text

### 🔐 密码过期检查 (本地)

| 用户 | 上次修改 | 过期日期 | 最大天数 | 状态 |
|------|----------|----------|----------|------|
| root | 2024-01-15 | 2024-07-15 | 180 | ✅ 有效 |
| admin | 2024-02-01 | never | 90 | ⚠️ 永不过期 |
| user1 | 2023-11-01 | 2024-01-01 | 60 | ❌ 已过期 |

多服务器集群管理#

查看集群状态#

text

/ops-maintenance cluster              # 查看所有服务器状态
/ops-maintenance cluster @production  # 按标签筛选

批量添加服务器#

text

# 直接添加多个 IP
/ops-maintenance batch-add 192.168.1.100 192.168.1.101 192.168.1.102

# 带端口
/ops-maintenance batch-add 192.168.1.100:2222 192.168.1.101:22

# 带用户
/ops-maintenance batch-add root@192.168.1.100 admin@192.168.1.101

# 完整格式
/ops-maintenance batch-add user@host:port user2@host2:port

# CSV 格式 (多行)
/ops-maintenance import-servers <<EOF
192.168.1.100,22,root,web-1,production;web
192.168.1.101,22,admin,db-1,production;database
EOF

# JSON 格式
/ops-maintenance import-servers [{"host":"192.168.1.100","name":"web-1","tags":["prod"]}]

添加服务器#

text

/ops-maintenance add-server 192.168.1.100 --name web1 --tags production,web

移除服务器#

text

/ops-maintenance remove-server 192.168.1.100

批量执行命令#

text

/ops-maintenance exec "df -h" @production   # 在 production 组执行
/ops-maintenance exec "uptime" all          # 在所有服务器执行

服务器配置文件#

• 位置: ~/.config/ops-maintenance/servers.json
• 支持字段: host, port, user, keyFile, name, tags
• 密码加密: v3.3.8+ 自动加密存储，密钥文件位于 ~/.config/ops-maintenance/.key

示例配置#

json

[
  {
    "host": "192.168.1.100",
    "user": "root",
    "name": "web-1",
    "tags": ["production", "web"]
  },
  {
    "host": "192.168.1.101",
    "user": "admin",
    "name": "db-1",
    "tags": ["production", "database"]
  }
]

告警通知 (v3.3+)#

告警规则管理#

text

/ops-maintenance alert rules     # 查看告警规则
/ops-maintenance alert list      # 查看活跃告警
/ops-maintenance alert stats     # 查看告警统计
/ops-maintenance alert silence <ruleId> <server> [分钟]  # 静默告警
/ops-maintenance alert cleanup [天数]  # 清理旧告警

通知渠道配置#

text

/ops-maintenance alert notify email '{"smtpHost":"smtp.qq.com","smtpPort":465,"smtpUser":"xxx","smtpPass":"授权码","from":"xxx","to":["收件人"]}'
/ops-maintenance alert notify feishu '{"webhook":"https://...", "secret":"..."}'
/ops-maintenance alert notify webhook '{"url":"https://..."}'

定时巡检 (v3.3+)#

巡检任务管理#

text

/ops-maintenance patrol list     # 查看巡检任务
/ops-maintenance patrol run      # 执行巡检
/ops-maintenance patrol start    # 启动定时巡检
/ops-maintenance patrol stop     # 停止定时巡检

i18n 国际化 (v3.3.8新增)#

bash

# 设置语言
export LANG=en_US.UTF-8  # 英文
export LANG=zh_CN.UTF-8  # 中文（默认）

测试#

运行测试#

bash

# 运行所有测试
npm test

# 运行核心功能测试（快速）
npm test -- test/core.test.ts

# 运行特定测试
npm test -- --testNamePattern="健康检查"

测试覆盖#

• ✅ 平台检测与命令执行
• ✅ 本地健康检查
• ✅ 日志分析
• ✅ 性能监控
• ✅ 进程检查
• ✅ 密码过期检查
• ✅ 服务器配置管理
• ✅ 告警管理
• ✅ 巡检调度
• ✅ SSL监控
• ✅ 邮件通知
• ✅ 安全审计
• ✅ Docker健康
• ✅ 密码加密
• ✅ i18n 国际化
• ✅ 配置变更追踪
• ✅ 审计报告生成
• ✅ 网络诊断

故障排除#

SSH连接问题#

1. 连接超时: 检查网络连接和防火墙设置
2. 认证失败: 确认SSH密钥配置正确
3. 主机密钥验证: 首次连接需要手动确认主机密钥

命令执行缓慢#

1. 网络延迟: 远程命令受网络影响
2. 系统负载: 高负载时响应变慢
3. 超时设置: 可在代码中调整超时时间

权限问题#

1. 文件访问: 某些系统文件需要root权限
2. 命令执行: 部分命令需要sudo权限
3. 日志读取: 确保有日志文件读取权限

性能优化#

缓存策略#

• 内存缓存: 30秒TTL，减少重复计算
• 文件缓存: 持久化存储，跨会话复用
• 连接池: SSH连接复用，减少握手开销

批量操作#

• 使用集群命令而非单台操作
• 合并相关命令减少网络往返
• 合理设置超时时间

监控建议#

• 定期检查服务器健康状态
• 关注密码过期时间
• 监控磁盘使用趋势
• 设置关键服务端口监控

架构说明#

Clean Architecture#

text

src-new/
├── core/              # 核心业务逻辑
│   ├── usecases/     # 用例实现
│   └── domain/       # 领域模型
├── infrastructure/    # 基础设施
│   ├── ssh/          # SSH客户端
│   ├── cache/        # 缓存实现
│   └── monitoring/   # 监控策略
├── presentation/      # 表现层
│   └── cli/          # CLI接口
└── config/           # 配置管理

设计模式#

• 依赖注入: 使用容器管理依赖
• 策略模式: 可插拔的监控策略
• 适配器模式: 兼容旧版API
• 工厂模式: 创建SSH连接

数据流#

text

用户命令 → CLI解析 → UseCase → Infrastructure → 外部系统
                ↓
            缓存层

开发指南#

添加新功能#

1. 在 core/usecases/ 创建新的UseCase
2. 在 infrastructure/ 实现必要的适配器
3. 在 presentation/cli/ 添加CLI命令
4. 更新 container.ts 注册依赖
5. 添加测试用例

代码规范#

• 使用TypeScript类型注解
• 遵循Clean Architecture原则
• 保持向后兼容性
• 添加适当的错误处理
• 编写单元测试

调试技巧#

bash

# 启用详细日志
DEBUG=* npm start

# 测试单个功能
node run.js health

# 检查配置
cat ~/.config/ops-maintenance/servers.json

限制与注意事项#

平台支持#

• ✅ Linux: 完整支持
• ✅ macOS: 基本支持（部分功能受限）
• ⚠️ Windows: 有限支持（通过WSL）

网络要求#

• SSH连接需要稳定的网络
• 防火墙需要开放SSH端口
• 建议使用SSH密钥认证

安全建议#

• 不要在代码中硬编码密码
• 使用SSH密钥而非密码认证
• 定期更新SSH密钥
• 限制服务器访问权限
• 加密敏感配置信息（v3.3.8+自动加密）

贡献指南#

报告问题#

提供详细的错误信息：

• 操作系统版本
• Node.js版本
• 复现步骤
• 错误日志

提交代码#

1. Fork项目
2. 创建功能分支
3. 编写测试
4. 提交Pull Request

文档改进#

• 修正错误和不准确之处
• 添加使用示例
• 翻译文档