📋 完整更新日志请查看 CHANGELOG.md / Full changelog: CHANGELOG.md
🔴 核心重构：本次更新包含程序架构重构、UI 完全重写、新增多个 API 模块。 🔴 Core Refactoring: This release includes application architecture refactoring, complete UI rewrite, and new API modules.
| 中文 | English |
|---|---|
前端完全重构 - app.py 3000+ 行内联模板 → templates/ + static/ 独立目录 |
Complete Frontend Refactoring - Split 3000+ lines of inline HTML from app.py into separate templates/ and static/ directories |
templates/dashboard.html - 全新 Dashboard 页面（节点管理、版本历史、配置对比） |
templates/dashboard.html - New Dashboard page (node management, version history, config comparison) |
templates/login.html - 独立登录页面 |
templates/login.html - Standalone login page |
templates/force_change_password.html - 强制修改密码页面 |
templates/force_change_password.html - Force change password page |
static/js/dashboard.js (1747行) - Dashboard JavaScript 逻辑 |
static/js/dashboard.js (1747 lines) - Dashboard JavaScript logic |
static/js/i18n.js (557行) - 国际化支持（中英文切换） |
static/js/i18n.js (557 lines) - Internationalization support (EN/ZH toggle) |
新增 Groups API (routes/groups_api.py) - 设备分组管理 REST API |
New Groups API (routes/groups_api.py) - Device group management REST API |
新增 Credentials API (routes/credentials_api.py) - 设备凭证管理 REST API |
New Credentials API (routes/credentials_api.py) - Device credential management REST API |
新增 Models API (routes/models_api.py) - 设备型号管理 REST API |
New Models API (routes/models_api.py) - Device model management REST API |
新增 Config API (routes/config_api.py) - Oxidized 配置管理 REST API |
New Config API (routes/config_api.py) - Oxidized configuration management REST API |
新增 Pages Blueprint (routes/pages.py) - 独立页面路由蓝图 |
New Pages Blueprint (routes/pages.py) - Standalone page routing blueprint |
新增 Config Service (services/config_service.py) - Oxidized 配置业务逻辑层 |
New Config Service (services/config_service.py) - Oxidized configuration business logic layer |
新增 Group Model (models/group.py) - 设备分组数据模型 |
New Group Model (models/group.py) - Device group data model |
| 中文 | English |
|---|---|
Oxidized OID 缓存 stale 问题修复 - 当 Oxidized 的 @gitcache 持有过期的 OID → node 映射时，版本历史 API 现在支持通过 epoch 参数直接读取 git 仓库历史，不再依赖 Oxidized 的内存缓存。解决了设备 IP 变更后版本历史无法加载的问题。 |
Oxidized OID Cache Stale Fix - When Oxidized's @gitcache holds stale OID → node mappings, the version history API now supports an epoch parameter to read git repository history directly, bypassing Oxidized's in-memory cache. Fixes version history loading failure after device IP changes. |
版本历史时间解析修复 - 前端 Dashboard 的 viewVersionHistory() 函数现在先将 v.time 的 ISO 时间字符串转换为 Unix epoch（Math.floor(new Date(v.time).getTime() / 1000)）再调用 API，解决了时间参数传递错误导致的版本历史加载失败问题。 |
Version History Time Parsing Fix - The Dashboard's viewVersionHistory() function now converts v.time ISO string to Unix epoch (Math.floor(new Date(v.time).getTime() / 1000)) before calling the API, fixing version history loading failures caused by incorrect time parameter formatting. |
登出重定向修复 - 修复 auth.py 中 logout() 函数重定向到硬编码 /login 路径而非 Flask Blueprint pages.login 的问题，现在正确使用 redirect(url_for('pages.login'))。 |
Logout Redirect Fix - Fixed logout() in auth.py redirecting to hardcoded /login path instead of Flask Blueprint pages.login; now correctly uses redirect(url_for('pages.login')). |
| 中文 | English |
|---|---|
移除华为 SSH Input 脚本 - 删除了 oxidized-config/input/huaweissh.rb，改用 oxidized-config/model/huawei.rb 统一处理，简化架构 |
Removed Huawei SSH Input Script - Deleted oxidized-config/input/huaweissh.rb, now using oxidized-config/model/huawei.rb for unified handling, simplifying architecture |
Nginx 配置增强 - nginx-proxy.conf 新增 gzip 压缩（gzip_types: text/plain text/css application/json application/javascript text/xml application/xml） |
Nginx Config Enhancement - nginx-proxy.conf added gzip compression (gzip_types: text/plain text/css application/json application/javascript text/xml application/xml) |
| README 文档升级 - 所有 README 文件添加完整更新日志，标注重大升级版本 | README Documentation Upgrade - All README files updated with full changelog and major upgrade markers |
文档修复 — SECURITY.md 补全中文版本，README_en.md / README_zh.md 项目结构章节与 README.md 同步。 Documentation Fix - SECURITY.md added complete Chinese version; README_en.md / README_zh.md project structure sections synced with README.md.
| 中文 | English |
|---|---|
| SECURITY.md 补全中文版本 — 双语项目所有对外文档必须中英双语，Alert #21、风险评估、替代方案全部中英对照。 | SECURITY.md Added Chinese Version - Bilingual project: all对外文档 must be Chinese/English bilingual. Alert #21, risk assessment, and alternatives now in bilingual table format. |
README_en.md / README_zh.md 项目结构同步 — 新增 v1.2.0 的 pages.py、config_api.py、credentials_api.py、groups_api.py、models_api.py、config_service.py、static/、templates/ 等文件描述。 |
README_en/zh Project Structure Synced - Added missing v1.2.0 files to project structure sections. |
修复 GitHub Code Scanning 告警 - 共修复 21 处
py/stack-trace-exposure+ 1 处py/clear-text-logging-sensitive-data漏洞。Alert #21 (py/clear-text-storage-sensitive-data) 为 Oxidized 设计决策，永久标记为 wontfix，详见SECURITY.md。 Fixed GitHub Code Scanning Alerts - Fixed 21 instances ofpy/stack-trace-exposureand 1 instance ofpy/clear-text-logging-sensitive-data. Alert #21 (py/clear-text-storage-sensitive-data) is an Oxidized design decision, permanently marked as wontfix — seeSECURITY.md.
| 中文 | English |
|---|---|
修复 API 错误信息泄露（CWE-209/CWE-497）— 第一批 - 替换所有 except Exception as e: return ... str(e) 为通用错误消息，防止异常堆栈暴露给 API 客户端。涉及：config_api.py（11处）、auth.py（2处）、nodes.py（2处）、groups_api.py（3处）。 |
Fixed API Error Information Exposure (CWE-209/CWE-497) — Batch 1 - Replaced all str(e) in API error handlers with generic messages. Files: config_api.py (11), auth.py (2), nodes.py (2), groups_api.py (3). |
修复 API 错误信息泄露（CWE-209/CWE-497）— 第二批 - 移除 except Exception as e: 中的 as e 子句；替换 result["error"] 为 "Backup failed"（oxidized_api.py）；替换 str(e) 为 "Backup request failed"（oxidized_service.py）；移除 print(password) 明文日志（database.py）。 |
Fixed API Error Information Exposure (CWE-209/CWE-497) — Batch 2 - Removed as e from except Exception as e:; replaced result["error"] with "Backup failed" (oxidized_api.py); replaced str(e) with "Backup request failed" (oxidized_service.py); removed print(password) logging (database.py). |
修复 YAML 错误信息泄露 - validate_yaml() 的 errors 字段返回 str(yaml_error) 暴露 YAML 解析细节，现改为 "Invalid YAML configuration"（config_service.py）。 |
Fixed YAML Error Detail Exposure - validate_yaml() was returning str(yaml_error) in the errors field, exposing YAML parser details. Now returns generic "Invalid YAML configuration" (config_service.py). |
Alert #21 wontfix - py/clear-text-storage-sensitive-data 为 Oxidized 设计决策，详见 SECURITY.md。 |
Alert #21 Wontfix - py/clear-text-storage-sensitive-data is an Oxidized design decision. See SECURITY.md. |
| 中文 | English |
|---|---|
| 初始版本发布 | Initial release |
| 节点管理与状态监控 | Node management and status monitoring |
| 配置版本对比 | Configuration version comparison |
| 凭证管理 | Credential management |
| 自研华为设备型号支持 | Custom Huawei device model support |
Oxidized Node Manager is a network device configuration backup management system built on Oxidized, providing a Web UI for node management and status monitoring.
- Node Management - Add, edit, delete network device nodes
- Real-time Status Monitoring - View Oxidized backup status and history
- Configuration Comparison - View device configuration version differences
- Credential Management - Centralized management of device access credentials
- Model Management - Support for 100+ network device models
- One-click Restart - Restart Oxidized container via UI to load new configuration
- Custom Huawei Support - Built-in
huawei.rbmodel with proprietary features for Huawei VRP devices
Oxidized Node Manager 是一个网络设备配置备份管理系统，基于 Oxidized 构建，提供 Web UI 进行节点管理和状态监控。
- 节点管理 - 添加、编辑、删除网络设备节点
- 实时状态监控 - 查看 Oxidized 备份状态和历史
- 配置对比 - 查看设备配置版本差异
- 凭证管理 - 集中管理设备访问凭据
- 型号管理 - 支持 100+ 网络设备型号
- 一键重启 - 通过 UI 重启 Oxidized 容器加载新配置
- 华为设备深度支持 - 内置自研
huawei.rb型号，支持华为 VRP 设备特性
┌─────────────────┐ ┌─────────────────┐
│ Browser │────▶│ nginx-proxy │
│ :8080 │◀────│ │
└─────────────────┘ └────────┬────────┘
│
┌──────────┴──────────┐
│ │
┌─────▼─────┐ ┌──────▼──────┐
│Node Manager│ │ Oxidized │
│ (Flask) │◀──────▶│ (Backup) │
│ :5000 │ │ :8888 │
└─────┬─────┘ └──────┬──────┘
│ │
│ ┌────────┴────────┐
│ │ SQLite DB │
│ │ (nodes.db) │
│ └────────────────┘
│
┌─────────┴─────────┐
│/var/run/docker.sock│
└───────────────────┘
┌─────────────────┐ ┌─────────────────┐
│ 浏览器 │────▶│ nginx-proxy │
│ :8080 │◀────│ │
└─────────────────┘ └────────┬────────┘
│
┌──────────┴──────────┐
│ │
┌─────▼─────┐ ┌──────▼──────┐
│Node Manager│ │ Oxidized │
│ (Flask) │◀──────▶│ (备份) │
│ :5000 │ │ :8888 │
└─────┬─────┘ └──────┬──────┘
│ │
│ ┌────────┴────────┐
│ │ SQLite 数据库 │
│ │ (nodes.db) │
│ └────────────────┘
│
┌─────────┴─────────┐
│/var/run/docker.sock│
└───────────────────┘
oxidized-node-manager/
├── docker-compose-oxidized.yml # Docker Compose 配置
├── nginx-proxy.conf # Nginx 反向代理配置（含 gzip）
├── package_deploy.sh # 一键部署脚本
├── .env.template # 环境变量模板
│
├── node_manager/ # Flask Web 应用
│ ├── app.py # 主应用入口
│ ├── database.py # SQLite 数据库操作
│ ├── config.py # 配置模块
│ ├── models/ # 数据模型
│ │ ├── node.py # 节点模型
│ │ ├── user.py # 用户模型（bcrypt 认证）
│ │ └── group.py # 设备分组模型（v1.2.0 新增）
│ ├── routes/ # Flask 蓝图
│ │ ├── auth.py # 认证与用户管理
│ │ ├── nodes.py # 节点 CRUD 操作
│ │ ├── oxidized_api.py # Oxidized API 集成
│ │ ├── pages.py # 页面路由蓝图（v1.2.0 新增）
│ │ ├── config_api.py # Oxidized 配置 API（v1.2.0 新增）
│ │ ├── credentials_api.py # 设备凭证 API（v1.2.0 新增）
│ │ ├── groups_api.py # 设备分组 API（v1.2.0 新增）
│ │ └── models_api.py # 设备型号 API（v1.2.0 新增）
│ ├── services/ # 业务逻辑服务
│ │ ├── docker_service.py # Docker 容器操作
│ │ ├── oxidized_service.py # Oxidized API 客户端
│ │ └── config_service.py # Oxidized 配置服务（v1.2.0 新增）
│ ├── static/ # 静态资源（v1.2.0 重构）
│ │ ├── css/
│ │ │ ├── dashboard.css
│ │ │ ├── login.css
│ │ │ └── force_change_password.css
│ │ └── js/
│ │ ├── dashboard.js # Dashboard 逻辑（v1.2.0 新增）
│ │ └── i18n.js # 国际化支持（v1.2.0 新增）
│ ├── templates/ # HTML 模板（v1.2.0 重构）
│ │ ├── dashboard.html
│ │ ├── login.html
│ │ └── force_change_password.html
│ └── tests/ # 单元测试（pytest）
│
└── oxidized-config/ # Oxidized 配置
├── config # Oxidized 主配置
├── credentials.json # 设备凭据
├── models.json # 启用的设备型号
├── nodes.db # SQLite 数据库
├── input/ # 自定义输入脚本（预留）
└── model/ # 自定义型号脚本
└── huawei.rb # 华为型号
# 1. 下载并解压部署包
unzip oxidized-node-manager.zip
cd oxidized-node-manager
# 2. 设置执行权限
chmod +x package_deploy.sh
# 3. 运行部署脚本
sudo ./package_deploy.sh# 1. 安装 Docker
curl -fsSL https://get.docker.com | sh
# 2. 创建目录
mkdir -p /opt/oxidized-node-manager
cd /opt/oxidized-node-manager
# 3. 复制文件
cp -r /path/to/deployment-package/* .
# 4. 配置环境变量
cp .env.template .env
nano .env # 修改密码
# 5. 启动服务
docker-compose up -d| 服务 / Service | 地址 / Address | 说明 / Description |
|---|---|---|
| Node Manager UI | http://IP:8080 | 节点管理界面 / Node management interface |
| Oxidized API | http://IP:8888 | Oxidized API |
| Oxidized Web | http://IP:8888 | Oxidized Web UI |
Node Manager（Flask Web UI）- http://IP:8080
- 用户名 / Username:
admin - 密码 / Password:
ADMIN_DEFAULT_PASSWORD环境变量（默认admin123） - 首次登录必须修改密码 / Mandatory password change on first login
- 存储在 SQLite 数据库
oxidized-config/nodes.db的 users 表中
Oxidized Web UI - http://IP:8888
- 用户名 / Username:
.env中的OXIDIZED_USER（默认 admin） - 密码 / Password:
.env中的OXIDIZED_PASSWORD
重要提示 / Important: 首次部署后请立即修改默认密码！/ Please change default passwords immediately after first deployment!
# 进入部署目录 / Enter deployment directory
cd /opt/oxidized-node-manager
# 查看容器状态 / View container status
docker-compose ps
# 查看日志 / View logs
docker-compose logs -f
docker-compose logs -f oxidized-node-manager
# 重启服务 / Restart services
docker-compose restart
# 停止服务 / Stop services
docker-compose down
# 更新代码 / Update code
git pull
docker-compose up -d
# 手动同步 CSV（如需要）/ Manually sync CSV (if needed)
docker exec oxidized-node-manager python -c "from database import ensure_csv_synced; ensure_csv_synced()"需要备份的关键文件 / Key files to backup:
# 打包备份 / Package backup
cd /opt/oxidized-node-manager
tar -czvf oxidized-backup-$(date +%Y%m%d).tar.gz \
oxidized-config/credentials.json \
oxidized-config/users.json \
oxidized-config/nodes.db \
oxidized-config/config
# 备份到远程服务器 / Backup to remote server
scp oxidized-backup-*.tar.gz user@backup-server:/path/to/backups/# 1. 停止服务 / Stop services
cd /opt/oxidized-node-manager
docker-compose down
# 2. 恢复文件 / Restore files
tar -xzvf oxidized-backup-20240115.tar.gz
# 3. 重启服务 / Restart services
docker-compose up -d# 1. 进入应用目录 / Enter app directory
cd node_manager
# 2. 安装依赖 / Install dependencies
pip install flask requests bcrypt pytest
# 3. 运行测试 / Run tests
pytest tests/ -v
# 4. 启动开发服务器 / Start development server
python app.py# 构建并启动 / Build and start
docker-compose up -d
# 查看日志 / View logs
docker-compose logs -f oxidized-node-manager
# 进入容器 / Enter container
docker exec -it oxidized-node-manager /bin/bashhuawei.rb 模型集成所有华为设备备份所需功能：
| 功能 / Feature | 说明 / Description |
|---|---|
| 非标准 SSH 端口 / Non-standard SSH port | 通过 CSV 配置中的 vars:ssh_port 支持 |
| 老款 SSH 算法 / Legacy SSH algorithm | 使用 diffie-hellman-group-exchange-sha1 算法 |
display version |
捕获系统版本信息，带 # 注释前缀 |
display device |
捕获设备信息，带 # 注释前缀 |
display current-configuration |
获取完整运行配置 |
screen-length 0 temporary |
禁用输出分页 |
---- More ---- 过滤 |
自动过滤分页提示 |
在 Node Manager 中添加华为设备时，选择型号 huawei，系统将自动使用这些自定义脚本进行配置备份。
华为 VRP（通用路由平台）系统设备：
- S 系列交换机（S5700、S6700、S9700 等）/ S Series switches
- AR 系列路由器 / AR Series routers
- AC 控制器 / AC controllers
- 其他支持
display current-configuration的华为设备
支持 100+ 网络设备型号，包括但不限于 / Support for 100+ network device models, including but not limited to:
- Cisco（IOS、IOS-XE、IOS-XR、NX-OS、ASA、AireOS、Meraki）
- Juniper（JunOS、ScreenOS）
- Huawei（VRP）
- HP/Aruba（ProCurve、Comware）
- Arista（EOS）
- MikroTik（RouterOS）
- Fortinet（FortiOS）
- Palo Alto（PAN-OS）
- Dell、Ubiquiti、VyOS
# 查看详细日志 / View detailed logs
docker-compose logs oxidized-node-manager
# 检查端口占用 / Check port usage
netstat -tlnp | grep -E '8080|8888|5000'# 检查 Oxidized 配置 / Check Oxidized configuration
docker exec oxidized cat /oxidized_config/config
# 测试 SSH 连接 / Test SSH connection
docker exec oxidized ssh -v -p 22 user@device-ip
# 查看 Oxidized 日志 / View Oxidized logs
docker exec oxidized cat /home/oxidized/.config/oxidized/logs/oxidized.log# 手动触发同步 / Manually trigger sync
docker exec oxidized-node-manager python -c "from database import ensure_csv_synced; ensure_csv_synced()"
# 查看 CSV 内容 / Check CSV content
docker exec oxidized-node-manager cat /oxidized_config/nodes.csvv1.2.0 已修复 - 当设备 IP 变更后，Oxidized 的
@gitcache可能持有过期的 OID → node 映射，导致版本历史 API 返回错误。v1.2.0 新增node_version_by_oid接口支持epoch参数直接读取 git 仓库，不依赖 Oxidized 内存缓存。
如遇此问题，请升级到 v1.2.0 或更高版本。
- 修改默认密码 / Change default passwords - 部署后立即修改
.env中的密码 - 限制端口访问 / Restrict port access - 生产环境使用防火墙限制 8080/8888 端口
- 启用 HTTPS / Enable HTTPS - 使用 nginx 反向代理 + SSL 证书
- 定期备份 / Regular backup - 建立备份策略并定期执行备份
MIT License