MogFace人脸检测模型-WebUI环境部署：CentOS/Ubuntu下服务启停与日志排查

MogFace人脸检测模型-WebUI环境部署：CentOS/Ubuntu下服务启停与日志排查

1. 环境准备与快速部署

MogFace作为CVPR 2022提出的人脸检测模型，基于ResNet101骨干网络，在复杂场景下仍能保持高精度检测能力。无论是侧脸、戴口罩还是光线不足的情况，都能准确识别并框出人脸位置。

1.1 系统要求与依赖安装

在开始部署前，请确保你的系统满足以下要求：

最低配置要求：

• 操作系统：CentOS 7+ 或 Ubuntu 18.04+
• 内存：2GB RAM
• 存储：10GB可用空间
• Python：3.8及以上版本

推荐配置：

• 操作系统：CentOS 8 或 Ubuntu 20.04+
• 内存：4GB RAM或更高
• CPU：4核及以上
• GPU：可选，可加速推理过程

安装必要的系统依赖：

# CentOS系统 yum update -y yum install -y python3 python3-pip git wget # Ubuntu系统 apt update && apt upgrade -y apt install -y python3 python3-pip git wget 

1.2 项目获取与环境配置

获取MogFace人脸检测项目代码：

cd /root git clone https://github.com/your-repo/cv_resnet101_face-detection_cvpr22papermogface.git cd cv_resnet101_face-detection_cvpr22papermogface 

创建Python虚拟环境并安装依赖：

python3 -m venv mogface_env source mogface_env/bin/activate pip install -r requirements.txt 

2. 服务启动与停止管理

2.1 使用服务控制脚本

项目提供了便捷的服务管理脚本，位于scripts/service_ctl.sh：

# 查看脚本帮助信息 cd /root/cv_resnet101_face-detection_cvpr22papermogface ./scripts/service_ctl.sh --help 

2.2 服务启动操作

启动WebUI服务和API服务：

# 启动所有服务 ./scripts/service_ctl.sh start # 或者分别启动特定服务 ./scripts/service_ctl.sh start webui # 仅启动Web界面（端口7860） ./scripts/service_ctl.sh start api # 仅启动API服务（端口8080） 

服务成功启动后，你会看到类似输出：

[INFO] 启动WebUI服务... [INFO] WebUI服务已启动，访问地址: http://服务器IP:7860 [INFO] API服务已启动，访问地址: http://服务器IP:8080 

2.3 服务停止与重启

日常运维中的常用命令：

# 停止所有服务 ./scripts/service_ctl.sh stop # 重启服务（常用干配置更新后） ./scripts/service_ctl.sh restart # 查看服务状态 ./scripts/service_ctl.sh status 

3. 服务访问与验证

3.1 Web界面访问

服务启动成功后，通过浏览器访问Web界面：

http://你的服务器IP地址:7860 

首次访问验证步骤：

1. 在页面中上传测试图片
2. 点击"开始检测"按钮
3. 观察右侧是否显示检测结果
4. 确认人脸框和关键点显示正常

3.2 API接口验证

通过curl命令测试API服务是否正常：

# 健康检查 curl http://localhost:8080/health # 预期返回结果 { "status": "ok", "service": "face_detection_service", "detector_loaded": true } 

4. 日志排查与故障处理

4.1 日志文件位置与查看

MogFace服务生成多种日志文件，用于不同目的的排查：

主要日志文件：

• WebUI服务日志：logs/webui.log
• API服务日志：logs/api.log
• 错误日志：logs/error.log
• 系统日志：logs/system.log

查看日志的常用命令：

# 查看WebUI实时日志 ./scripts/service_ctl.sh logs webui-follow # 查看最近100行API日志 ./scripts/service_ctl.sh logs api | tail -100 # 查看错误日志 tail -f logs/error.log # 根据时间筛选日志 grep "2024-01-" logs/webui.log | head -50 

4.2 常见问题排查指南

问题1：端口占用导致服务启动失败

症状：服务启动时报错"Address already in use"

解决方法：

# 查找占用端口的进程 lsof -i :7860 lsof -i :8080 # 终止占用进程 kill -9 <进程ID> # 或者修改服务端口 vim config/service_config.yaml # 修改port字段后重启服务 

问题2：依赖包缺失或版本冲突

症状：ImportError或ModuleNotFoundError

解决方法：

# 重新安装依赖 pip install --force-reinstall -r requirements.txt # 检查Python版本 python3 --version # 创建新的虚拟环境 deactivate rm -rf mogface_env python3 -m venv mogface_env source mogface_env/bin/activate pip install -r requirements.txt 

问题3：模型加载失败

症状：日志中出现"Model loading failed"或"Weight file not found"

解决方法：

# 检查模型文件是否存在 ls -la models/ # 重新下载模型权重 python scripts/download_weights.py # 检查磁盘空间 df -h 

问题4：内存不足导致服务崩溃

症状：服务运行一段时间后自动停止，日志显示Killed

解决方法：

# 查看内存使用情况 free -h # 调整服务配置，减少内存使用 vim config/model_config.yaml # 调整batch_size或启用内存优化选项 

4.3 性能监控与优化

监控服务运行状态：

# 实时监控CPU和内存使用 top -p $(pgrep -f "python.*mogface") # 查看服务响应时间 grep "inference_time" logs/api.log | tail -10 # 监控网络连接 netstat -tulpn | grep :7860 netstat -tulpn | grep :8080 

5. 生产环境部署建议

5.1 系统优化配置

对于CentOS/Ubuntu生产环境：

# 调整系统文件描述符限制 echo "* soft nofile 65535" >> /etc/security/limits.conf echo "* hard nofile 65535" >> /etc/security/limits.conf # 优化网络参数 echo "net.core.somaxconn = 1024" >> /etc/sysctl.conf echo "net.ipv4.tcp_max_syn_backlog = 2048" >> /etc/sysctl.conf sysctl -p 

5.2 服务自启动配置

配置系统服务实现开机自启动：

创建systemd服务文件：

# CentOS/Ubuntu通用 vim /etc/systemd/system/mogface.service 

添加以下内容：

[Unit] Description=MogFace Face Detection Service After=network.target [Service] Type=simple User=root WorkingDirectory=/root/cv_resnet101_face-detection_cvpr22papermogface Environment=PATH=/root/cv_resnet101_face-detection_cvpr22papermogface/mogface_env/bin ExecStart=/root/cv_resnet101_face-detection_cvpr22papermogface/scripts/service_ctl.sh start ExecStop=/root/cv_resnet101_face-detection_cvpr22papermogface/scripts/service_ctl.sh stop Restart=always RestartSec=10 [Install] WantedBy=multi-user.target 

启用并启动服务：

systemctl daemon-reload systemctl enable mogface systemctl start mogface systemctl status mogface 

5.3 安全加固措施

防火墙配置：

# 开放必要端口 firewall-cmd --permanent --add-port=7860/tcp firewall-cmd --permanent --add-port=8080/tcp firewall-cmd --reload # 或者限制访问IP firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.1.0/24" port port="7860" protocol="tcp" accept' 

6. 总结

通过本文的详细指导，你应该已经成功在CentOS或Ubuntu系统上部署了MogFace人脸检测模型的WebUI服务，并掌握了服务的启停管理和日志排查技巧。

关键要点回顾：

1. 环境配置：确保系统满足要求，正确安装Python依赖
2. 服务管理：使用提供的脚本轻松启动、停止和重启服务
3. 日志排查：通过查看日志文件快速定位和解决问题
4. 生产部署：配置系统服务和安全设置确保稳定运行

遇到问题时：

• 首先检查日志文件获取详细错误信息
• 确认端口没有被其他程序占用
• 验证依赖包版本是否兼容
• 检查系统资源（内存、磁盘空间）是否充足

MogFace人脸检测服务部署完成后，你可以通过Web界面直观地上传图片进行人脸检测，也可以通过API接口将检测能力集成到自己的应用中。该服务在各种复杂场景下都能提供准确的人脸检测结果，为后续的人脸识别、人脸美化等应用提供可靠的基础能力。

获取更多AI镜像

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