MogFace人脸检测模型WebUI在虚拟机中的部署实践：VMware环境配置指南

MogFace人脸检测模型WebUI在虚拟机中的部署实践：VMware环境配置指南

你是不是也对AI人脸检测模型感兴趣，想亲手搭建一个来玩玩，但又苦于没有一台独立的服务器或者高性能电脑？别担心，今天我们就来解决这个问题。我将带你一步步在VMware虚拟机里，从零开始部署MogFace人脸检测模型的WebUI界面。

这个方法特别适合学生、开发者或者任何想低成本学习AI部署的朋友。你只需要一台普通的Windows或Mac电脑，通过VMware创建一个Ubuntu系统的虚拟机，就能在里面搭建一个完整的人脸检测服务。整个过程，我会尽量用大白话讲清楚，即使你之前没怎么接触过虚拟机和Linux，也能跟着做下来。

我们会从创建虚拟机、安装系统开始，讲到怎么让虚拟机和你的电脑顺畅交互，最后完成MogFace WebUI的部署和访问。无论你的宿主机有没有独立显卡，我们都有对应的方案。准备好了吗？让我们开始吧。

1. 准备工作与环境搭建

在开始部署之前，我们需要先把“舞台”搭好。这个舞台就是一台运行Ubuntu系统的虚拟机。别被“虚拟机”这个词吓到，你可以把它理解为你电脑里运行的一个完全独立的、虚拟出来的小电脑。

1.1 获取必要的软件和镜像

首先，你得准备好三样东西：

1. VMware Workstation Player：这是创建和管理虚拟机的软件。它有个免费的个人版，功能完全够用。去VMware官网就能下载到。
2. Ubuntu Server 镜像：这是虚拟机的“操作系统”。我们选择Ubuntu Server而不是桌面版，因为它更轻量，资源占用少，更适合做服务器。建议下载最新的LTS（长期支持）版本，比如22.04 LTS，稳定性好。
3. MogFace WebUI 部署脚本或文档：这是我们今天的主角。你需要提前从MogFace的官方GitHub仓库或其他可靠来源，找到它的部署指南或一键安装脚本。

把Ubuntu的ISO镜像文件下载到你的电脑上，记住存放的位置。VMware软件直接安装就行，和装其他软件没什么区别。

1.2 创建你的第一台Ubuntu虚拟机

打开安装好的VMware Workstation Player，点击“创建新虚拟机”。我们会遇到几个关键选择，我帮你把把关：

• 安装来源：选择“安装程序光盘映像文件”，然后点“浏览”，找到你刚才下载的Ubuntu ISO文件。
• 虚拟机命名和位置：给虚拟机起个名字，比如“MogFace-Server”。位置最好选一个硬盘空间充足（建议至少预留40GB）的路径。
• 磁盘容量：这里建议设置大一点，比如50GB。不用担心，这个数字不是立即占用的，而是最大上限。选择“将虚拟磁盘拆分成多个文件”，这样更方便管理。
• 硬件自定义（关键步骤）：在最后一步，先别急着点完成，点击“自定义硬件”。我们需要根据宿主机的情况来调整：
  • 内存：至少分配4GB（4096 MB）。如果你的电脑内存有16GB或以上，可以分8GB给虚拟机，这样它运行起来更流畅。
  • 处理器：核心数至少2个。同样，宿主机性能强的话，可以多分一些。
  • 网络适配器：这里先保持默认的“NAT模式”。简单理解，就是让虚拟机共享你宿主机的网络上网，就像你手机连接家里Wi-Fi一样。后续如果需要从宿主机访问虚拟机的Web服务，这个模式通常就够了。

设置完成后，就可以启动虚拟机了。虚拟机会从ISO镜像启动，进入Ubuntu Server的安装界面。安装过程基本都是图形化点击，注意以下几点：

• 语言选择英文或中文都可以。
• 在“配置网络连接”那里，可能会显示一个网卡（比如ens33），不用管，直接下一步。
• 磁盘分区选择“使用整个磁盘”即可，安装程序会帮你自动分区。
• 设置你的用户名、密码，记住它们，后面登录要用。
• 在“选择要安装的软件”这一步，务必勾选“OpenSSH server”。这样我们后面才能用更方便的工具从宿主机连接到虚拟机进行操作。

安装完成后，虚拟机会提示重启。重启后，你就拥有了一台崭新的、运行在你自己电脑里的Ubuntu服务器了。

2. 虚拟机优化与基础配置

虚拟机装好了，但用起来可能还有点别扭，比如屏幕大小不能自适应，文件也不能直接在宿主机和虚拟机之间拖拽。这一步就是来搞定这些，让它用起来更顺手。

2.1 安装VMware Tools

VMware Tools是一套增强工具，安装后能带来很多便利：

• 屏幕自适应：虚拟机窗口大小改变时，Ubuntu的桌面（如果是桌面版）或命令行界面会自动调整分辨率。
• 剪贴板共享：可以在宿主机和虚拟机之间复制粘贴文字。
• 文件拖放：可以直接把宿主机上的文件拖到虚拟机里，或者反过来。

在Ubuntu Server里安装很简单。首先，确保虚拟机系统已经启动并登录。在VMware软件顶部的菜单栏，点击“虚拟机” -> “安装VMware Tools”。这会在虚拟机里挂载一个虚拟光盘。

然后，在Ubuntu的命令行里执行以下命令：

# 创建一个临时挂载点，并把工具光盘挂载上去 sudo mkdir -p /mnt/cdrom sudo mount /dev/cdrom /mnt/cdrom # 进入光盘目录，你会看到一个以.tar.gz结尾的压缩包 cd /mnt/cdrom # 将安装包复制到用户目录并解压 cp VMwareTools-*.tar.gz ~/ cd ~ tar -xzf VMwareTools-*.tar.gz # 进入解压后的目录并运行安装脚本 cd vmware-tools-distrib/ sudo ./vmware-install.pl

安装脚本运行后，会问一堆问题，一路按回车键选择默认选项就行。安装完成后，重启虚拟机生效：

sudo reboot

2.2 配置网络与SSH连接

现在，我们配置一下网络，并建立一个更稳定的远程连接方式。一直盯着虚拟机窗口操作不方便，我们用SSH从宿主机的终端（比如Windows的PowerShell或CMD，Mac的终端）连进去操作。

首先，在虚拟机里，查看它的IP地址：

ip addr show

找到inet那一行，后面跟着的类似192.168.xxx.xxx的就是虚拟机的IP地址，记下来。

然后，打开你宿主机的终端（比如Windows PowerShell），使用刚才记下的IP地址和你的用户名进行连接：

ssh your_username@192.168.xxx.xxx

输入密码后，你就进入了虚拟机的命令行。以后所有操作都可以在这个SSH窗口里进行，比在虚拟机窗口里操作要方便得多，还可以复制粘贴命令。

3. MogFace WebUI部署实战

环境准备好了，现在进入正题，开始部署MogFace。这里我们假设使用CPU模式进行，因为大多数人的宿主机可能没有独立显卡，或者有显卡但配置直通比较麻烦。CPU模式完全可行，只是检测速度会慢一些，非常适合学习和测试。

3.1 部署环境准备

通过SSH连接到虚拟机后，我们先更新系统并安装一些基础依赖：

# 更新软件包列表 sudo apt update sudo apt upgrade -y # 安装Python3和pip（如果还没安装的话） sudo apt install python3 python3-pip -y # 安装Git，用于拉取代码 sudo apt install git -y

接下来，为我们的项目创建一个独立的工作目录：

mkdir ~/mogface_project cd ~/mogface_project

3.2 获取MogFace代码与模型

现在，我们把MogFace的代码和训练好的模型下载下来。你需要找到MogFace官方或社区提供的WebUI仓库地址（这里用示例地址代替，请替换为真实地址）：

# 克隆WebUI前端界面代码（示例） git clone https://github.com/example_user/mogface-webui.git cd mogface-webui # 克隆或下载MogFace模型核心代码及权重文件（示例） # 通常模型权重文件（.pth）需要从云盘或模型仓库单独下载 # 假设我们已经将权重文件放在了当前目录下，命名为‘mogface.pth’

重要提示：模型权重文件（.pth文件）通常比较大，可能需要从Google Drive、百度网盘等渠道手动下载，然后通过我们之前安装的VMware Tools拖拽功能，或者使用SCP命令，从宿主机上传到虚拟机的这个目录里。

3.3 安装Python依赖并启动服务

进入WebUI代码目录，安装所需的Python库。通常项目会提供一个requirements.txt文件：

# 安装依赖，建议使用虚拟环境（可选但推荐） pip3 install -r requirements.txt

安装完成后，查看项目目录下的README或启动脚本，找到启动WebUI的命令。通常是一个Python脚本：

# 示例启动命令，具体请参照项目文档 python3 app.py --model-path ./mogface.pth --host 0.0.0.0 --port 7860

解释一下这几个参数：

• --model-path：指定你下载的模型权重文件路径。
• --host 0.0.0.0：这很关键！表示服务监听所有网络接口，这样宿主机才能访问到。
• --port 7860：指定服务运行的端口号，你可以换成其他未被占用的端口。

执行命令后，如果看到输出类似Running on local URL: http://0.0.0.0:7860，就说明服务启动成功了。

4. 访问测试与问题排查

服务跑起来了，但我们是在虚拟机里，怎么从外面的宿主机访问呢？

4.1 从宿主机访问WebUI

由于我们创建虚拟机时使用的是NAT网络模式，VMware会为虚拟机分配一个与宿主机不同网段但可路由的IP。之前用ip addr查到的就是那个IP。

现在，打开你宿主机上的浏览器（比如Chrome），在地址栏输入：

http://[你的虚拟机IP地址]:7860

例如：http://192.168.88.129:7860

如果一切配置正确，你应该就能看到MogFace的WebUI界面了！你可以上传一张图片试试人脸检测效果。

4.2 常见问题与解决思路

如果访问不了，别急，我们可以按以下步骤排查：

1. 检查虚拟机防火墙：Ubuntu默认的防火墙ufw可能会阻止端口。我们可以暂时关闭它，或者开放7860端口。

   # 查看防火墙状态 sudo ufw status # 如果状态是active，开放7860端口 sudo ufw allow 7860 # 或者（仅用于测试）暂时禁用防火墙 sudo ufw disable # 测试完毕后，记得重新启用并配置规则 # sudo ufw enable && sudo ufw allow 22 && sudo ufw allow 7860

2. 确认服务监听地址：确保启动命令中包含了--host 0.0.0.0，而不是127.0.0.1（后者只允许本机访问）。

3. 检查VMware网络设置：确保虚拟机的网络适配器是“已连接”状态。在VMware的虚拟机设置里可以查看。

4. 端口连通性测试：在宿主机上，打开命令行，用telnet或ping测试。

   • ping [虚拟机IP]看网络是否通。
   • 如果ping通但网页打不开，可能是端口没通。可以尝试在虚拟机里用curl localhost:7860看看服务本身是否正常。

5. 查看应用日志：仔细查看启动WebUI时命令行输出的错误信息，通常是依赖库缺失、模型路径错误或者端口被占用。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。