《Dead-Man-Hand 项目安装与配置指南》

Dead-Man-Hand（DMH）是一个旨在执行预设动作的隐私保护软件。当用户无法确认其状态时，DMH 将按照预设的行动执行任务。本项目主要使用 Go 编程语言开发。

一、项目基础介绍

DMH 的核心功能是存储加密的动作（例如发送短信、邮件、HTTP 请求等），并在用户无法响应“生命体征”检查时执行这些动作。所有动作都经过加密，确保即使在 DMH 被访问的情况下，也无法获取动作详情。

主要编程语言：

• Go

二、项目使用的关键技术和框架

• 加密技术：使用 age 加密动作，确保安全性。
• HTTP API：提供 API 接口进行交互。
• 插件系统：支持多种执行动作的插件，如发送短信、邮件、HTTP 请求等。

三、项目安装和配置准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

• Go (版本 1.18 或更高)
• Docker (推荐，但非必须)
• git

安装步骤：

1. 克隆项目

首先，使用 git 命令克隆项目到本地：

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

2. 配置项目

进入项目目录，创建一个配置文件 config.yaml。以下是一个基本的配置文件示例：

components:
  - dmh

dmh:
  state:
    file: state.json

alive:
  - since_last_seen: 23
    min_interval: 12
    kind: mail
    data:
      message: "Are you still alive? Please confirm by clicking https://dmh-domain:8080/api/alive"
      subject: "Still ok?"
      destination:
        - [e-mail]
  - since_last_seen: 36
    min_interval: 24
    kind: bulksms
    data:
      message: "Are you ok? Please click https://dmh-domain:8080/api/alive"
      destination:
        - [phone]
        - [phone]

execute:
  plugin:
    bulksms:
      routing_group: premium
      token:
        id: "auth-token-id"
        secret: "auth-token-secret"
    mail:
      username: "username"
      password: "password"
      server: "smtp.server.com"
      from: "[e-mail]"
      tls_policy: "tls_mandatory"

请根据您的实际情况修改配置文件。

3. 构建项目

使用 Makefile 构建项目：

make build

4. 运行项目

运行构建后的二进制文件：

DMH_CONFIG_FILE=config.yaml ./dmh

如果使用 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

确保在运行前已正确配置好 Docker。

以上就是 Dead-Man-Hand 项目的详细安装和配置指南。按照上述步骤操作，您应该能够成功安装和运行该项目。