# EVE-NG Image Director **Repository Path**: grbj/eid ## Basic Information - **Project Name**: EVE-NG Image Director - **Description**: EID (EVE-NG Image Director) 是一个基于 Python 的自动化工具，专为简化 EVE-NG 虚拟环境中的镜像、图标和模板的部署流程而设计。它通过从 Hi168云平台 S3 存储桶自动同步配置和文件，实现一键式的镜像安装。 - **Primary Language**: Python - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 10 - **Forks**: 4 - **Created**: 2025-12-18 - **Last Updated**: 2026-02-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # EID - EVE-NG Image Director **EID** (**E**VE-NG **I**mage **D**irector) 是一个基于 Python 的自动化工具，专为简化 EVE-NG 虚拟环境中的镜像、图标和模板管理而设计。它通过从 Hi168 云平台 S3 存储桶同步文件，实现一键式镜像安装、图标配置和 YML 模板部署。 ## 开源声明 因该项目开源后容易被改造后在 pnetlab 上运行，故自 v1.0.5 版本以后不再开放源代码。在 EVE-NG 最新版本上正常使用不做任何限制，请勿将该工具运行在 pnetlab 平台，如果有发现在 pnetlab 上使用的，可能会对访问 IP 进行封禁处理，如果出现误封禁访问 IP ，请提 Issues。 ## 项目信息与贡献 本工具使用 Google 的 Gemini 开发，仅适用 EVE-NG 6.0 及以上社区版和专业版。 | 描述 | 详情 | | :-------------------- | :----------------------------------------------------------- | | **版本** | v1.1 | | **镜像存储服务** | Hi168 云存储 | | **Hi168 注册地址** | [http://www.hi168.com/#/login?invitation_code=9717HZ2](http://www.hi168.com/#/login?invitation_code=9717HZ2) | | **工具开发/仓库维护** | Guangran，Blog: [https://www.grbj.cn](https://www.grbj.cn) | | **镜像制作** | 韧体 | | **镜像发布地址** | [https://www.emulatedlab.com/thread-939-1-1.html](https://www.emulatedlab.com/thread-939-1-1.html) | | **EVE-NG 代理/官网** | [https://www.emulatedlab.com/](https://www.emulatedlab.com/) | | **镜像密码表** | https://www.emulatedlab.com/thread-1590-1-1.html | ## 核心功能 - **双界面支持：** 提供命令行 (CLI) 和 网页 (Web) 两种操作模式。 - **自动化部署：** 自动下载、解压、移动镜像文件，并同步对应的图标和 YML 模板。 - **智能环境检查：** 自动识别 CPU 架构（Intel/AMD）并部署适配的模板。 - **多线程加速：** CLI 版支持调用 `aria2c` 进行多线程下载。 - **Web 任务管理：** Web 版支持任务暂停、取消、实时日志查看和进度监控。 - **自动权限修复：** 部署完成后自动执行 EVE-NG 权限修复命令。 - **一键更新：** CLI 版支持自检测新版本并实现一键程序升级。 ## 环境要求 - **系统：** EVE-NG 6.0.0 及以上版本（社区版或专业版）。 - **权限：** 必须以 `root` 用户身份运行。 - **组件：** 脚本运行需具备 `requests` 模块；Web 版额外需要 `flask`。 ## 安装与使用 ## 安装与依赖 本项目适配 EVE-NG 6.0.0 以上版本。 ### 1. 下载与运行命令行版 (CLI) 将工具下载到 EVE-NG 主机上。 ```bash # 下载脚本 wget https://i.grbj.cn/eid # 赋予执行权限 chmod +x eid ``` 由于脚本涉及系统目录操作，必须以 `root` 用户身份运行。 ```bash ./eid ``` - **查看列表：** 输入 `L` 查看所有可用镜像。 - **搜索下载：** 直接输入镜像名称（如 `h3c-vbras`）进行搜索并安装。 - **退出：** 输入 `Q` 退出程序。 ### 2. 运行网页版 (Web) Bash ``` curl -L https://i.grbj.cn/inseid_web | bash ``` - **访问地址：** 浏览器打开 `http://:5000`。 - **登录验证：** 使用 EVE-NG 管理员账号（admin）登录。 - **操作：** 勾选所需镜像，点击“开始下载”即可实时监控进度。 ## 注意事项 - **安全验证：** 脚本包含远程授权密钥检查，确保工具为最新官方版本。 - **资源清理：** 程序在中断（Ctrl+C）或任务结束后会自动清理 `/tmp` 下的临时下载文件。 - **IOL 授权：** 对于 IOL 镜像，工具会自动下载 Keygen 并生成 `iourc` 授权文件。 ## 更新动态 ### v1.1.1 更新动态 - **🚀 新增批量下载**：支持通过任务列表一键同步多个镜像，大幅提升部署效率。 - **🔍 智能深度扫描**：自动识别压缩包内嵌套目录中的磁盘文件。 - **🛡️ 中断安全保护**：完善 Ctrl+C捕获逻辑，退出时自动清理 `/tmp` 临时文件及 `aria2` 残留。 - **📂 交互菜单重构**：优化主菜单分类（搜索、批量、删除、凭据），操作逻辑更清晰。 - **🔧 兼容性修复**：改进系统版本检测正则算法，解决特定语言环境下运行报错的问题。 ### v1.1.2 更新动态 - 支持web使用。 ## 测速表现 ### Hi168 云平台 eve-ng 社区懒人版 基本上可以跑满 Hi168 的带宽 ![](20251213234959833.webp) ### 湖南岳阳联通 宽带是 100 Mbps，测速能够到 45 Mbps 左右。 ![](20251214001350274.webp) ### 更多测速信息 具体速度受多方因素影响，Hi168 的总带宽有限，如果同一时间使用人数多，速度也会比较慢。 可以通过 Emulatedlab 频道查看评论区的测速截图：[https://pd.qq.com/s/bqe3urdr7](https://pd.qq.com/s/bqe3urdr7)，如果有建议和问题反馈也可以在这个频道文章中留言。