hausgold/mailcatcher

hausgold/mailcatcher 镜像文档

!https://raw.githubusercontent.com/hausgold/docker-mailcatcher/master/docs/assets/project.svg

https://github.com/hausgold/docker-mailcatcher/actions/workflows/package.yml/badge.svg?branch=master](https://github.com/hausgold/docker-mailcatcher/actions/workflows/package.yml)

该Docker镜像以https://hub.docker.com/r/schickling/mailcatcher/%E4%B8%BA%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E5%B9%B6%E5%9C%A8%E5%85%B6%E4%B8%8A%E6%B7%BB%E5%8A%A0%E4%BA%86mDNS/ZeroConf%E5%8D%8F%E8%AE%AE%E6%A0%88%E3%80%82%E5%9B%A0%E6%AD%A4%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E4%BD%BF%E7%94%A8%E5%BC%BA%E5%A4%A7%E7%9A%84mailcatcher%E5%BA%94%E7%94%A8%EF%BC%8C%E9%BB%98%E8%AE%A4%E5%8F%AF%E9%80%9A%E8%BF%87*mailcatcher.local*%E8%AE%BF%E9%97%AE%E3%80%82

• 要求
• 快速开始
• docker-compose使用示例
• 主机配置
• 配置不同的mDNS主机名
• 其他顶级域名
• 界面展示
• 延伸阅读

要求

• 主机启用Avahi守护进程
• 主机启用mDNS NSS查找

快速开始

只需运行以下命令，即可启动一个可用的mailcatcher：

bash
$ docker run --rm hausgold/mailcatcher

haproxy会将1080端口代理到80端口，使mailcatcher.local可直接访问。1025端口保持不变。

docker-compose使用示例

yaml
services:
  mailcatcher:
    image: hausgold/mailcatcher
    environment:
      # 注意.local后缀
      MDNS_HOSTNAME: mailcatcher.test.local

主机配置

安装nss-mdns包，启用并启动avahi-daemon.service。然后，编辑/etc/nsswitch.conf文件，将hosts行修改为：

bash
hosts: ... mdns4_minimal [NOTFOUND=return] resolve [!UNAVAIL=return] dns ...

配置不同的mDNS主机名

通过环境变量MDNS_HOSTNAME可以配置mDNS主机名。在docker run命令中传递该变量：

bash
$ docker run --rm -e MDNS_HOSTNAME=something.else.local hausgold/mailcatcher

这将使服务可通过something.else.local访问。

您还可以通过MDNS_CNAMES环境变量为容器配置多个别名（CNAME）。该变量接受逗号分隔的域名列表，会将这些域名注册为容器的别名。

bash
$ docker run --rm \
  -e MDNS_HOSTNAME=something.else.local \
  -e MDNS_CNAMES=nothing.else.local,special.local \
  hausgold/mailcatcher

这将使服务可通过something.else.local、nothing.else.local和special.local访问。

其他顶级域名

默认情况下，.local是mDNS的默认顶级域名。该镜像不强制使用此域名，但如果使用非默认顶级域名，您需要配置主机的Avahi服务以接受该域名。

界面展示

!https://raw.githubusercontent.com/hausgold/docker-mailcatcher/master/docs/assets/how_it_looks.png

延伸阅读

• Docker/mDNS演示：https://github.com/Jack***/docker-mdns
• Archlinux使用指南：[***]
• Ubuntu/Debian使用指南：[***]