fraudmarc-ce 的安装和配置教程

2025-05-29 21:10:57作者：咎竹峻Karen

1. 项目基础介绍和主要编程语言

Fraudmarc CE（Community Edition）是一个开源的DMARC报告分析工具，专为政府机构设计，但也适用于企业和个人用户。它可以帮助用户分析和理解DMARC聚合报告，从而更好地管理电子邮件安全和认证。该项目使用TypeScript和Go作为主要的编程语言，同时也使用了HTML、SCSS、CSS和JavaScript等辅助性语言。

2. 项目使用的关键技术和框架

Fraudmarc CE 使用了以下关键技术和框架：

AWS Services: 包括Amazon S3、Amazon CloudFront、AWS Lambda、Amazon API Gateway、Amazon RDS、AWS Cognito等，以构建一个完全托管的服务。
AWS CDK (Cloud Development Kit): 用于定义和部署AWS基础设施。
Angular: 用于构建用户界面的前端框架。
TypeScript: 强类型JavaScript超集，用于前端开发。
Go: 用于后端服务的开发，因其性能和并发处理能力而受到青睐。
Docker: 可以用于本地开发环境，以简化依赖管理。

3. 项目安装和配置的准备工作和详细步骤

准备工作

在开始安装之前，请确保您已经完成了以下准备工作：

安装了最新版本的Node.js和npm。
安装了AWS CLI并配置了相应的AWS访问密钥。
确保您的AWS账户中启用了所需的IAM权限和服务。
准备了一个用于Fraudmarc CE的子域名，并在DNS中添加了相应的记录。

安装步骤

以下是将Fraudmarc CE部署到AWS的详细步骤：

克隆仓库

git clone https://github.com/Fraudmarc/fraudmarc-ce.git
cd fraudmarc-ce

安装依赖
```
npm install
```

配置环境变量 在项目根目录下创建一个.env文件，并添加以下内容（替换为您的实际信息）：

REACT_APP_API_URL=https://your-api-url
AWS_REGION=your-aws-region
AWS_ACCESS_KEY_ID=your-access-key-id
AWS_SECRET_ACCESS_KEY=your-secret-access-key

构建前端
```
npm run build
```
部署前端到S3 使用AWS CLI将构建的前端文件上传到S3桶：
```
aws s3 cp dist/ s3://your-bucket-name/ --recursive
```
部署后端 使用AWS CDK或CloudFormation模板来部署后端服务，包括Lambda函数、API Gateway、RDS数据库等。
配置Cognito 在AWS Cognito中设置用户池和身份提供者，以便进行用户认证。
更新DNS记录 在DNS提供商处更新子域名的CNAME记录，指向您的CloudFront分发。
启动服务 使用AWS CLI或AWS Management Console启动所有服务，并确保它们正常运行。
访问应用 在浏览器中访问您的子域名，使用Cognito提供的登录界面进行登录，开始使用Fraudmarc CE。