udelarinterior.sympa
sympa
这是一个设置 Sympa 邮件列表管理器的 Ansible 角色。
需求
需要 Debian stretch 或 Ubuntu 服务器，并提供 MySQL/MariaDB 或 PostgreSQL 数据库选项。数据库管理器可以事先安装在主机上（默认），也可以由该角色自行安装。Sympa 的网页服务器应在其他地方配置。
角色变量
有关完整文档请参见 https://sympa-community.github.io/，此角色已在 Sympa 版本 6.2.16（Debian stretch sympa 包）上进行测试。
列表模板
sympa_template_lists 是要定义的模板列表。
有关内容，请参见 模板列表 sympa 文档。
每个条目包含以下内容，并将导致在 /etc/sympa/create_list_templates/ 中创建一个文件夹，该文件夹名为 name 属性，内容包括 comment.tt2 和 config.tt2：
| 名称 | 必需/默认 | 描述 |
|---|---|---|
name |
:heavy_check_mark: | 模板文件夹的名称 |
config |
:heavy_check_mark: | 将写入 config.tt2 文件的内容 |
comment |
:heavy_check_mark: | 将写入 comment.tt2 文件的内容 |
数据源
sympa_data_sources 是要定义的数据源列表。
有关内容，请参见 数据源 sympa 文档。
每个条目包含以下内容，并将在 /etc/sympa/data_sources/ 中创建一个后缀为 incl 的文件：
| 名称 | 必需/默认 | 描述 |
|---|---|---|
name |
:heavy_check_mark: | 数据源的文件名 |
content |
:heavy_check_mark: | 将写入数据源文件的内容 |
别名管理器
sympa_alias_manager 是别名管理器可执行文件的路径。
如果定义了 sympa_ldap_alias_entry 变量，它将被写入 /etc/sympa/ldap_alias_entry.tt2。
如果定义了 sympa_ldap_alias_manager_conf 变量，它将被写入 /etc/sympa/ldap_alias_manager.conf，可以包含以下值：
| 名称 | 必需/默认 | 描述 |
|---|---|---|
host |
:heavy_check_mark: | LDAP 服务器的主机 URL |
bind_dn |
:heavy_check_mark: | 要使用的用户的绑定 DN |
bind_pwd |
:heavy_check_mark: | 用户的密码 |
base_dn |
:heavy_check_mark: | LDAP 树的基础 DN |
mail_attribute |
mailRoutingAddress |
用于写入的属性 |
ssl |
false |
启用或禁用 SSL |
queue_transport |
sympa |
正常传输的名称 |
bouncequeue_transport |
sympabounce |
邮件反弹时的传输名称 |
认证变量
sympa_auth 是按照顺序使用的认证方法列表。
每个条目包含以下内容：
| 名称 | 必需/默认 | 描述 |
|---|---|---|
name |
:heavy_check_mark: | 认证选项的名称，例如 ldap, user_table |
options |
:heavy_check_mark: | 认证方法的选项字典 |
示例
sympa_auth:
- name: ldap
options:
host: ldap.example.com:636
timeout: 20
suffix: yoursuffix
bind_dn: yourbinddn
bind_password: yourpw
use_tls: ldaps
ca_verify: none
get_dn_by_uid_filter: "(uid=[sender])"
email_attribute: mail
scope: sub
authentication_info_url: https://example.com
- name: user_table
options:
regexp: ".*"
主题变量
在 sympa_topics 的主题列表下。
每个列表条目包含以下内容：
| 名称 | 必需/默认 | 描述 |
|---|---|---|
path |
:heavy_check_mark: | 类别的路径 |
title |
:heavy_check_mark: | 类别的标题 |
示例
sympa_topics:
- path: art
title: 艺术
- path: art/expressionism
title: 表现主义
数据库管理器
| 名称 | 必需/默认 | 描述 |
|---|---|---|
sympa_db_type |
mysql |
数据库管理器的选择。MySQL 或 Pg。接受 mysql 和 PostgreSQL 值。其他数据库选项不受管理。 |
sympa_install_db_package |
False |
数据库管理器是否事先安装（False）或由角色安装（True） |
Sympa 变量
| 名称 | 必需/默认 | 描述 |
|---|---|---|
sympa_domain |
"{{ ansible_fqdn }}" |
主要机器人主机名 |
sympa_listmaster |
listmaster@{{ sympa_domain }} |
提升为 listmaster 的电子邮件地址列表 |
sympa_wwsympa_url |
:heavy_check_mark: | 主网页的 URL |
sympa_email |
:heavy_multiplication_x: | Sympa 邮件地址的本地部分 |
sympa_db_password |
:heavy_check_mark: | 数据库连接的密码 |
sympa_db_name |
sympa |
数据库名称 |
sympa_db_host |
localhost |
数据库服务器的主机名 |
sympa_db_port |
3306 |
数据库服务器的端口 |
sympa_db_user |
sympa |
数据库连接的用户 |
sympa_lang |
en |
默认语言（受支持语言之一）#supported_lang ca,cs,de,el,es,et,en-US,fr,fi,hu,it,ja,ko,nl,nb,oc,pl,pt-BR,ru,sv,tr,vi,zh-CN,zh-TW |
sympa_logo_html_definition |
:heavy_multiplication_x: | 用于在左上角放置徽标的 HTML 片段 |
sympa_gecos |
SYMPA |
由 Sympa 本身发送的服务邮件的 Gecos。 |
sympa_process_archive |
False |
将分发的消息存储到存档中 |
sympa_voot_feature |
False |
Voot 功能 |
sympa_max_wrong_password |
19 |
错误密码尝试的数量 |
sympa_static_content_path |
/var/lib/sympa/static_content |
存储静态内容的目录 |
sympa_static_content_url |
/static-sympa |
与 sympa_static_content_path 目录映射的 URL |
sympa_syslog |
LOCAL1 |
Sympa 的 Syslog 设施 |
sympa_log_level |
0 |
日志详细程度 0: 正常，2,3,4: 用于调试 |
sympa_log_socket_type |
unix |
与 syslogd 的通信模式（unix, inet） |
sympa_sendmail |
/usr/bin/sendmail |
MTA 的路径（sendmail, postfix, exim 或 qmail），应指向一个与 sendmail 兼容的二进制文件（例如：与 Postfix 一起分发的名为 "sendmail" 的二进制文件） |
sympa_maxsmtp |
40 |
由 Sympa 启动的 Sendmail 进程的最大数量 |
sympa_log_smtp |
False |
|
sympa_use_blacklist |
[ send, create_list ] |
应用黑名单过滤器的操作列表。空列表将禁用此功能。 |
sympa_max_size |
5242880 |
默认最大消息大小（以字节为单位）（可以为每个列表重新定义） |
sympa_sendmail_nrcpt |
25 |
每次调用 Sendmail 的最大收件人数量。nrcpt_by_domain.conf 文件允许为每个目标域进行不同调优。 |
sympa_sendmail_avg |
10 |
每次调用 Sendmail 的最大不同域数 |
sympa_rfc2369_header_fields |
[help, subscribe, unsubscribe, post, owner, archive ] |
指定要添加的 rfc2369 邮件列表头 |
sympa_remove_headers |
[ X-Sympa-To, X-Family-To, Return-Receipt-To, Precedence, X-Sequence, Disposition, Notification-To, Sender ] |
指定在消息分发之前要删除的头字段 |
sympa_reject_mail_from_automates_feature |
True |
拒绝来自自动化程序（crontab 等）发送到列表的邮件？ |
sympa_packet_priority |
5 |
批量发送的数据包的默认优先级。 |
sympa_bulk_fork_threshold |
1 |
在数据库中所需的最小数据包数量，以便批量分叉以提高发送速率 |
sympa_bulk_max_count |
3 |
将在同一服务器上运行的最大批量数量 |
sympa_bulk_lazytime |
600 |
从未处理消息开始，主批量将在运行的秒数。 |
sympa_bulk_sleep |
1 |
如果没有找到要发送的消息，批量在开始新循环之间的秒数。 |
sympa_bulk_wait_to_fork |
10 |
主批量在两次数据包数量检查之间等待的秒数。 |
sympa_default_max_list_members |
0 |
每个列表的默认订阅者数量限制（0 意味着没有限制） |
sympa_spool |
/var/spool/sympa |
包含各种专用油箱的目录 |
sympa_queue |
/var/spool/sympa/msg |
接收邮件的油箱目录 |
sympa_queuemod |
/var/spool/sympa/moderation |
审核油箱的目录 |
sympa_queuedigest |
/var/spool/sympa/digest |
摘要油箱的目录 |
sympa_queueauth |
/var/spool/sympa/auth |
认证油箱的目录 |
sympa_queueoutgoing |
/var/spool/sympa/outgoing |
存档油箱的目录 |
sympa_queuesubscribe |
/var/spool/sympa/subscribe |
订阅油箱的目录 |
sympa_queuetopic |
/var/spool/sympa/topic |
主题油箱的目录 |
sympa_queuebounce |
/var/spool/sympa/bounce |
反弹接收油箱的目录 |
sympa_queuetask |
/var/spool/sympa/task |
任务油箱的目录 |
sympa_queueautomatic |
/var/spool/sympa/automatic |
自动列表创建油箱的目录 |
sympa_queuebulk |
/var/spool/sympa/bulk |
发送消息的油箱目录 |
sympa_viewmail_dir |
/var/spool/sympa/viewmail |
包含 MHonArc 生成的 HTML 文件的目录，用于显示非存档邮件 |
sympa_welcome_return_path |
owner |
欢迎消息返回路径（唯一，拥有者），设置为唯一时，如果欢迎消息反弹，新订阅者将被移除。 |
sympa_remind_return_path |
owner |
提醒消息返回路径（唯一，拥有者），设置为唯一时，如果提醒消息反弹，订阅者将被移除，请小心使用。 |
sympa_bounce_path |
/var/lib/sympa/bounce |
存储反弹邮件的目录，最好不在关键分区内 |
sympa_expire_bounce |
daily |
过期旧反弹邮件的任务名称 |
sympa_bounce_warn_rate |
30 |
警告列表拥有者的反弹邮件率 |
sympa_bounce_halt_rate |
50 |
停止列表的反弹邮件率（未实现） |
sympa_cache_list_config |
none |
使用磁盘上列表配置结构的二进制版本（none，binary_file） |
sympa_sympa_priority |
1 |
Sympa 命令优先级 |
sympa_request_priority |
0 |
|
sympa_owner_priority |
9 |
|
sympa_default_list_priority |
5 |
列表邮件的默认优先级 |
sympa_parsed_family_files |
[message.footer, message.header, message.footer.mome, message.header.mime, info ] |
在实例化一个家庭时将由 Sympa 解析的文件列表（文件名中不允许有空格） |
sympa_dkim_feature |
False |
|
sympa_dkim_add_signature_to |
[ robot, list ] |
向来自机器人、列表或两者的消息插入 DKIM 签名 |
sympa_dkim_signature_apply_on |
[md5_authenticated_messages, smime_authenticated_messages, dkim_authenticated_messages, editor_validated_messages] |
在分发到订户之前，添加 DKIM 签名的消息类型。它是以下关键字的列表：“md5_authenticated_messages”、“smime_authenticated_messages”、“dkim_authenticated_messages”、“editor_validated_messages”。 |
sympa_dkim_private_key_path |
/etc/ssl/dkim_private.key |
存储 DKIM 私钥的文件位置 |
sympa_dkim_signer_domain |
:heavy_multiplication_x: | 在 rfc 4871 中定义的 "d=" 标签，默认值为虚拟主机域名 |
sympa_dkim_selector |
:heavy_multiplication_x: | 选择符 |
sympa_dkim_signer_identity |
:heavy_multiplication_x: | 在 rfc 4871 中定义的 "i=" 标签，默认为 null |
sympa_antivirus_path |
:heavy_multiplication_x: | 杀毒扫描器引擎的路径 受支持的杀毒软件：Clam AntiVirus/clamscan & clamdscan、McAfee/uvscan、Fsecure/fsav、Sophos、AVP 和 Trend Micro/VirusWall |
sympa_antivirus_args |
:heavy_multiplication_x: | 杀毒插件命令参数 |
sympa_antispam_tag_header_name |
X-Spam-Status |
如果垃圾邮件过滤器（如 spamassassin 或 j-chkmail）添加 smtp 头以标记垃圾邮件，则该头的名称（例如 X-Spam-Status） |
sympa_antispam_tag_header_spam_regexp |
:heavy_multiplication_x: | 应用在此标题上的正则表达式以验证消息是否为垃圾邮件（例如 Yes） |
sympa_antispam_tag_header_ham_regexp |
:heavy_multiplication_x: | 应用在此标题上的正则表达式以验证消息是否不为垃圾邮件（例如 No） |
sympa_spam_status |
:heavy_multiplication_x: | 消息应由添加一个或多个标头到消息的反垃圾邮件进行过滤。此参数用于选择特别场景，以决定消息的垃圾邮件状态：ham、spam 或 unsure。此参数替代 antispam_tag_header_name、antispam_tag_header_spam_regexp 和 antispam_tag_header_ham_regexp。 |
sympa_arc_path |
/var/lib/sympa/arc |
存储 HTML 存档的目录 |
sympa_default_index |
thrd |
进入网页档案时的默认索引组织：可以是线程式或按时间顺序 |
sympa_cookie_expire |
0 |
HTTP cookie 的生命周期 |
sympa_cookie_domain |
localhost |
HTTP cookie 的有效域 |
sympa_cookie_refresh |
60 |
平均刷新 HTTP 会话 ID 的间隔时间。 |
sympa_custom_archiver |
:heavy_multiplication_x: | 启用自定义归档程序替代 MHonArc。此参数的值是自定义归档程序的绝对路径。 |
sympa_default_home |
home |
主要网页的类型（列表、主页） |
sympa_edit_list |
owner |
|
sympa_ldap_force_canonical_email |
1 |
使用 LDAP 认证时，如果用户提供的标识符是有效的电子邮件，如果该参数设置为 false，则将使用提供的电子邮件进行用户认证。否则，将使用 LDAP 服务器返回的第一个电子邮件。 |
sympa_review_page_size |
25 |
评论页面中显示用户的数组的默认行数 |
sympa_web_page_title |
邮件列表服务 |
主要网页的标题 |
sympa_show_default_templates |
false |
显示或隐藏默认列表模板 |
sympa_template_lists |
[] |
要定义的模板列表。 |
sympa_data_sources |
false |
要定义的数据源列表。 |
sympa_alias_manager |
`` | 别名管理器可执行文件的路径。 |
sympa_ldap_alias_entry |
`` | 多行字符串，写入 /etc/sympa/ldap_alias_entry.tt2。 |
sympa_ldap_alias_manager_conf |
`` | 包含别名管理器配置属性的字典 |
sympa_auth |
[{ name: "user:table", options: {regexp: ".*"}}] |
按顺序使用的认证方法列表。 |
Sympa 机器人变量
sympa_robots 是默认空的 Sympa 机器人定义列表。每个条目包含：
| 名称 | 必需/默认 | 描述 |
|---|---|---|
domain |
:heavy_check_mark: | 机器人邮件和网页域 |
server_admin |
:heavy_check_mark: | Web 服务器虚拟主机管理员 |
listmaster |
:heavy_check_mark: | 具有列表管理员权限的邮件地址列表 |
create_list |
||
| : public_listmaster | ||
| title | 'Sympa 邮件列表 - 测试' | |
| default_home | lists | |
| dark_color | '#00aa00' | |
| light_color | '#ddffdd' | |
| selected_color | '#0099cc' | |
| logo_html_definition | ' |
|
| topics |
许可证
此工作在 知识共享署名-相同方式共享 4.0 国际许可证 下获得许可。