Dead-Man-Hand 使用教程

1. 项目介绍

Dead-Man-Hand（DMH）是一个隐私保护的“死亡开关”软件。其主要功能是在用户无法再确认其生存状态时，自动执行用户预先设定的行动。DMH 通过加密确保所有行动在用户生存期间保持机密，并且只有在用户被判定为死亡时才会执行这些行动。

DMH 的核心特点包括：

• 隐私保护：即使拥有 DMH 访问权限的人也无法看到行动的详细信息。
• 经过测试：代码覆盖率高，包含单元测试和集成测试。
• 资源占用小：内存占用小于20MB。
• 多种行动执行方法：支持 JSON POST 请求、短信、邮件等方式。
• 多种生存状态检测方法：支持 JSON POST 请求、短信、邮件等方式检测用户生存状态。

2. 项目快速启动

环境准备

确保系统中已安装 Docker，或者安装 Go 语言环境。

使用 Docker 启动

docker run --name dead-man-hand -e DMH_CONFIG_FILE=/data/config.yaml -v /srv/dead-man-hand/data:/data -p 8080:8080 ghcr.io/bkupidura/dead-man-hand:latest

使用源代码编译启动

1. 克隆仓库：

   git clone https://github.com/bkupidura/dead-man-hand.git
   

2. 编译二进制文件：

   cd dead-man-hand && make build
   

3. 运行 DMH：

   DMH_CONFIG_FILE=config.yaml ./dmh
   

3. 应用案例和最佳实践

案例一：自动发送邮件

用户可以设置 DMH 在其无法确认生存状态时，自动向指定的邮箱发送邮件。

{
  "kind": "mail",
  "process_after": 10,
  "comment": "如果10天未确认生存状态，发送邮件",
  "data": {
    "message": "紧急通知：用户可能处于无法响应状态。",
    "destination": ["[e-mail]", "[e-mail]"],
    "subject": "生存状态确认"
  }
}

最佳实践

• 保持 DMH 和 Vault 在不同的服务器上运行，以增强安全性和隐私保护。
• 定期更新行动和生存状态检测方法，以适应不同的使用场景。

4. 典型生态项目

目前，DMH 可以与多种服务配合使用，例如：

• AWS Lambda：可以将 Vault 部署为 AWS Lambda 函数，以提高可伸缩性和降低成本。
• SMTP 服务器：用于发送邮件通知。
• 短信服务提供商：如 BulkSMS，用于发送短信通知。

通过上述教程，您应该能够了解 Dead-Man-Hand 的基本概念，并能够快速启动和配置项目。在实际使用中，请根据具体需求调整配置和应用案例。