快速开始：从零到第一个镜像

前置条件

开始之前请确认：

1. 已安装 Ubuntu 24.04 并成功运行 EVE-NG 7.0+
2. 以 root 用户登录
3. 服务器能正常访问外网

第一步：安装 EID

执行如下命令，一键完成安装与启动。

root@eve-ng:~# curl -L https://eid.grbj.cn/install-eid.sh | bash

第二步：首次启动

在终端输入 eid 启动 CLI 模式：

root@eve-ng:~# eid

首次启动会自动完成以下检查：

1. 验证以 root 权限运行
2. 确认 EVE-NG 核心组件存在且版本正确
3. 检查 Web 服务连通性

全部通过后进入授权激活流程。

第三步：激活授权

首次使用时需要激活授权。获取授权码的步骤：

1. 关注微信公众号「广然笔记」
2. 私信发送 EID 自动获取授权码

在 EID 的授权菜单中输入授权码即可完成激活。激活信息会保存在本地，后续启动自动验证，无需重复操作。

如果授权码验证失败，请确认：

• 授权码输入无误（注意区分大小写）
• 服务器能正常访问外网
• 授权码未在别的机器上使用

第四步：选择镜像

激活成功后进入主菜单。输入 1 选择单个镜像下载功能：

1. 输入镜像名称关键词进行搜索，系统列出匹配的镜像列表
2. 选择目标镜像，再选择需要的版本
3. 搜索时支持模糊匹配，可以输入设备名称、品牌或型号的部分关键词。输入 L 可列出所有可用镜像，还可按类型（QEMU/IOL/Docker）过滤。

第五步：下载与部署

确认下载后，工具自动完成以下步骤：

1. 检查磁盘空间是否充足
2. 开始下载镜像文件（支持断点续传）
3. 下载完成后自动解压
4. 将镜像部署到 EVE-NG 对应目录
5. 同步图标、模板、脚本等配套组件
6. 执行权限修复

整个过程无需人工干预。下载中断（断网、重启等）后再次启动，会从断点继续，不会重复下载已完成的部分。

第六步：验证结果

部署完成后，刷新 EVE-NG Web 管理界面，新建 Lab 时即可在节点列表中找到新下载的镜像。

如果镜像没有出现，可以尝试：

• 在 EID 中选择快捷操作 -> 修复权限
• 在 EVE-NG 中执行 Fix Permissions

使用 Web 模式

如果不习惯命令行操作，可以启动 Web 模式：

root@eve-ng:~# eid web

然后在浏览器中访问 http://<服务器IP>:5000，使用 EVE-NG 管理员账号登录，即可通过图形界面管理镜像。

常用的 Web 启动参数：

# 默认端口 5000root@eve-ng:~# eid web# 使用 5050 端口root@eve-ng:~# eid web --port=5050

下一步

• 了解 CLI 模式全部功能：CLI 模式详解
• 学习 Web 界面操作：Web 模式详解
• 一次下载多个镜像：批量任务