Twoblade 开源项目最佳实践教程

2025-05-20 06:36:25作者：蔡丛锟

1. 项目介绍

Twoblade 是一个开源项目，它实现了 SHARP（Self-Hosted Address Routing Protocol）协议，这是一种去中心化的电子邮件系统。在 SHARP 中，地址格式采用 user#domain.com 的形式，其中 user 是接收者的用户名，domain.com 是 SHARP 服务器的域名。Twoblade 提供了一个接口和参考实现，允许用户自我托管电子邮件服务，从而增强了隐私和安全性。

2. 项目快速启动

以下步骤将指导你如何快速启动 Twoblade 项目：

安装依赖

首先，确保你的系统中已经安装了 Node.js 和 Docker。

cd SHARP
bun install

初始化数据库

bash database/init.sh

配置环境变量

init.sh 脚本会创建一个 .env 文件，你需要根据提示输入你的域名，并可能需要根据你的实际配置修改 .env 文件，特别是 DATABASE_URL。

# 示例 .env 文件内容
DATABASE_URL=postgres://user:password@host:port/database
SHARP_PORT=5000
HTTP_PORT=5001
DOMAIN_NAME=yourdomain.com

运行服务器

cd ..
bun run .

配置 DNS

在你的 DNS 服务商那里添加 SRV 记录，以便其他 SHARP 用户可以发现你的服务器。

_sharp._tcp.yourdomain.com. 86400 IN SRV 10 0 5000 yourdomain.com.

替换 yourdomain.com 为你的实际域名，并将端口 5000 替换为 .env 文件中 SHARP_PORT 的值。

3. 应用案例和最佳实践

邮件发送

在 Twoblade 系统中，发送邮件的过程涉及构造一个符合 SHARP 协议的邮件，并通过 Twoblade 客户端发送。

// 示例代码：使用 Twoblade 发送邮件
const sharp = require('sharp');
const email = new sharp.Email({
  from: 'user#domain.com',
  to: 'recipient#anotherdomain.com',
  subject: '测试邮件',
  body: '这是一封测试邮件的内容。',
});
email.send();