yoryan/smtp-translator

SMTP Translator

SMTP Translator是一个自定义SMTP服务器，可将收到的所有电子邮件转换为Pushover通知——这是一种比电子邮件更快、更简单、更现代的替代方案。无需再在所有Linux设备上复制Gmail密码给邮件守护进程！

SMTP Translator已被我的Mailrise项目取代，该项目使用https://github.com/caronc/apprise%E5%BA%93%E5%87%A0%E4%B9%8E%E5%8F%AF%E4%BB%A5%E6%8E%A8%E9%80%81%E5%88%B0%E4%BB%BB%E4%BD%95%E6%9C%8D%E5%8A%A1%EF%BC%8C%E8%80%8C%E4%B8%8D%E4%BB%85%E4%BB%85%E6%98%AFPushover%E3%80%82

!https://raw.githubusercontent.com/wiki/YoRyan/smtp-translator/android_notify.jpg

核心功能

• 将收到的邮件直接转换为Pushover通知，无需通过公共邮件网络
• 支持自定义通知参数（设备、优先级、重试间隔、过期时间、通知声音）
• 自动处理邮件中的图片附件（不超过Pushover的2.5MB限制）
• 多应用令牌模式：从发件人地址读取应用令牌，无需设置环境变量
• 支持TLS加密（Immediate TLS、STARTTLS可选/强制）
• 支持用户名密码认证，保护服务器安全

使用场景

适用于需要将系统邮件（如NAS告警、服务器通知）快速推送到手机的场景，例如：

• Synology NAS配置SMTP relay发送通知
• Debian/Ubuntu系统通过exim4、postfix、sendmail转发邮件到Pushover
• 个人服务器监控告警通知

配置说明

运行自己的实例

首先，将SMTP Translator安装到GOPATH：

bash
go get -u github.com/YoRyan/smtp-translator

启动服务器需要设置PUSHOVER_TOKEN环境变量：

bash
export PUSHOVER_TOKEN=xxx
sudo smtp-translator

可选参数：

• -addr：监听地址（默认：:25）
• -hostname：广告主机名
• -multi：多应用令牌模式（从发件人地址读取token）
• -tls-cert/-tls-key：TLS证书和密钥文件
• -starttls：启用STARTTLS（可选升级）
• -starttls-always：强制STARTTLS
• -auth：认证文件路径（每行格式：username:password）

Pushover参数

收件人地址格式：user_key[>device][#priority][%retry][$expire][!sound]@pushover.net
示例：uQiRzpo4DXghDmr9QzzfQu27cmVRsG>phone!incoming@pushover.net（发送到phone设备，使用incoming声音）

Docker部署

从Docker Hub拉取镜像：

bash
docker pull yoryan/smtp-translator

运行容器（需设置PUSHOVER_TOKEN）：

bash
docker run -e PUSHOVER_TOKEN=xxx -p 25:25 -t yoryan/smtp-translator

传递额外参数：

bash
docker run -it yoryan/smtp-translator /app/smtp-translator -help  
docker run -e PUSHOVER_TOKEN=xxx -p 2525:2525 -t yoryan/smtp-translator /app/smtp-translator -addr 0.0.0.0:2525

启用TLS需绑定证书文件：

bash
docker run -e PUSHOVER_TOKEN=xxx -p 465:465 -v /path/to/cert.pem:/cert.pem -v /path/to/key.pem:/key.pem -t yoryan/smtp-translator /app/smtp-translator -tls-cert /cert.pem -tls-key /key.pem

配置示例

Synology NAS

!https://raw.githubusercontent.com/wiki/YoRyan/smtp-translator/synology_config.jpg

exim4（Debian/Ubuntu）

运行dpkg-reconfigure exim4-config并选择：

• 邮件配置类型："mail sent by smarthost; no local mail"
• outgoing smarthost地址："smtpt.youngryan.com::587"

测试：

bash
mailx -s 'Test Email' 'your.user.key.here@pushover.net'  
Hello, World!

postfix

编辑/etc/postfix/main.cf：

bash
relayhost = [smtpt.youngryan.com:587]  
smtp_tls_security_level = verify  
smtp_tls_mandatory_ciphers = high  
smtp_tls_verify_cert_match = hostname

测试：

bash
mailx -s 'Test Email' 'your.user.key.here@pushover.net'  
Hello, World!

sendmail

编辑/etc/mail/sendmail.mc并执行/etc/mail/make：

bash
define(`SMART_HOST', `smtpt.youngryan.com')dnl  
define(`RELAY_MAILER', `esmtp')dnl  
define(`RELAY_MAILER_ARGS', `TCP $h 587')dnl  
define(`confAUTH_MECHANISMS', `CRAM-MD5')dnl

测试：

bash
mailx -s 'Test Email' 'your.user.key.here@pushover.net'  
Hello, World!

FAQ

Q: 有什么陷阱吗？

没有。代码完全开源，不会记录消息或元数据。若需更高隐私，可自行获取应用令牌并部署实例。

Q: smtpt.youngryan.com支持加密吗？

是的，端口与加密方式如下：

注意：邮件本质上无法端到端加密，理论上仍可能被读取。

Q: 消息未送达怎么办？

检查收件人地址中的token是否正确（容易混淆应用令牌与用户/组令牌）。