Web 模式详解

启动 Web 模式

在终端执行：

eid web

默认监听所有网络接口的 5000 端口。可通过参数自定义：

eid web --port=5050      # 使用 5050 端口eid web --host=127.0.0.1 # 仅本地访问

启动后在浏览器中访问 http://<服务器IP>:<端口>。

登录

Web 界面使用 EVE-NG 管理员账号登录（与 EVE-NG Web 管理界面相同的用户名和密码）。

登录失败 5 次后会临时锁定 5 分钟，请留意。

界面布局

登录后的主界面分为以下几个区域：

• 顶部导航：公告通知、版本更新提示
• 左侧面板：镜像列表，支持搜索和分类浏览
• 中央区域：镜像详情、下载进度、操作反馈
• 右侧面板：任务列表，查看所有下载任务的实时状态

镜像下载

浏览与搜索

在左侧镜像列表中：

• 输入关键词搜索镜像
• 点击分类标签按类型筛选
• 点击镜像名称查看详细信息

单个下载

1. 在列表中找到目标镜像，点击进入详情
2. 选择需要的版本
3. 点击下载按钮
4. 任务加入右侧任务列表，实时显示进度

组件选择

下载时可选择性包含以下配套组件：

• 镜像文件（必须）
• 图标文件
• 模板文件
• 配置脚本

默认全部选中，可根据需要取消不需要的组件。

任务管理

右侧任务列表显示所有正在执行和已完成的任务。

任务控制

• 暂停：暂停正在下载的任务
• 恢复：继续被暂停的任务
• 取消：取消任务（已下载的部分不会保留）
• 清除已完成：清理已完成任务的显示记录
• 清除全部：清除所有非进行中的任务

任务进度每 3 秒自动刷新。

镜像删除

在已安装镜像列表中选择要删除的镜像：

1. 按类型筛选（QEMU / IOL）
2. 勾选目标镜像
3. 确认删除

镜像源管理

在设置区域可以：

• 查看当前使用的镜像源
• 测试各镜像源的连接速度
• 切换到其他镜像源

详见多源切换。

本地上传

Web 模式支持直接上传本地镜像文件，无需通过命令行的方式。支持：

• QEMU 镜像文件上传
• IOL 镜像文件上传
• Docker 镜像文件上传
• 配套组件上传（图标、模板、脚本）

大文件自动分片上传，中断后可从断点续传。详见本地上传。

快捷操作

在操作面板中提供以下快捷功能：

• 修复权限：修复镜像文件权限问题
• 检查激活：检测 EVE-NG 激活服务器连通性
• MySQL 修复：执行数据库修复

详见快捷操作。

密码查询

在 Web 界面中可以查看所有已安装镜像的默认登录凭据（用户名和密码）。

配置备份

• 导出：将当前已安装的镜像列表导出为备份文件
• 导入：上传之前的备份文件恢复到当前环境

版本更新

Web 界面会提示新版本可用，点击”升级”按钮即可自动完成更新。详见自更新机制。

退出 Web 模式

在终端中按 Ctrl+C 停止 Web 服务。

常见问题

浏览器打不开页面

• 确认 EVE-NG 服务器 IP 和端口正确
• 检查防火墙是否放行了对应端口
• 确认 eid web 命令是否正常启动且无报错

登录失败

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