ivre/web-uwsgi

uWSGI 部署 IVRE 应用实践

一、部署背景与优势

IVRE 是一款用于网络侦查与信息收集的工具，其 Web 界面需通过应用服务器对外提供服务。uWSGI 作为轻量高效的应用服务器，支持 Python 应用部署，具备资源占用低、并发处理能力强、可与 Nginx 等 Web 服务器协同工作的特点，适合作为 IVRE Web 应用的运行载体。

二、前置条件

在开始前，需确保：

1. IVRE 已完成安装（参考官方文档，确保其 Web 组件 ivre-web 可用）；
2. 服务器已安装 Python 3 环境（IVRE 依赖 Python 3）；
3. 具备 sudo 权限，用于安装软件和配置服务。

三、部署步骤

1. 环境准备：安装 uWSGI 及依赖

uWSGI 需要 Python 插件支持 IVRE 的 WSGI 应用，直接通过系统包管理器安装：

bash
# Debian/Ubuntu 系统  
sudo apt update && sudo apt install -y uwsgi uwsgi-plugin-python3  

# CentOS/RHEL 系统（需先启用 EPEL 源）  
sudo yum install -y uwsgi uwsgi-plugin-python3  

2. 配置 uWSGI：指定 IVRE 应用入口

创建 uWSGI 配置文件（例如 /etc/uwsgi/ivre.ini），内容如下（根据实际路径调整）：

ini
[uwsgi]  
# 应用名称  
appname = ivre  

# IVRE Web 应用的 WSGI 入口文件路径（需根据 IVRE 安装位置调整，以下为默认路径示例）  
wsgi-file = /usr/share/ivre/web/wsgi.py  

# 运行用户（建议使用非 root 用户，如 ivre）  
uid = ivre  
gid = ivre  

# 监听地址与端口（本地回环地址，仅允许 Web 服务器转发）  
socket = 127.0.0.1:3031  

# 进程与线程配置（根据服务器 CPU 核心数调整，例如 4 进程 2 线程）  
processes = 4  
threads = 2  

# 日志配置（便于排错）  
logto = /var/log/uwsgi/ivre.log  
log-maxsize = 50000000  # 日志文件最大 50MB  

注意：若 IVRE 安装在虚拟环境中，需在配置中添加 virtualenv = /path/to/venv 指定环境路径。

3. 配置 Web 服务器：用 Nginx 反向代理（可选但推荐）

uWSGI 通常不直接暴露公网，需通过 Nginx 接收客户端请求并转发。安装 Nginx 后，创建配置文件 /etc/nginx/sites-available/ivre：

nginx
server {  
    listen 80;  # 可改为 443 并配置 SSL  
    server_name ivre.example.com;  # 替换为实际域名或服务器 IP  

    # 静态文件处理（IVRE 的 CSS/JS 等，路径需与 IVRE 安装目录对应）  
    location /static/ {  
        alias /usr/share/ivre/web/static/;  
        expires 30d;  
    }  

    # 反向代理到 uWSGI  
    location / {  
        include uwsgi_params;  
        uwsgi_pass 127.0.0.1:3031;  # 需与 uWSGI 配置中的 socket 一致  
        uwsgi_read_timeout 300;  # 长连接超时时间  
    }  
}  

启用站点并重启 Nginx：

bash
sudo ln -s /etc/nginx/sites-available/ivre /etc/nginx/sites-enabled/  
sudo nginx -t  # 检查配置是否有误  
sudo systemctl restart nginx  

4. 服务化管理：用 systemd 保障运行

为避免手动启动 uWSGI，创建 systemd 服务文件 /etc/systemd/system/ivre-uwsgi.service：

ini
[Unit]  
Description=uWSGI service for IVRE Web application  
After=network.target  

[Service]  
User=root  # 需有权限读取配置文件和 IVRE 目录  
ExecStart=/usr/bin/uwsgi --ini /etc/uwsgi/ivre.ini  
Restart=always  # 进程异常时自动重启  
RestartSec=5  

[Install]  
WantedBy=multi-user.target  

启动并设置开机自启：

bash
sudo systemctl daemon-reload  
sudo systemctl start ivre-uwsgi  
sudo systemctl enable ivre-uwsgi  

5. 验证部署

1. 访问 Nginx 配置的地址（如 `[***] 或服务器 IP），若能加载 IVRE Web 界面，说明部署成功；
2. 检查日志排查问题：
   • uWSGI 日志：tail -f /var/log/uwsgi/ivre.log
   • Nginx 日志：tail -f /var/log/nginx/access.log 或 error.log

四、注意事项

1. 路径适配：IVRE 的 WSGI 入口文件和静态文件路径需根据实际安装位置调整（可通过 dpkg -L ivre-web 或 rpm -ql ivre-web 查看）；
2. 权限问题：确保 uWSGI 运行用户（如 ivre）对 IVRE 目录、日志目录有读/写权限；
3. 性能调优：根据服务器配置调整 uWSGI 的 processes 和 threads 参数，避免资源浪费或过载；
4. 安全加固：建议启用 Nginx SSL（Let’s Encrypt 免费证书），并限制 Web 访问来源（如通过 allow/deny 指令）。