常见问题

安装与启动

启动报环境校验不通过

EID 启动时会自动校验运行环境。校验不通过时会明确打印失败原因。最常见的几种：

• 未以 root 用户运行：请使用 sudo 或切换到 root 用户
• EVE-NG 版本不兼容：需要 EVE-NG Pro 7.0 及以上版本
• EVE-NG 核心组件缺失：确认 EVE-NG 已正确安装
• Web 服务无法访问：确认 EVE-NG 的 Web 服务正常运行

提示不支持当前操作系统

EID 仅支持 Ubuntu 24.04。使用其他 Linux 发行版（Debian、CentOS、RHEL 等）将无法运行。

提示不支持 EVE-NG 版本

EID 仅支持 EVE-NG Pro 7.0 及以上版本，不支持 Community 社区版。

授权问题

从哪里获取授权码

关注微信公众号「广然笔记」，私信发送 EID 即可自动获取。

授权码提示无效

• 确认输入无误（注意区分大小写）
• 确认服务器能正常访问外网
• 确认授权码未被其他机器使用
• 如果刚在其他机器上注销，需等待几分钟

如何将授权迁移到新服务器

1. 在原服务器的 EID 中注销授权
2. 在新服务器上安装 EID
3. 使用同一个授权码激活

授权到期了

重新通过公众号获取新的授权码，在授权管理中选择更换授权码。

下载问题

下载速度很慢

• 尝试切换到另一个镜像源
• 检查服务器网络带宽使用情况
• 更换网络环境较好的时段下载

下载中断了

EID 支持断点续传。直接重新执行下载操作，会从上次中断的位置继续。不需要从头下载。

下载完成后镜像不显示

• 执行快捷操作中的”修复权限”
• 在 EVE-NG 管理界面手动执行 Fix Permissions
• 刷新 EVE-NG Web 界面

磁盘空间不足

EID 会在下载前检查磁盘空间。如果空间不足，需要：

• 清理不需要的镜像
• 删除旧的备份文件
• 扩容磁盘

Web 界面问题

浏览器打不开

• 确认 eid web 已正常启动
• 确认使用的是正确的 IP 地址和端口（默认 5000）
• 检查防火墙是否放行对应端口

登录失败

• 确认使用的是 EVE-NG 管理员账号密码
• 确认 EVE-NG Web 服务正常运行
• 多次失败需等待 5 分钟锁定解除

Web 界面显示异常

• 尝试刷新浏览器页面
• 清除浏览器缓存
• 重启 Web 服务：先 Ctrl+C 停止，再 eid web 启动

其他问题

如何导出日志给开发者排查

eid --log save

此命令会将完整日志导出到你当前用户的目录下。

如何卸载 EID

停止服务（如果正在运行）：

systemctl stop eidsystemctl disable eid

然后删除安装目录即可。已下载的镜像文件不会受影响。

联系支持

如需技术支持，请通过微信公众号「广然笔记」留言反馈。提交问题时最好附上：

• EID 版本号（eid --version）
• 错误日志（eid --log save 导出的文件）
• 问题复现步骤