陌陌风控系统Aswan安装配置指南
aswan 陌陌风控系统静态规则引擎,零基础简易便捷的配置多种复杂规则,实时高效管控用户异常行为。 项目地址: https://gitcode.com/gh_mirrors/as/aswan
项目基础介绍
Aswan 是陌陌开发的一款风控系统静态规则引擎,专为零基础用户设计,旨在提供简易便捷的方式来配置多种复杂的风控规则,实现用户异常行为的实时高效管控。该项目采用Python 3作为主要编程语言,并适用于Python 3.7及以上版本,同时也提供了对Python 2.7的旧版支持(通过特定标签获取)。
关键技术和框架
Aswan利用了以下关键技术与框架:
- Django: 用于构建Web界面和管理后台。
- Redis, MySQL, MongoDB: 分别作为缓存、关系型数据库和非关系型数据库存储数据。
- 自定义规则引擎: 支持灵活配置风险控制规则,如黑名单、白名单、灰名单等管理,以及更复杂的布尔型和时段频控型策略。
- 数据上报机制: 允许应用上报数据给风控引擎,以便基于这些数据做出决策。
安装和配置教程
准备工作
-
安装必要软件:确保本地已安装Git、Docker(可选)、Python 3.7+及pip。
-
获取项目代码:
git clone https://github.com/momosecurity/aswan.git
-
环境变量设置(可选,但推荐):为处理不同环境配置,设置
RISK_ENV=develop
。在测试环境下应设为RISK_ENV=test
。
安装步骤
依赖安装
-
进入项目根目录:
cd aswan
-
安装Python依赖:
pip install -r www/requirements.txt
系统配置
- 根据你的环境调整
config
目录下的配置文件,包括数据库连接、Redis等。 - (可选)如果你不使用Docker,确保MySQL、MongoDB和Redis已正确安装并运行。
数据库准备
- 创建MySQL数据库
risk_control
,参考仓库中的说明。 - 使用Docker快速部署数据库服务(如果选择该方法)。
初始化Django项目
- 在项目
www
目录下执行:python manage.py makemigrations python manage.py migrate
- 创建超级用户:
按提示输入用户名、密码和邮箱。python manage.py createsuperuser
数据源配置
- 根据你的业务需求,在系统中配置数据源,确保数据上报时使用的字段与配置一致。
启动服务
- 不使用Docker的话,通过脚本启动服务:
bash start.sh
- 使用Docker:
- 安装Docker和Docker Compose。
- 在项目根目录执行:
docker-compose -f deploy/docker-compose.yaml up --build
测试与验证
- 可以通过API调用来验证规则引擎是否工作正常,比如使用cURL模拟查询请求:
curl -X POST "127.0.0.1:50000/query/" -H "Content-Type:application/json" -d '{"rule_id": "1", "user_id": "10000"}'
至此,Aswan项目已经安装配置完成,你可以登录管理后台进一步配置规则并监控风险管理情况。记得根据实际情况调整配置和安全设置,确保系统的稳定运行。
aswan 陌陌风控系统静态规则引擎,零基础简易便捷的配置多种复杂规则,实时高效管控用户异常行为。 项目地址: https://gitcode.com/gh_mirrors/as/aswan