1. 从一次糟心的登录故障说起：我的EVE-NG汉化踩坑记
那天晚上，我正打算在EVE-NG里搭个复杂的BGP实验环境，准备给学员录个教学视频。像往常一样，我输入admin和eve，点击登录。光标转了两圈，然后……页面就卡住了，没有任何反应，没有错误提示，就像一拳打在了棉花上。我刷新，再试，还是老样子。这已经不是第一次了，自从我给手里的EVE-NG 6.0社区版做完汉化之后，这个“登录无效”的幽灵就时不时地冒出来，尤其是重启几次之后，问题必现。更让我头大的是，后台私信里，不少跟着我教程操作的朋友也遇到了同样的问题，有的甚至汉化完就再也进不去了。这让我下定决心，必须把这个坑彻底填平。
EVE-NG是个神器，它让我们能在个人电脑上模拟出整个数据中心的路由交换环境，对网络工程师和备考认证的朋友来说，简直是练习的福音。但它的界面默认是英文的，对于很多初学者或者习惯中文环境的工程师来说，多少有些门槛。所以，汉化就成了很多人的刚需。问题就出在这里：官方和主流社区对6.0版本的汉化支持几乎为零，大家用的基本都是基于5.0版本修改的汉化包。直接套用，在6.0上就容易出现各种兼容性问题，其中“登录无响应”是最常见也最让人头疼的一个。
这次，我不光要解决这个登录问题，还要把6.0版本的汉化给折腾明白。整个过程，就像一次侦探破案，从系统环境查起，到缺失的文件，再到代码层面的对比封装。我会把每一步的操作、背后的原理，以及我踩过的每一个坑，都原原本本地分享出来。如果你也困在EVE-NG 6.0的登录界面前，或者对汉化后的稳定性心存疑虑，那这篇攻略就是为你准备的。咱们不搞那些虚头巴脑的理论，直接上手，见招拆招。
2. 第一站：系统环境与基础检查，排除“水土不服”
遇到问题，尤其是这种玄学般的“有时行有时不行”的问题，千万别一头扎进代码里。我的经验是，先从运行环境查起，这往往能解决一大半的麻烦。对于EVE-NG来说，最重要的环境因素就是操作系统版本。
我一开始也没太在意，心想Ubuntu嘛，肯定是越新越好。我的实验机装的是Ubuntu 22.04 LTS，结果就栽在了这上面。后来我去翻了EVE-NG官方的文档和社区讨论，才发现这里有个大坑。EVE-NG 6.0到6.2版本，官方明确推荐且稳定支持的系统是Ubuntu 20.04 LTS (Focal Fossa)。次选是Ubuntu 18.04 LTS，而Ubuntu 22.04 LTS并未得到官方正式支持。
为什么不支持？主要是因为22.04的内核版本、系统库（比如PHP、Apache/Nginx的模块）和依赖包版本发生了较大变化。EVE-NG的安装脚本和核心组件是针对20.04的环境编译和测试的，强行在22.04上运行，就像给一辆精密调校的赛车加了不同标号的汽油，短期内可能能跑，但指不定什么时候就会爆震、熄火。我们遇到的登录API无响应，很可能就是底层PHP扩展或Web服务模块与系统不兼容导致的。
怎么查看自己的系统版本？很简单，打开你的终端（SSH或者直接桌面打开），输入下面这条命令：
lsb_release -a你会看到类似这样的输出：
No LSB modules are available. Distributor ID: Ubuntu Description: Ubuntu 22.04.3 LTS Release: 22.04 Codename: jammy如果你的Description显示是Ubuntu 22.04，那么恭喜你，找到了问题的潜在根源。我的建议非常直接：如果你尚未安装EVE-NG，请务必选择Ubuntu 20.04 LTS作为宿主系统。如果已经装在了22.04上，并且问题频发，最彻底的办法就是备份数据，重装20.04系统，然后再部署EVE-NG。这看似麻烦，实则一劳永逸，能避免后续无数稀奇古怪的兼容性报错。
除了系统版本，还有一个新手常忽略的“低级错误”——磁盘空间不足。EVE-NG运行和存放镜像需要不少空间，如果/opt分区或者根目录满了，Web服务可能无法正常写入会话或日志，导致登录过程静默失败。用df -h命令检查一下磁盘使用情况，确保有足够的余量。
3. 登录无效的深度排查：从浏览器控制台到后台服务
确认系统版本没问题后，如果登录故障依旧，我们就需要更深入地排查了。这里我分享一个非常实用的“破案”流程，从前端到后端，一步步缩小范围。
第一步：打开浏览器的“侦探工具”——开发者控制台。在登录页面，按F12（Chrome/Firefox/Edge通用），切换到Network（网络）选项卡。然后，故意输入错误的密码点击登录，或者直接点击登录按钮。这时，你会看到浏览器在疯狂地加载各种资源文件（JS、CSS、图片）和发起API请求。我们的重点是找到一个名为login或类似字样的POST请求，它的目标地址通常是/api/auth/login。点击这个请求，查看它的Status（状态码）。
- 状态码 200 (OK)： 这其实是个“好消息”，说明你的用户名密码正确，服务器也接受了请求。但页面没跳转，问题可能出在前端JavaScript对成功响应的处理上，或者后续的页面重定向资源（比如
/main）加载失败了。此时要再看Console（控制台）选项卡，有没有红色的JavaScript报错。 - 状态码 400 (Bad Request)： 这通常意味着你输入的用户名或密码格式不对，或者根本就是错的。请确认默认账号是
admin，密码是eve。 - 状态码 404 (Not Found)或500 (Internal Server Error)： 这是最需要警惕的情况！404说明
/api/auth/login这个接口路径根本不存在，500则是服务器内部处理请求时崩溃了。这两种都强烈指向EVE-NG的Web服务文件缺失或损坏，尤其是我们汉化过程中误操作导致的。
我遇到的情况，以及很多粉丝反馈的，常常是在控制台看到类似GET .../company.png 404 (Not Found)的错误。这个company.png是登录页面左上角显示的一个Logo图片。虽然一个图片丢失不至于让登录功能完全瘫痪，但它是一个明确的信号：你的/opt/unetlab/html目录下的文件结构不完整了。
第二步：后台验证与文件检查。关掉浏览器，我们用SSH工具（比如MobaXterm、Xshell，或者系统自带的终端）登录到EVE-NG服务器。首先，检查这个出名的company.png：
# 检查文件是否存在 ls -la /opt/unetlab/html/themes/adminLTE/unl_data/img/company.png # 如果上面的命令提示文件不存在，可以尝试创建目录和空文件（临时解决） sudo mkdir -p /opt/unetlab/html/themes/adminLTE/unl_data/img/ sudo touch /opt/unetlab/html/themes/adminLTE/unl_data/img/company.pngtouch命令创建的是一个0字节的空文件，这能让404错误消失，但对于解决核心的登录API问题，这通常只是杯水车薪。关键是要检查整个API目录是否存在：
ls -la /opt/unetlab/html/includes/你要确认里面存在大量的.php文件，特别是与api相关的。如果这个includes目录看起来空空如也，或者明显比正常安装时小很多，那基本可以断定，汉化过程中文件替换出现了严重错误，或者原始的EVE-NG安装就是不完整的。
第三步：终极解决方案——有技巧地重装。如果确认是核心文件缺失，最有效、最干净的办法就是重新安装EVE-NG的Web部分。别怕，你的镜像文件（在/opt/unetlab/addons/）和实验拓扑文件（在/opt/unetlab/labs/）是可以保留的。操作前务必备份！
# 1. 备份你的实验数据和配置（非常重要！） sudo mkdir -p /root/eve-backup sudo cp -r /opt/unetlab/data /root/eve-backup/ sudo cp -r /opt/unetlab/labs /root/eve-backup/ # 2. 重新运行官方安装脚本，它会修复Web文件 wget -O - http://www.eve-ng.net/repo/install-eve.sh | sudo bash -i这个脚本会检测已安装的组件，并重新配置和安装缺失的部分。执行完成后，重启系统：sudo reboot。重启后，先用默认的英文界面测试登录，如果一切正常，说明底层服务已经修复。这时，我们再去考虑汉化的问题，而且要以一种更安全、更精细化的方式来进行。
4. 为EVE-NG 6.0打造专属汉化包：手工对比与封装实战
系统环境干净了，基础服务也正常了，现在我们直面核心挑战：如何为EVE-NG 6.0制作一个稳定可用的汉化包？社区没有现成的，直接用5.0的又问题百出，我的思路是：手工对比，差异合并，逐步替换，测试验证。这听起来很笨，但却是最可靠的方法。
我准备了两个干净的目录：一个是原始的EVE-NG 6.0的/opt/unetlab/html文件备份，另一个是网上找到的针对5.0的汉化包文件。我的工具是VS Code，利用它的“比较文件夹”功能，可以清晰地看到两个版本间文件的差异。
第一步：对比与替换非核心逻辑文件。我从一些看起来“人畜无害”的纯文本文件开始，比如语言文件。
/includes/api_folders.php： 这个文件里，我发现了第一个有趣的不同。在显示文件修改时间的代码行里，5.0汉化包和6.0原版使用了不同的日期格式。- 5.0汉化版：
date("Y-m-d H:i", ...)输出2023-10-01 14:30 - 6.0原版：
date("d M Y H:i", ...)输出01 Oct 2023 14:30这里仅仅是格式区别，不涉及功能。我选择保留6.0原版的格式，只翻译其周围的英文提示文字。因为日期格式属于系统偏好，改动可能引发其他未知问题。
- 5.0汉化版：
/includes/messages_en.php： 这个文件是关键的提示信息字典。我对比后发现，6.0版本新增了一些5.0没有的键值对（key-value pair）。我的策略是：将5.0汉化包中已有的翻译条目合并到6.0的文件里，对于6.0新增的英文条目，自己手动翻译。确保每个=>后面的英文都变成中文，但绝对不动=>前面的键名。
每替换完一个或一小批文件，我都会执行一次sudo reboot重启EVE-NG服务，然后立刻测试登录和基本功能是否正常。这一步一验证虽然耗时，但能让你精准定位到是哪个文件的改动引发了问题。
第二步：攻坚前端控制器文件。接下来是重头戏，位于/themes/adminLTE/unl_data/js/angularjs/controllers/下的几个JavaScript控制器文件。这里控制着登录、弹窗、系统状态等核心前端逻辑。
loginCtrl.js： 这是登录页面的核心控制器。我对比发现，6.0版本在登录成功后的回调函数里，增加了一些状态判断和日志记录。我没有直接用5.0的汉化文件覆盖，而是用6.0的原版文件作为基础，只将其中的用户提示信息字符串（如'Invalid username or password!'）翻译成中文（'用户名或密码错误！'），而完全保留其原有的函数逻辑和新增的代码块。这是避免登录故障的关键！modalCtrl.js和sysstatCtrl.js： 同理，采用“保留逻辑，只译文字”的策略。使用代码编辑器的批量替换功能，小心地将可见的英文提示信息替换成中文，对于函数名、变量名、API接口路径等，一个字符都不碰。
第三步：处理大量的页面模板文件。页面文件主要在/themes/adminLTE/unl_data/pages/目录下，数量众多。我的方法是分文件夹批量处理：
- 使用
grep命令或VS Code的全局搜索，在这些.html文件中查找常见的英文词汇，如Submit、Cancel、Loading、Error等，进行替换。 - 对于复杂的页面，我会在浏览器打开对应功能的英文页面（如设备列表页），查看各个按钮、表头的英文是什么，然后去文件里精准定位替换。
- 特别注意那些带有
ng-bind（AngularJS数据绑定）的元素，它们显示的文字通常是在控制器里定义的，我们已经在上一步处理了，这里不要修改。
第四步：侧边栏和全局汉化。侧边栏的菜单文字定义在/themes/default/js/messages_en.js（或类似名称）文件中。这是一个标准的JSON格式的键值对文件。我在这里花费了不少时间，因为要确保翻译的准确性和统一性（比如“交换机”在全站都用同一个词）。同样，只修改值（value），不修改键（key）。
经过这样一轮“外科手术式”的汉化，我得到了一个专门针对EVE-NG 6.0版本修改的opt文件夹。我将它打包，并在自己的实验环境中持续运行了一周，进行各种操作（创建实验、添加节点、启动设备、保存配置），均未再出现登录无效或界面错乱的问题。
5. 封装、测试与资源分享：让你的汉化一劳永逸
手工替换测试成功后，就可以封装成大家方便使用的汉化包了。我的封装思路是提供两种选择，适应不同用户的需求。
方案A：纯净替换包（适合全新安装或勇于尝试的用户）这个包只包含我修改过的所有文件，目录结构保持和/opt/unetlab/html一致。你需要做的就是：
- 备份你当前的
/opt/unetlab/html目录（切记！）：sudo cp -r /opt/unetlab/html /opt/unetlab/html_backup - 下载我的汉化包，解压后，将其中的所有文件覆盖到
/opt/unetlab/html目录。 - 执行权限修复命令（EVE-NG对文件权限有要求）：
sudo /opt/unetlab/wrappers/unl_wrapper -a fixpermissions - 重启EVE-NG服务或直接重启服务器：
sudo reboot
方案B：带原版备份的增量包（适合追求绝对安全的用户）我考虑到很多朋友怕操作失误，所以制作了另一个版本。在这个包里，每个我修改的文件，都会在同级目录下保留一个名为文件名.original的备份（例如loginCtrl.js.original）。这样，如果你替换后发现问题，可以快速地将单个文件恢复原状，而无需还原整个目录。
关于测试，我建议不要汉化完就了事。请系统地进行以下操作，确保汉化稳定：
- 登录登出测试： 用
admin/eve多次登录、登出，检查有无卡顿或错误。 - 核心功能遍历： 创建新实验、添加不同厂商的设备节点（如Cisco IOU、vIOS）、启动设备、尝试连接Console。
- 界面全面检查： 点击每一个侧边栏菜单（仪表盘、设备列表、模板、用户管理等），查看所有表格、按钮、弹窗的显示是否正常，有无乱码或未翻译的英文“漏网之鱼”。
- 浏览器兼容性： 至少在Chrome和Firefox最新版上测试一下。
最后，我想说，汉化工作是个细活，尤其面对EVE-NG这样不断更新的项目。我封装这个汉化包，是基于6.0的某个具体小版本（例如6.0-110）。随着EVE-NG官方版本的升级，核心文件可能会发生变化，直接覆盖可能导致问题。因此，最理想的方式是理解我上面介绍的对比和修改方法。当未来新版本出现时，你可以用同样的方法，基于官方新版本和当前汉化包，去做差异化的合并，这样才能持续用上稳定的中文界面。折腾的过程虽然费时，但当你看到一个完全中文化的网络实验平台稳定运行时，那种成就感，以及能帮助更多人无障碍地使用这个工具，我觉得值了。
