# 隐私政策
## 📋 概述
PostfixLogParser 是一个开源的本地日志解析工具。我们深知隐私保护的重要性，本文档说明我们如何处理您的数据和保护您的隐私。
## 🔐 数据处理原则
### 本地处理
- ✅ **100%本地处理**: 所有日志解析都在您的本地设备上进行
- ✅ **无远程传输**: 您的日志数据不会被发送到任何远程服务器
- ✅ **无云存储**: 我们不会将您的数据存储在云端
- ✅ **无第三方分享**: 不会与任何第三方分享您的数据
### 数据访问
- ✅ **仅读取权限**: 工具只读取您指定的日志文件
- ✅ **不修改源文件**: 原始日志文件不会被修改
- ✅ **用户控制**: 您完全控制输入和输出数据
- ✅ **即时处理**: 处理完成后不保留数据在内存中
## 📊 数据类型说明
### 我们处理的数据
1. **Postfix日志文件**: 您提供的邮件服务器日志
2. **解析结果**: 从日志中提取的结构化信息
3. **配置参数**: 您设置的命令行参数
### 我们不收集的数据
- ❌ 个人身份信息
- ❌ 用户行为数据
- ❌ 设备信息
- ❌ 网络信息
- ❌ 使用统计
- ❌ 错误报告（除非您主动提交）
## 🛡️ 技术保护措施
### 内存安全
- **Rust语言**: 基于内存安全的编程语言开发
- **自动清理**: 处理完成后自动清理内存
- **无缓存**: 不会缓存敏感信息
### 文件处理
- **流式处理**: 大文件采用流式处理，降低内存占用
- **临时文件**: 不创建临时文件
- **权限检查**: 遵守系统文件权限设置
### 网络隔离
- **无网络功能**: 工具本身不包含任何网络通信功能
- **离线运行**: 可以在完全离线的环境中使用
- **DNS无关**: 不进行DNS查询或其他网络操作
## 📝 日志脱敏建议
### 生产环境使用
为了进一步保护隐私，建议在处理生产日志前进行脱敏：
1. **IP地址脱敏**
```bash
sed 's/192\.168\.[0-9]\+\.[0-9]\+/10.0.0.X/g' maillog
```
2. **域名脱敏**
```bash
sed 's/yourdomain\.com/example.com/g' maillog
```
3. **邮箱地址脱敏**
```bash
sed 's/[a-zA-Z0-9._-]\+@[a-zA-Z0-9.-]\+/user@example.com/g' maillog
```
### 测试数据建议
- 使用项目提供的示例数据进行测试
- 避免使用包含真实信息的生产日志
- 创建虚拟测试数据集
## 🔄 数据生命周期
### 输入阶段
1. 用户指定要解析的日志文件
2. 工具读取并验证文件格式
3. 开始逐行解析处理
### 处理阶段
1. 解析日志行提取信息
2. 在内存中构建结构化数据
3. 应用解析规则和验证
### 输出阶段
1. 生成JSON格式结果
2. 输出到用户指定位置
3. 清理内存中的数据
### 结束阶段
1. 释放所有占用的系统资源
2. 清理临时变量
3. 程序正常退出
## 📞 隐私相关联系
### 问题报告
如果您对隐私处理有任何疑问：
- 创建GitHub Issue（不包含敏感信息）
- 通过项目维护者联系方式私下联系
### 改进建议
我们欢迎关于隐私保护的改进建议：
- 提交Pull Request
- 创建Feature Request
- 参与项目讨论
## 📜 合规说明
### 开源许可
- 本项目采用MIT/Apache-2.0双重许可
- 源代码完全公开，可审查
- 不存在隐藏的数据收集代码
### 法律合规
- 遵守数据保护相关法律法规
- 支持用户的数据控制权
- 提供透明的数据处理说明
## 🔄 政策更新
### 更新通知
- 重大隐私政策变更会在README中公告
- 建议关注项目Release页面获取更新
- GitHub Watch功能可接收更新通知
### 版本历史
- **v1.0 (2024-12-19)**: 初始隐私政策发布
---
**最后更新**: 2024年12月19日
我们承诺持续改进隐私保护措施，为用户提供安全可信的工具。如有任何隐私相关问题，请随时联系我们。