mailinabox README

The project's README from github.com/mail-in-a-box/mailinabox. As one markdown file: README.md.

Mail-in-a-Box

By @JoshData and contributors.

Mail-in-a-Box helps individuals take back control of their email by defining a one-click, easy-to-deploy SMTP+everything else server: a mail server in a box.

Please see https://mailinabox.email for the project's website and setup guide!

Our goals are to:

Additionally, this project has a Code of Conduct, which supersedes the goals above. Please review it when joining our community.

In The Box

Mail-in-a-Box turns a fresh Ubuntu 22.04 LTS 64-bit machine into a working mail server by installing and configuring various components.

It is a one-click email appliance. There are no user-configurable setup options. It "just works."

The components installed are:

It also includes system management tools:

Internationalized domain names are supported and configured easily (but SMTPUTF8 is not supported, unfortunately).

It also supports static website hosting since the box is serving HTTPS anyway. (To serve a website for your domains elsewhere, just add a custom DNS "A" record in you Mail-in-a-Box's control panel to point domains to another server.)

For more information on how Mail-in-a-Box handles your privacy, see the security details page.

Installation

See the setup guide for detailed, user-friendly instructions.

For experts, start with a completely fresh (really, I mean it) Ubuntu 22.04 LTS 64-bit machine. On the machine...

Clone this repository and checkout the tag corresponding to the most recent release (which you can find in the tags or releases lists on GitHub):

$ git clone https://github.com/mail-in-a-box/mailinabox
$ cd mailinabox
$ git checkout TAGNAME

Begin the installation.

$ sudo setup/start.sh

The installation will install, uninstall, and configure packages to turn the machine into a working, good mail server.

For help, DO NOT contact Josh directly --- I don't do tech support by email or tweet (no exceptions).

Post your question on the discussion forum instead, where maintainers and Mail-in-a-Box users may be able to help you.

Note that while we want everything to "just work," we can't control the rest of the Internet. Other mail services might block or spam-filter email sent from your Mail-in-a-Box. This is a challenge faced by everyone who runs their own mail server, with or without Mail-in-a-Box. See our discussion forum for tips about that.

Contributing and Development

Mail-in-a-Box is an open source project. Your contributions and pull requests are welcome. See CONTRIBUTING to get started.

The Acknowledgements

This project was inspired in part by the "NSA-proof your email in 2 hours" blog post by Drew Crawford, Sovereign by Alex Payne, and conversations with @shevski, @konklone, and @GregElin.

Mail-in-a-Box is similar to iRedMail and Modoboa.

The History

mailinabox (mail-in-a-box/mailinabox)

Searching Database…

15.4K ·GitHub
Mailinabox
这是什么?它能把一台全新的机器变成一套完整的自建邮件服务器——SMTP、IMAP、网页邮箱、通讯录和日历同步、DNS、垃圾邮件过滤和备份——只需一条安装命令,让个人用户可以自己收发邮件,而不必依赖邮件服务商。
这是需要注册使用的托管服务,还是我自己运行的软件?这是一款免费的开源软件,安装在你自己的服务器上——没有托管版本。安装程序会安装、卸载并配置各种软件包,把一台全新的机器改造成一台开箱即用的邮件服务器。
怎么把一台服务器变成 Mail-in-a-Box?克隆这个仓库,检出最新的发布标签,然后运行 'sudo setup/start.sh'——剩下的由脚本自动完成。装好之后,会有一个网页控制面板(同时也提供 API)来管理邮箱用户、别名、DNS 记录和备份。
我需要什么样的机器才能开始?一台完全全新的(README 真的特别强调了这一点)64 位 Ubuntu 22.04 LTS 机器——不能用其他发行版,不能有残留配置,也没有任何用户可调的安装选项;它的设计目标就是开箱即用。
Gmail 和其他邮件服务商真的会接收我服务器发出的邮件吗?无法保证:其他邮件服务可能会拦截你服务器发出的邮件,或把它归入垃圾邮件——这是所有自建邮件服务器的人都会遇到的难题,用不用这个项目都一样。项目的讨论论坛里收集了不少应对技巧。
我的邮件会留在我自己控制的硬件上吗?会——邮件、通讯录和日历都保存在你自己的机器上。推动互联网的去中心化和隐私保护是该项目明确列出的目标,页面上还提供了安全细节说明,讲清楚你的隐私是如何得到保护的。
机器上到底会安装哪些东西?Postfix(SMTP)、Dovecot(IMAP)、用于 CardDAV/CalDAV 的 Nextcloud 加上 z-push ActiveSync、Roundcube 网页邮箱、SpamAssassin 和 postgrey、带自动 SPF/DKIM/DMARC/DNSSEC 记录的 nsd4 DNS、Let's Encrypt 证书,此外还有 duplicity 备份、ufw 防火墙、fail2ban 和 munin 监控。
这台机器还能用来托管网站吗?可以——由于这台机器本来就要提供 HTTPS 服务,所以也自带了静态网站托管功能。如果域名托管在别处,只需在控制面板里添加一条自定义 DNS A 记录,把它指向另一台服务器即可。
我能对这套配置做多少自定义?几乎没有,这是有意为之:没有任何用户可调的安装选项,刻意避免高级用户的自定义修改也是项目的明确目标,这样配置才能保持自动化、可审计且可重复执行。
有哪些和它类似的项目?作者提到 Mail-in-a-Box 与 iRedMail 和 Modoboa 类似。它始于 2013 年,作者把自己的邮件服务器配置与'两小时打造防 NSA 邮件'的教程以及 Sovereign 项目的思路结合在了一起。
What are similar projects?mailcow-dockerized, docker-mailserver, stalwart, odysseus, BillionMail, omamail, mail, xdp-dns-evadeproxy
Which topics is it in?mailserver, mail, imap, smtp, ubuntu, decentralized, backup, dns, tls, email, monitoring, networking
Creator
mail-in-a-box
Size
3.8 MB
Stars
15.4K
Updated
CommitSep 26Releasev77Sep 26
Age
13y
Commits · 90 Days