# ansible-nsfocus-osms

**Repository Path**: wangmt2000/ansible-nsfocus-osms

## Basic Information

- **Project Name**: ansible-nsfocus-osms
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-09
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ansible-nsfocus-osms

Ansible 项目，用于通过跳板机自动管理与巡检 NSFocus OSMS 主机及华为网络设备。由于绿盟堡垒机封锁 scp 和 sftp，目前仅支持 raw 模块。

## 项目结构

```
├── ansible.cfg              # Ansible 配置文件
├── inventory.ini            # 主机清单文件 (支持 -i 任意动态清单)
├── bastion_login.exp        # 跳板机登录 Expect 脚本
├── bastion_ssh_wrapper.sh   # 跳板机 SSH 包装脚本 (支持 X_INV 探针)
├── huawei_login.exp         # 华为设备登录 Expect 脚本 (支持首次改密/过期轮换/[Y/N/C]提示)
├── huawei_wrapper.sh        # 华为设备 SSH 包装脚本 (支持 X_INV 探针)
├── xunjian.yaml             # 全局自动化巡检 Playbook (网络设备 + Linux)
├── linux_xunjian.yaml       # Linux 生产环境只读巡检 Playbook (6项核心指标)
├── change_password.yaml     # 华为设备批量修改密码 Playbook
├── generate_report.py       # Markdown 格式巡检报告生成脚本
├── generate_excel_report.py # Excel (CSV/XLSX) 格式巡检汇总生成脚本
└── pip_offline_packages/    # 离线 Python 依赖包目录 (.whl)
```

## 离线环境与 Excel 报告说明

### 1. 零依赖 CSV 格式 Excel 报告（推荐离线环境使用）
`generate_excel_report.py` 使用 Python 原生内置 `csv` 模块 + `UTF-8-SIG` 编码，**零依赖任何第三方包**。
生成的 `xunjian_report.csv` 在 Excel / WPS 中双击即可直接打开，中文不乱码，表格列精准对齐。

```bash
python3 generate_excel_report.py
```

### 2. 原生 .xlsx 格式 Excel 报告与离线包导入
如果离线服务器需要生成原生 `.xlsx` 电子表格，可以使用项目中预置的离线 wheel 包目录 `pip_offline_packages`：

```bash
# 离线导入 openpyxl 依赖包 (需服务器有 pip)
pip install --no-index --find-links=./pip_offline_packages openpyxl

# 运行后将自动生成 xunjian_report.xlsx
python3 generate_excel_report.py
```

## 巡检命令使用

```bash
# 运行 Linux 生产环境 6 项只读安全巡检
ansible-playbook -i inventory.ini linux_xunjian.yaml

# 运行全网设备巡检
ansible-playbook -i inventory.ini xunjian.yaml

# 批量修改华为设备密码
ansible-playbook -i inventory.ini change_password.yaml
```