ansible-role-spamassassin

用于安装和维护 SpamAssassin 的角色（包括 DKIM、pyzor 和 razor 检查）

角色变量

默认值：

## 一般设置
spamassassin_user: debian-spamd
spamassassin_group: debian-spamd
spamassassin_home_dir: /var/lib/spamassassin
spamassassin_log_dir: /var/log/spamassassin

# 仅在设置为 False 时安装 SpamAssassin 并配置 cronjob
spamassassin_configure: True

## 文件: /etc/default/spamassassin

spamassassin_automatic_rule_update_enabled: true
spamassassin_nice_level: 0

## 文件: /etc/spamassassin/local.cf

# 重写邮件头吗？
spamassassin_rewrite_header_enabled: true
spamassassin_rewrite_header: "主题 *****垃圾邮件*****"

# 允许 0, 1, 2 - 见 https://spamassassin.apache.org/full/3.0.x/dist/doc/Mail_SpamAssassin_Conf.html
spamassassin_report_safe: 0

# 设定被视为垃圾邮件所需的分数
spamassassin_required_score: 5.0

# 是否使用 SpamAssassin 中内置的朴素贝叶斯分类器
spamassassin_use_bayes: 1

# 是否使用基于朴素贝叶斯分类器的规则
spamassassin_bayes_auto_learn: 1

# 您的设置中哪些网络或主机被视为“受信任”
spamassassin_trusted_networks: []

# 允许选项：nfsafe, flock, win32
spamassassin_lock_method: flock

# 如果您收到通过上游邮件系统过滤的邮件，如垃圾邮件过滤的 ISP 或邮件列表，且该服务添加了新头部（大多数服务都会这么做），
# 这些头部可能会给贝叶斯分类器提供不当的提示，允许它“捷径”。为避免这种情况，可以使用此设置列出这些头部。
spamassassin_bayes_ignore_header:
  - X-Bogosity
  - X-Spam-Flag
  - X-Spam-Status

# 手动欢迎列表
# 在 SpamAssassin 4.0.0 中，白名单已更名为欢迎列表，黑名单更名为阻止列表，详情见
# https://cwiki.apache.org/confluence/display/spamassassin/WelcomelistBlocklist
# 角色变量 spamassassin_whitelist 已相应更名为 spamassassin_welcomelist。
# 如果 spamassassin_whitelist 在主机变量中设置且非空，它将与 spamassassin_welcomelist 合并
## 文件: /etc/spamassassin/whitelist.cf 或 /etc/spamassassin/welcomelist.cf
spamassassin_welcomelist: []

# 添加额外的更新渠道，应由每日的 sa-update cronjob 更新。例如：
# spamassassin_additional_update_channels:
#   - address: spamassassin.heinlein-support.de
#     gpg: no
spamassassin_additional_update_channels: []

# 启用额外的 pyzor 检查
spamassassin_pyzor_enabled: False

spamassassin_pyzor_config_dir: /etc/spamassassin/.pyzor

# 启用额外的 razor 检查
spamassassin_razor_enabled: True

spamassassin_razor_config_dir: /etc/spamassassin/.razor

# 启用 monit 监控
spamassassin_monit_enabled: False

# 根据用户和域进行垃圾邮件训练
# spamassassin_spamtraining_users:
#    - domain: myfirstdomain.org
#      users:
#       - admin
#       - foo
#    - domain: myseconddomain.org
#      users:
#       - admina
#       - foobar
spamassassin_spamtraining_users: []

# 设置自定义的 SpamAssassin 分数
# spamassassin_custom_scores:
#    - name: SPF_FAIL
#      score: "0 1.5 0 0.919"
spamassassin_custom_scores: []

# 在 Debian 12/Bookworm 上，此角色默认会安装 'spamd' 和 SpamAssassin
# 在 Debian 11/Bullseye 上，默认不会安装 'spamd'，除非：
#   1. 您的 apt 源中启用了 bullseye-backports 且已安装版本 >=4.0.0-1 的 SpamAssassin
#   2. 您的 apt 源中启用了 bullseye-backports 且将 'spamd' 包添加到 'spamassassin_packages' 变量中
# 请注意，此角色不负责将 bullseye-backports 添加到您的 apt 源中！
spamassassin_packages:
  - spamassassin
  - spamc
  - libmail-spf-perl
  - libmail-dkim-perl
  - procps  # 提供 /bin/kill，实际上应为依赖项

下载

使用 ansible-galaxy 下载最新版本

ansible-galaxy install systemli.spamassassin

示例剧本

- hosts: servers
  roles:
     - { role: systemli.spamassassin }

测试与开发

使用 Molecule、Goss、Docker 和 Github Actions 进行持续测试。 您可以通过以下命令轻松在本地测试角色

molecule test

这需要安装 Molecule、Vagrant 和 python-vagrant。

许可证

GPLv3

作者信息

https://www.systemli.org