Laravel Surveillance 使用教程

项目介绍

Laravel Surveillance 是一个用于监控恶意用户 IP 地址和匿名浏览器指纹的 Laravel 包。它可以记录这些用户访问的 URL，并阻止恶意用户访问 Laravel 应用。该包支持扩展存储技术，但默认不提供客户端浏览器指纹库。推荐使用 FingerprintJS Open Source 作为客户端浏览器指纹库。

项目快速启动

安装

1. 通过 Composer 安装包：

   composer require neelkanthk/laravel-surveillance
   

2. 发布迁移文件：

   php artisan vendor:publish --provider="Neelkanth\Laravel\Surveillance\Providers\SurveillanceServiceProvider" --tag="migrations"
   

3. 发布语言文件：

   php artisan vendor:publish --provider="Neelkanth\Laravel\Surveillance\Providers\SurveillanceServiceProvider" --tag="lang"
   

配置

在 config/surveillance.php 中配置相关参数，如存储库和管理器：

return [
    "manager-repository" => 'Neelkanth\Laravel\Surveillance\Implementations\SurveillanceManagerRepository',
    "log-repository" => 'Neelkanth\Laravel\Surveillance\Implementations\SurveillanceLogRepository',
    "allowed-types" => ["userid", "ip", "fingerprint"]
];

启用和禁用监控

• 启用 IP 地址监控：

  php artisan surveillance:enable ip 192.1.2.4
  

• 禁用 IP 地址监控：

  php artisan surveillance:disable ip 192.1.2.4
  

• 启用用户 ID 监控：

  php artisan surveillance:enable userid 1234
  

• 禁用用户 ID 监控：

  php artisan surveillance:disable userid 1234
  

应用案例和最佳实践

应用案例

• 电子商务网站：监控和阻止恶意用户尝试多次登录失败或尝试访问受限页面。
• 论坛和社区：防止恶意用户发布垃圾信息或进行恶意操作。

最佳实践

• 集成 FingerprintJS：使用 FingerprintJS 进行客户端浏览器指纹识别，提高监控准确性。
• 定期审计日志：定期检查和分析监控日志，及时发现和处理异常行为。

典型生态项目

• Laravel Surveillance UI：提供图形化界面，方便管理和监控 Laravel Surveillance。
• FingerprintJS Open Source：用于客户端浏览器指纹识别的开源库。

通过以上步骤和实践，您可以有效地使用 Laravel Surveillance 监控和管理您的 Laravel 应用，确保应用的安全性和稳定性。