运维助手 (ops-maintenance) v3.3.10
专业的运维助手，支持单服务器和多服务器集群监控。
v3.3.8 新功能
网络诊断
/ops-maintenance network # 网络诊断（ping/dns/port）
/ops-maintenance network <host> # 指定主机检测
运维报告
/ops-maintenance report # 集群状态摘要报告
操作审计
/ops-maintenance audit # 查看审计日志统计
Docker 健康巡检
/ops-maintenance docker # Docker容器健康检查
SSL 证书监控
/ops-maintenance ssl # SSL证书检查
安全审计
/ops-maintenance security # 安全配置审计
远程密码检查
/ops-maintenance user@host password # 远程服务器密码过期检查
功能命令
健康检查
/ops-maintenance health # 本地
/ops-maintenance user@host health # 远程 SSH
日志分析
/ops-maintenance logs [关键词] # 本地
/ops-maintenance user@host logs error # 远程
性能监控 (本地)
/ops-maintenance perf
端口检查
/ops-maintenance ports [端口] # 本地
/ops-maintenance user@host ports 80 # 远程
进程检查
/ops-maintenance process [名称] # 本地
/ops-maintenance user@host process nginx # 远程
磁盘使用
/ops-maintenance disk # 本地
/ops-maintenance user@host disk # 远程
密码过期检查
/ops-maintenance password # 检查所有配置服务器的密码过期状态
远程服务器配置
方式 1: SSH Config (推荐)
在 ~/.ssh/config 中配置:
Host myserver
HostName 192.168.1.100
User root
Port 22
IdentityFile ~/.ssh/id_rsa
方式 2: 直接指定
user@192.168.1.100 health
root@server.com:2222 disk
支持的远程操作
- health: 系统负载、内存、磁盘、服务状态
- logs: 远程日志搜索
- ports: 端口占用检查
- process: 进程查找
- disk: 磁盘使用分析
- password: 远程密码过期检查（v3.3.8新增）
输出格式
返回 Markdown 格式结果，包含:
- 标题 (emoji + 操作名 + 服务器)
- 代码块中的命令输出
- 关键发现和建议
密码过期检查输出示例
### 🔐 密码过期检查 (本地)
| 用户 | 上次修改 | 过期日期 | 最大天数 | 状态 |
|------|----------|----------|----------|------|
| root | 2024-01-15 | 2024-07-15 | 180 | ✅ 有效 |
| admin | 2024-02-01 | never | 90 | ⚠️ 永不过期 |
| user1 | 2023-11-01 | 2024-01-01 | 60 | ❌ 已过期 |
多服务器集群管理
查看集群状态
/ops-maintenance cluster # 查看所有服务器状态
/ops-maintenance cluster @production # 按标签筛选
批量添加服务器
# 直接添加多个 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"]}]
添加服务器
/ops-maintenance add-server 192.168.1.100 --name web1 --tags production,web
移除服务器
/ops-maintenance remove-server 192.168.1.100
批量执行命令
/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
示例配置
[
{
"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+)
告警规则管理
/ops-maintenance alert rules # 查看告警规则
/ops-maintenance alert list # 查看活跃告警
/ops-maintenance alert stats # 查看告警统计
/ops-maintenance alert silence <ruleId> <server> [分钟] # 静默告警
/ops-maintenance alert cleanup [天数] # 清理旧告警
通知渠道配置
/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+)
巡检任务管理
/ops-maintenance patrol list # 查看巡检任务
/ops-maintenance patrol run # 执行巡检
/ops-maintenance patrol start # 启动定时巡检
/ops-maintenance patrol stop # 停止定时巡检
i18n 国际化 (v3.3.8新增)
# 设置语言
export LANG=en_US.UTF-8 # 英文
export LANG=zh_CN.UTF-8 # 中文（默认）
测试
运行测试
# 运行所有测试
npm test
# 运行核心功能测试（快速）
npm test -- test/core.test.ts
# 运行特定测试
npm test -- --testNamePattern="健康检查"
测试覆盖
- ✅ 平台检测与命令执行
- ✅ 本地健康检查
- ✅ 日志分析
- ✅ 性能监控
- ✅ 进程检查
- ✅ 密码过期检查
- ✅ 服务器配置管理
- ✅ 告警管理
- ✅ 巡检调度
- ✅ SSL监控
- ✅ 邮件通知
- ✅ 安全审计
- ✅ Docker健康
- ✅ 密码加密
- ✅ i18n 国际化
- ✅ 配置变更追踪
- ✅ 审计报告生成
- ✅ 网络诊断
故障排除
SSH连接问题
- 连接超时: 检查网络连接和防火墙设置
- 认证失败: 确认SSH密钥配置正确
- 主机密钥验证: 首次连接需要手动确认主机密钥
命令执行缓慢
- 网络延迟: 远程命令受网络影响
- 系统负载: 高负载时响应变慢
- 超时设置: 可在代码中调整超时时间
权限问题
- 文件访问: 某些系统文件需要root权限
- 命令执行: 部分命令需要sudo权限
- 日志读取: 确保有日志文件读取权限
性能优化
缓存策略
- 内存缓存: 30秒TTL，减少重复计算
- 文件缓存: 持久化存储，跨会话复用
- 连接池: SSH连接复用，减少握手开销
批量操作
- 使用集群命令而非单台操作
- 合并相关命令减少网络往返
- 合理设置超时时间
监控建议
- 定期检查服务器健康状态
- 关注密码过期时间
- 监控磁盘使用趋势
- 设置关键服务端口监控
架构说明
Clean Architecture
src-new/
├── core/ # 核心业务逻辑
│ ├── usecases/ # 用例实现
│ └── domain/ # 领域模型
├── infrastructure/ # 基础设施
│ ├── ssh/ # SSH客户端
│ ├── cache/ # 缓存实现
│ └── monitoring/ # 监控策略
├── presentation/ # 表现层
│ └── cli/ # CLI接口
└── config/ # 配置管理
设计模式
- 依赖注入: 使用容器管理依赖
- 策略模式: 可插拔的监控策略
- 适配器模式: 兼容旧版API
- 工厂模式: 创建SSH连接
数据流
用户命令 → CLI解析 → UseCase → Infrastructure → 外部系统
↓
缓存层
开发指南
添加新功能
- 在
core/usecases/创建新的UseCase - 在
infrastructure/实现必要的适配器 - 在
presentation/cli/添加CLI命令 - 更新
container.ts注册依赖 - 添加测试用例
代码规范
- 使用TypeScript类型注解
- 遵循Clean Architecture原则
- 保持向后兼容性
- 添加适当的错误处理
- 编写单元测试
调试技巧
# 启用详细日志
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版本
- 复现步骤
- 错误日志
提交代码
- Fork项目
- 创建功能分支
- 编写测试
- 提交Pull Request
文档改进
- 修正错误和不准确之处
- 添加使用示例
- 翻译文档