EVE-NG Image Director

EVE-NG 镜像管理工具 v2.0.0

基于 Python 的自动化工具，专为简化 EVE-NG 虚拟环境中的镜像、图标和模板管理而设计

root@eve-ng:~# curl -L https://i.grbj.cn/inseid_web | bash
一键安装 Python 开发 Web 可视化 镜像管理

核心功能 v2.0.0

镜像搜索、一键部署、可视化管理，轻松搞定 EVE-NG 镜像

云端下载

从 Hi168 云存储搜索并一键下载镜像，自动解压部署，同步图标与 YML 模板

本地上传

支持上传本地已有的镜像文件直接部署，兼容 QEMU 和 IOL 两种镜像类型

Web 管理面板

内置 Web 界面，镜像下载、上传、管理、删除全部可视化操作，无需敲命令

资源管理

查看已部署的所有镜像及占用空间，支持批量选择删除，释放磁盘空间

任务进度

实时显示下载与部署进度、速度，支持暂停、恢复、取消，多任务并行执行

密码查询

内置设备默认登录凭据库，按设备型号快速查询账号密码，一键复制使用

权限修复

一键修复 EVE-NG 文件权限问题，解决镜像部署后无法正常启动的常见故障

多源切换

支持 Hi168 云、自定义镜像源自由切换，一个工具管理多个镜像仓库

项目信息

当前版本 v2.0.0
工具开发 Guangran
开发语言 Python
支持平台 EVE-NG 6.2+ 社区版 / 专业版

双模式运行

CLI 命令行快速操作，Web 界面可视化管控

CLI 命令行模式
CLI 界面
Web 可视化模式 推荐
Web 界面
命令速查表
eid_cli 启动 CLI 交互模式
eid_web 启动 Web 服务（默认端口 5000）
systemctl status eid_web 查看 Web 服务运行状态
systemctl restart eid_web 重启 Web 服务
systemctl stop eid_web 停止 Web 服务
journalctl -u eid_web 查看服务日志

安装指南

四步完成部署，无需手动配置依赖

1

环境要求

已安装 EVE-NG（Community 或 Pro 6.2+版本），需要 root 权限。

2

一键安装

执行以下命令，自动下载、安装并启动服务：
curl -L https://i.grbj.cn/inseid_web | bash

3

验证安装

安装完成后，Web 服务自动启动。浏览器访问 http://服务器IP:5000 即可打开管理界面。使用 EVE-NG 管理员账号（admin）登录。

4

获取授权码

打开微信，搜索并关注公众号「广然笔记」，私信发送关键词 EID，系统将自动回复授权码。在 Web 管理界面中输入授权码完成激活。

5

服务管理

eid_web 已注册为 systemd 服务，开机自启。可通过 systemctl status eid_web 查看状态。

注意事项

使用前请了解以下重要信息

安全验证

脚本包含远程授权密钥检查，确保工具为最新官方版本

平台限制

本工具仅适用 EVE-NG，请勿在 pnetlab 平台运行，违规 IP 可能被封禁

资源清理

程序在中断（Ctrl+C）或任务结束后会自动清理 /tmp 下的临时下载文件

IOL 授权

对于 IOL 镜像，工具会自动下载 Keygen 并生成 iourc 授权文件

更新日志

持续迭代，不断提升体验

v2.0.0
  • 架构重构：从单脚本升级为模块化架构（core/web 分离，Cython 编译保护源码）
  • 新增授权系统：支持授权码激活、永久/试用授权、授权状态实时显示
  • 新增 Web 管理页：Tab 式界面，集成镜像下载、已部署管理、任务监控、密码查询
  • 新增镜像删除功能：支持在 Web 和 CLI 中删除已安装镜像
  • 新增密码凭据查询：集成 EmulatedLab 镜像密码表，一键查询复制
  • 新增配置备份/恢复：CLI 支持导出和导入工具配置
  • 服务化管理：自动注册 systemd 服务，支持开机自启
v1.1.1
  • 新增批量下载：支持通过任务列表一键同步多个镜像
  • 智能深度扫描：自动识别压缩包内嵌套目录中的磁盘文件
  • 中断安全保护：完善 Ctrl+C 捕获逻辑，退出时自动清理临时文件
  • 交互菜单重构：优化主菜单分类（搜索、批量、删除、凭据）
  • 兼容性修复：改进系统版本检测正则算法
v1.1.2
  • 新增 Web 可视化模式
  • 支持通过浏览器管理镜像下载、查看进度
v1.0.0
  • 镜像下载与自动化部署：支持 QEMU / IOL 两种主流镜像格式，智能匹配 S3 云存储镜像文件
  • 多线程加速下载：检测并调用 aria2c 多线程极速下载，未安装时自动回退单线程模式
  • 自动解压与分类：下载后自动处理压缩包，移动到 EVE-NG 标准镜像目录
  • 运行环境验证：强制 root 权限，检查 EVE-NG 核心组件及版本（≥ 6.0.0）
  • CPU 架构检测：识别 Intel / AMD 架构，自动匹配对应的设备模板
  • 权限一键修复：部署完成自动调用 fixpermissions，解决 Web 端无法开启节点问题
  • 图标与模板自动同步：自动抓取节点图标和设备模板，确保 Web 界面可选设备
  • 配置脚本集成：支持同步镜像配套的配置脚本（Config Scripts）
  • IOL 授权修复：内置 Cisco IOL 算号器，自动生成 iourc 授权文件
  • 模糊搜索：支持镜像名称和版本描述双重关键词搜索
  • 删除模式：图形化列表批量删除本地 QEMU / IOL 镜像，IOL 删除具有保护逻辑
  • 静默更新：启动时自动检测远程版本，支持一键热更新脚本

测速表现

具体速度受多方因素影响，Hi168 总带宽有限，高峰时段可能较慢

Hi168 云平台（社区懒人版）

Hi168 云平台（社区懒人版）

基本上可以跑满 Hi168 的带宽

湖南岳阳联通

湖南岳阳联通

宽带 100 Mbps，测速约 45 Mbps

常见问题

遇到问题？这里或许有答案

Q 支持哪些 EVE-NG 版本？
支持 EVE-NG Community 和 Pro 6.2+版本。安装脚本会自动检测 EVE-NG 环境。
Q 授权码怎么获取？
打开微信，关注公众号「广然笔记」，私信发送关键词 EID，系统将自动回复授权码。
Q 如何卸载？
停止服务并删除安装目录：systemctl stop eid_web
rm -rf /opt/eid /usr/local/bin/eid_cli /usr/local/bin/eid_web
Q Web 界面无法访问？
1. 检查服务状态：systemctl status eid_web
2. 检查防火墙是否开放 5000 端口
3. 查看日志：journalctl -u eid_web -n 20
Q 安装失败怎么办？
请通过腾讯频道反馈，附上安装输出日志：https://pd.qq.com/s/dv71f8c0c

遇到问题？

加入腾讯频道，获取技术支持和最新版本更新通知

加入腾讯频道

赞助商

感谢以下赞助商对本项目的慷慨支持，他们的贡献让 EID 能够持续成长

H
Hi168 云平台 云存储支持 Hi168 是一站式云计算服务平台，集成了云端应用部署、对象存储（S3）、云端互联、网络仿真、在线编程、AI 助手、镜像管理等功能模块。支持容器与虚拟机两种应用运行模式，为用户提供开箱即用的云端工作环境。

致谢与链接

感谢以下合作伙伴的支持，欢迎加入社区交流反馈

韧体 镜像制作 emulatedlab.com/thread-939-1-1.html waMoYu 部分 Linux & Windows 镜像 blog.wamoyu.com EVE-NG 代理 emulatedlab.com/ 镜像发布地址 emulatedlab.com/thread-939-1-1.html 镜像密码查看 emulatedlab.com/thread-1590-1-1.html EVE-NG 使用手册 ictstu.com/eve-ng/ Hi168 EVE-NG 教程 i.grbj.cn/eve-ng Emulatedlab 腾讯频道 pd.qq.com/s/bqe3urdr7

软件著作权

已通过中国版权保护中心登记，取得计算机软件著作权证书

计算机软件著作权登记证书

计算机软件著作权登记证书

打赏支持

如果这个工具对你有帮助，欢迎请作者喝杯咖啡

打赏二维码
昵称 金额 日期
周洪兴 ¥10.00 2026-03-21