Simple Golang SMTP relay/proxy server

Topics
#golang #proxy-server #smtp-server #smtp-relay #ssl #load-balancer

dependabot[bot] 81da5ca41d build(deps): Bump github/codeql-action from 4.32.3 to 4.32.4 1 day ago
.github 81da5ca41d build(deps): Bump github/codeql-action from 4.32.3 to 4.32.4 19 hours ago
LICENSE c707438ae8 Update MIT license template 7 years ago
README.md d652d67542 fix: add simple doc 3 months ago
SECURITY.md 687c793203 Create SECURITY.md (#175) 1 year ago
aliases.go b164ce1387 feat: dynamic reread of aliases 3 months ago
aliases_test.go b0e4f0077f fix: add tests 3 months ago
auth.go 7f34fcbc99 gofmt: Fix formatting 5 years ago
auth_test.go 7f34fcbc99 gofmt: Fix formatting 5 years ago
config.go 0e352a9bb6 Client certificate for relay 1 month ago
config_test.go 441a53cfd9 Fix code formatting with gofmt -s 4 years ago
go.mod 67e96a9730 Bump dependencies 2 weeks ago
go.sum 67e96a9730 Bump dependencies 2 weeks ago
logger.go 17421a539e Refactor to migrate from sirupsen/logrus to rs/zerolog and integrate DeRuina/timberjack for logfile rotation 6 months ago
main.go b164ce1387 feat: dynamic reread of aliases 3 months ago
main_test.go 7f34fcbc99 gofmt: Fix formatting 5 years ago
remotes.go 0e352a9bb6 Client certificate for relay 1 month ago
remotes_test.go 875264837e add test coverage for scheme validation 3 years ago
smtp.go 0e352a9bb6 Client certificate for relay 1 month ago
smtprelay.ini 0e352a9bb6 Client certificate for relay 1 month ago

README.md

smtprelay

Go Report Card OpenSSF Scorecard

Simple Golang based SMTP relay/proxy server that accepts mail via SMTP and forwards it directly to another SMTP server.

Why another SMTP server?

Outgoing mails are usually send via SMTP to an MTA (Mail Transfer Agent) which is one of Postfix, Exim, Sendmail or OpenSMTPD on UNIX/Linux in most cases. You really don't want to setup and maintain any of those full blown kitchensinks yourself because they are complex, fragile and hard to configure.

My use case is simple. I need to send automatically generated mails from cron via msmtp/sSMTP/dma, mails from various services and network printers via a remote SMTP server without giving away my mail credentials to each device which produces mail.

Main features

  • Simple configuration with ini file .env file or environment variables
  • Supports SMTPS/TLS (465), STARTTLS (587) and unencrypted SMTP (25)
  • Checks for sender, receiver, client IP
  • Authentication support with file (LOGIN, PLAIN)
  • Enforce encryption for authentication
  • Forwards all mail to a smarthost (any SMTP server)
  • Small codebase
  • IPv6 support
  • Aliases support (dynamic reload when alias file changes)