这是什么
EID（EVE-NG Image Director）是面向 EVE-NG 用户的镜像管理工具。它把云端镜像下载、本地文件上传、批量任务、解压部署、权限修复、IOL 镜像授权这些日常工作，统一到一个命令行界面和一个 Web 面板里。
能解决什么问题
EVE-NG 的镜像管理是日常工作中最高频的环节——单一镜像动辄几个 GB，使用网盘下载速度慢、下载后还需要手工部署、部署后还要同步图标、模板、脚本，中间任何一个环节出错都会让镜像在节点列表里看不到。
EID 把这条链路上每一段都封装好：
- 云端下载：多线程下载 + 断点续传 + 文件校验，断网或重启不丢进度
- 自动部署：下载完自动解压，复制到 EVE-NG 对应目录，同步配套组件
- 权限修复：每次部署后自动修复文件权限，IOL 镜像自动生成许可文件
- 本地上传：Web 端支持大文件上传，中断后可从断点续传
- 批量任务：一键下载并部署一组镜像
三大入口
EID 围绕同一个可执行文件展开，根据子命令进入不同入口：
| 入口 | 启动方式 | 适用场景 |
|---|---|---|
| CLI 交互菜单 | eid | SSH 远程管理，边下边看日志 |
| Web UI | eid web | 浏览器可视化操作，管理进度一目了然 |
| 自更新 | eid --update | 拉取最新版本 |
另外还有几条辅助命令：
TERMINALbash
# 输出版本号root@eve-ng:~# eid --version# 查看最近 200 行日志root@eve-ng:~# eid --log 200# 实时跟踪日志（类似 tail -f）root@eve-ng:~# eid --log follow# 把完整日志导出到用户目录root@eve-ng:~# eid --log save系统要求
工具启动时会自动校验运行环境，不满足条件会直接退出并说明原因。
操作系统
- 必须：Ubuntu 24.04（已安装 EVE-NG v7 服务的系统）
- 必须：root 权限运行
- 不支持 Debian、CentOS、RHEL 等其他发行版
EVE-NG 版本
- 必须：EVE-NG Pro 7.0 及以上
- 不支持 EVE-NG v6 Community 版和 Pro 版
硬件与网络
- 磁盘：至少保留镜像大小 1.1 倍的空间（部署时会复制到 EVE-NG 目录）
- 网络：需要能访问云端镜像源
- 端口：Web 模式默认使用 5000 端口，可自定义
关键概念
镜像类型
EID 支持 EVE-NG 的三种节点镜像：
| 类型 | 典型代表 | 说明 |
|---|---|---|
| QEMU | 路由器、交换机虚拟镜像 | 最常见的镜像类型，部署到 QEMU 目录 |
| IOL | Cisco IOL（IOS on Linux） | 轻量级 Cisco 设备模拟 |
| Docker | 容器化网络设备 | 由 Docker 引擎管理 |
镜像源
工具支持多个下载源，可在不同来源之间切换。详见多源切换。
授权
工具首次启动会联网验证授权，未授权时进入激活流程。授权码通过官方渠道获取，详见授权管理。
配套组件
每个 QEMU 镜像要正常显示在 EVE-NG 节点面板中，通常还需要：
- 图标：显示在节点选择列表
- 模板：节点的 CPU、内存、接口配置
- 脚本：首次启动时的初始化逻辑
EID 会在部署时自动同步这些文件到正确位置，无需手动处理。
阅读路径建议
如果你是第一次接触 EID，建议按下面的顺序阅读：