#scripting-language #vsmtp #scripting #rhai

vsmtp-plugin-vsl

为vSMTP提供的Rhai(ViridIT脚本语言)超集

27个版本 (6个稳定版)

2.2.1 2023年3月31日
2.2.0 2023年3月19日
2.1.1 2023年2月10日
2.0.1-rc.42023年1月31日
1.4.0-rc.22022年11月30日

#10 in #vsmtp

Download history 188/week @ 2024-04-20 16/week @ 2024-04-27 9/week @ 2024-05-04 13/week @ 2024-05-11 7/week @ 2024-05-18 17/week @ 2024-05-25 22/week @ 2024-06-01 10/week @ 2024-06-08 10/week @ 2024-06-15 16/week @ 2024-06-22 10/week @ 2024-06-29 115/week @ 2024-07-06 20/week @ 2024-07-13 5/week @ 2024-07-20 23/week @ 2024-07-27 6/week @ 2024-08-03

每月54次下载
8个crate(3个直接)中使用

GPL-3.0-only

190KB
3K SLoC


⚠️ 从vSMTP 2.1.1到2.2的破坏性更改

请注意,在vSMTP的2.1.1和2.2版本之间,vsl中引入了一些破坏性API更改。有关详细信息,请参阅变更日志

什么是vSMTP?

vSMTP是一个下一代邮件传输代理 (MTA),速度快、安全且环保。

  • 它是100%用Rust编写的。
  • 它速度极快。
  • 它模块化且高度可定制。
  • 它有一个完整的过滤系统。
  • 它正在积极开发和维护。

更快、更安全、更环保

随着优化IT资源成为日益严峻的挑战,计算机攻击仍然是一个持续的问题。

每天,世界上有超过3000亿封电子邮件被发送和接收。数十亿个附件被处理、分析和投递,这导致温室气体排放的增加。

为了应对这些挑战,viridIT正在开发一种新的电子邮件网关技术,也称为vSMTP。

请关注我们的viridit.com

过滤

vSMTP允许您使用基于RhaivSMTP脚本语言(vsl)创建复杂的规则集来过滤您的电子邮件。您可以使用以下方式

  • 检查/修改传入电子邮件的内容。
  • 转发和本地或远程投递电子邮件。
  • 连接到数据库。
  • 运行命令。
  • 隔离电子邮件。

等等。

// -- /etc/vsmtp/service/database.vsl

// vSMTP can be extended with plugins.
import "plugins/vsmtp_plugin_mysql" as mysql;

// Here we declare a service.
// Let's connect to a mysql database.
export const database = mysql::connect(#{
    // the url to connect to the database.
    url: "mysql://127.0.0.1/?user=greylist-manager&password=my-password"",
    timeout: "30s",
    connections: 4,
});
// -- /etc/vsmtp/filter.vsl
// Here we declare our rules for filtering.

import "service/database" as db;

#{
  // hook on the 'mail from' stage. (when the server receives the `MAIL FROM:` command)
  mail: [
    rule "greylist" || {
      let sender = ctx::mail_from();

      // is the user in our greylist ?
      // (don't forget to sanitize your inputs to prevent SQL injection)
      if db::greylist.query(`SELECT * FROM greylist.sender WHERE address = '${sender}';`).is_empty() {
        // it does not, we add the address to the database, then deny the email.
        db::greylist.query(`
            INSERT INTO greylist.sender (user, domain, address)
            values ("${sender.local_part}", "${sender.domain}", "${sender}");
        `);
        // close the connection with a built in "451 - 4.7.1" error code.
        state::deny(code::c451_7_1())
      } else {
        // it is, we accept the email.
        state::accept()
      }
    }
  ],
}

请查看过滤章节vSL参考,以了解您可以使用vSL做什么。

插件

vSMTP可以通过插件进行扩展。以下是一些已经可用的插件

请查看插件章节以获取更多详细信息。

基准测试

Postfix 3.6.4与vSMTP 1.0.1的性能比较,在运行AMD Ryzen 5 5600X 6核心处理器的Ubuntu 22.04 LTS上进行。

查看"hold"基准测试说明以复现上述示例,以及基准测试说明以尝试其他基准测试。

文档

在这个存储库中,"develop"分支是我们每天开发新功能的工作分支。如果您想查看最新vSMTP版本的示例,请切换到"main"分支,我们最新的发布版本都在那里。

有关文档,请参阅我们的书籍,名为vBook,是vSMTP的在线参考和用户指南。"develop"分支的文档也可在书籍https://vsmtp.rs/next中找到。

想保持最新动态,提问并获得深入答案,请免费加入我们的Discord服务器。您也可以打开GitHub 讨论

路线图

您可以在里程碑路线图部分找到更多关于项目议程的信息。

您可以在变更日志中查看更新。

贡献

关于如何贡献给vSMTP的指南可在贡献部分找到。

商业

我们可以提供从设计到物理实施的一系列服务,提供维护并开发特定的功能和专用的API以满足您的业务需求。

有关商业、许可等问题,您可以通过我们的网站联系我们或向contact@viridit.com发送消息。

许可

vSMTP的标准版是免费的,并遵循开源许可。

它按常规提供,不提供任何保证。请参阅许可以获取更多信息。

依赖

~36–68MB
~1M SLoC