# 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**: 9
- **Forks**: 4
- **Created**: 2025-12-18
- **Last Updated**: 2026-02-01

## 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 存储桶自动同步配置和文件，实现一键式的镜像安装。

## 项目信息与贡献

本工具使用 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             |


## 功能特性

* **集中式配置管理：** 自动下载 `eve_images.json` 核心配置文件，始终保持最新镜像列表。
* **一键式部署：** 支持 QEMU 和 IOL 格式镜像的下载、解压和文件归档。
* **CPU 架构兼容性：** 自动检测主机 CPU 架构（Intel/AMD）并部署正确的模板文件。
* **交互式列表：** 命令行界面支持输入 `L` 查看所有可用的镜像列表。
* **自动权限修复：** 部署完成后自动执行 EVE-NG 的权限修复命令。
* **环境自清理：** 自动清理所有下载的临时压缩包和配置文件。

## 安装与依赖

本项目适配 EVE-NG 6.0.0 以上版本。

### 1. 下载并运行脚本

将脚本下载到 EVE-NG 主机上。

```bash
# 下载脚本
wget https://i.grbj.cn/eid

# 赋予执行权限
chmod +x eid
```

由于脚本涉及系统目录操作，必须以 `root` 用户身份运行。

```bash
./eid
```

### 2. 交互式操作

程序启动后，会显示项目信息并提示您输入要下载的镜像名称。

**查看列表：** 输入 `L` (不区分大小写) 查看配置表中所有可用的镜像名称。

**下载部署：** 输入完整的镜像名称（例如 `openeuler-2403-lts-sp2`），程序将自动完成后续所有步骤。

**退出程序：** 输入 `q` 退出程序，程序将自动执行清理操作。

## 配置说明

所有镜像和配置的元数据都存储在 `eve_images.json` 文件中，脚本运行时会自动下载最新的文件。

```
{
    "openeuler-2403-lts-sp2": {
        "s3_type": "qemu",             
        "s3_path_prefix": "openEuler/", 
        "s3_base_name": "openeuler-2403-lts-sp2", 
        "config_name": "openeuler"      
    }
}
```

## 更新动态

### v1.1.0 更新动态

- **🚀 新增批量下载**：支持通过任务列表一键同步多个镜像，大幅提升部署效率。
- **🔍 智能深度扫描**：自动识别压缩包内嵌套目录中的磁盘文件。
- **🛡️ 中断安全保护**：完善 <kbd>Ctrl</kbd>+<kbd>C</kbd>捕获逻辑，退出时自动清理 `/tmp` 临时文件及 `aria2` 残留。
- **📂 交互菜单重构**：优化主菜单分类（搜索、批量、删除、凭据），操作逻辑更清晰。
- **🔧 兼容性修复**：改进系统版本检测正则算法，解决特定语言环境下运行报错的问题。

## 测速表现

### 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)，如果有建议和问题反馈也可以在这个频道文章中留言。