Ansible角色 - Proxmox邮件网关

用于在Linux服务器上部署Proxmox邮件网关的角色。

测试过的系统：

• Debian 11

安装

# 最新版本
ansible-galaxy role install git+https://github.com/ansibleguy/sw_proxmox_mail_gw

# 从galaxy安装
ansible-galaxy install ansibleguy.sw_proxmox_mail_gw

# 或者自定义角色路径
ansible-galaxy install ansibleguy.sw_proxmox_mail_gw --roles-path ./roles

# 安装依赖
ansible-galaxy install -r requirements.yml

前提条件

查看：前提条件

使用方法

想要一个简单的Ansible GUI？可以查看我的Ansible WebUI

配置

根据需要定义配置：

pmg:
  fqdn: 'pmg.template.ansibleguy.net'  # 你的服务器的有效公共DNS主机名

  manage:
    webserver: true  # 设置为false以禁用nginx组件

  nginx:  # 配置Web服务器设置 => 参见: https://github.com/ansibleguy/infra_nginx
    aliases: ['mail-gw.ansibleguy.net']  # 添加到证书的额外域名
    ssl:
      mode: 'letsencrypt'  # 或selfsigned/ca
      # 如果使用'selfsigned'或'ca':
      #   cert:
      #     cn: 'Proxmox Mail Gateway'
      #     org: 'AnsibleGuy'
      #     email: '[email protected]'
    letsencrypt:
      email: '[email protected]'

最基本的示例：

pmg:
  fqdn: 'pmg.template.ansibleguy.net'

使用PMG内置ACME的示例：

pmg:
  fqdn: 'pmg.template.ansibleguy.net'

  nginx:
    aliases: ['mail-gw.ansibleguy.net']
    plain_site: false  # nginx将不绑定到80端口
    letsencrypt:
      email: '[email protected]'

如果你想手动设置postgreSQL的示例：

pmg:
  fqdn: 'pmg.template.ansibleguy.net'

  manage:
    database: false

你可能想使用'ansible-vault'来加密你的密码：

ansible-vault encrypt_string

执行

运行剧本：

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml

要调试错误，可以在运行时设置'debug'变量：

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml -e debug=yes

功能

• 软件包安装

  • Ansible依赖（_最小化_）
  • Systemd
  • Proxmox邮件网关
  • PMG依赖
    • postgreSQL
    • Postfix

• 配置

  • 默认的postgreSQL安装

  • 默认选项：

    • Nginx => 使用这个角色

  • 默认禁用选项：

    • 企业apt存储库（_需要订阅_）

信息

• 警告： 如果你正在使用专用虚拟机进行此设置：

  你可能应该使用ISO安装过程。

  这可能会得到更好的支持！

• 注意： 此角色目前仅支持基于Debian的系统

• 注意： 该角色的大多数功能可以选择启用或禁用。

  所有可用选项请查看位于主默认文件中的默认配置！

• 警告： 你提供的不是每个设置/变量都会被检查有效性。错误的配置可能会导致角色无法正常工作！

• 警告： 如果你选择安装nginx Web服务器（_默认_）并希望使用内置ACME证书管理 - 你必须将'nginx.plain_site'配置为'false'。

  因为此'ACME独立集成'需要80端口未被占用！

• 注意： 查看Proxmox提供的详细文档！

• 警告： 不支持Docker容器。

• 信息： PMG的Web界面的默认登录通过PAM/系统用户完成。

  通常，一开始使用'root'进行登录。