mirror of
https://github.com/okxlin/appstore.git
synced 2026-09-26 00:01:06 +00:00
135 lines
3.5 KiB
Markdown
135 lines
3.5 KiB
Markdown
# Maddy Mail Server
|
|
|
|
## 应用简介
|
|
可组合的多合一邮件服务器。
|
|
|
|
英文说明：Composable all-in-one mail server.
|
|
|
|
## 部署说明
|
|
- 本应用使用 Docker Compose 在 1Panel 中部署。
|
|
- 应用分类：邮件。
|
|
- 支持架构：amd64。
|
|
- 可选版本：`latest`、`0.9.5`。
|
|
- 安装后按应用表单中的端口访问 Web UI、SSH 或对应服务。
|
|
|
|
## 端口
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| SMTP_IN_PORT | SMTP 入站端口 | 25 | 是 |
|
|
| IMAP4_PORT | IMAP4 端口 | 143 | 是 |
|
|
| IMAP4_PORT2 | IMAP4 端口 | 993 | 是 |
|
|
| SMTP_S_PORT | SMTP 提交端口 | 465 | 是 |
|
|
| SMTP_S_PORT2 | SMTP 提交端口 | 587 | 是 |
|
|
|
|
## 数据持久化
|
|
- `maddydata:/data`
|
|
|
|
升级或迁移前，请在 1Panel 中备份上述数据目录。
|
|
|
|
## 配置项
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| MAIL_HOSTNAME | 邮箱 MX 主机名 | mail.example.com | 是 |
|
|
| MAIL_DOMAIN | 邮箱域名 | example.com | 是 |
|
|
|
|
## 使用说明
|
|
### 1. 准备域名证书
|
|
使用`acme.sh`、`certbot`、手动上传等方式准备好域名证书，注意需要按需修改。
|
|
|
|
证书对应域名为邮箱`MX`主机名如`mail.example.com `。
|
|
|
|
### 2. 创建Docker存储卷
|
|
```
|
|
docker volume create maddydata
|
|
```
|
|
|
|
### 3. 安装应用
|
|
|
|
应用商店安装应用，
|
|
|
|
第一次安装会显示异常，容器无法正常运行，不必在意，因为缺少证书文件。
|
|
|
|
忽略错误，进行下一步操作。
|
|
|
|
### 4. 域名证书存放到存储卷
|
|
|
|
存储卷默认路径如下
|
|
`/var/lib/docker/volumes/maddydata/_data/`
|
|
|
|
```
|
|
# 进入存储卷路径
|
|
cd $(docker volume inspect maddydata --format '{{.Mountpoint}}')
|
|
|
|
# 创建证书文件夹
|
|
mkdir -p tls
|
|
```
|
|
上传证书和私钥到`tls`文件夹，并重命名为
|
|
- fullchain.pem
|
|
- privkey.pem
|
|
|
|
按要求上传完成证书文件后，容器会自动正常运行。
|
|
|
|
### 5. 设置DKIM DNS解析
|
|
### 5.1 获取DKIM值
|
|
|
|
当容器正常运行后
|
|
|
|
在`/var/lib/docker/volumes/maddydata/_data/dkim_keys`路径下
|
|
|
|
会有个类似`example.com_default.dns`的文件
|
|
|
|
其中则是需要获取的相关信息。
|
|
|
|
- 注意按需修改域名
|
|
|
|
终端查看
|
|
```
|
|
cat /var/lib/docker/volumes/maddydata/_data/dkim_keys/example.com_default.dns
|
|
```
|
|
|
|
会得到类似以下内容
|
|
```
|
|
default._domainkey.example.org. TXT "v=DKIM1; k=ed25519; p=nAcUUozPlhc4VPhp7hZl+owES7j7OlEv0laaDEDBAqg="
|
|
```
|
|
|
|
### 5.2 设置DNS TXT记录
|
|
|
|
根据获取的信息设置`DNS解析`
|
|
|
|
例子如下：
|
|
为 `default._domainkey.example.com` 添加`TXT`记录，值设置为`v=DKIM1; k=ed25519; p=nAcUUozPlhc4VPhp7hZl+owES7j7OlEv0laaDEDBAqg=`。
|
|
|
|
### 6. 设置DNS解析
|
|
|
|
- 注意按需修改
|
|
|
|
| 记录类型 | 域名 | 值 |
|
|
| --- | --- | --- |
|
|
| A | `mail.example.com` | `服务器ipv4地址` |
|
|
| A | `example.com` | `服务器ipv4地址` |
|
|
| AAAA | `mail.example.com` | `服务器ipv6地址（如果有）` |
|
|
| AAAA | `example.com` | `服务器ipv6地址（如果有）` |
|
|
| MX | `example.com` | `mail.example.com` |
|
|
| TXT | `mail.example.com` | `v=spf1 mx ~all` |
|
|
| TXT | `example.com` | `v=spf1 mx ~all` |
|
|
| TXT | `_dmarc.example.com` | `v=DMARC1; p=quarantine; ruf=mailto:postmaster@example.com` |
|
|
| TXT | `_mta-sts.example.com` | `v=STSv1; id=1` |
|
|
| TXT | `_smtp._tls.example.com` | `v=TLSRPTv1;rua=mailto:postmaster@example.com` |
|
|
|
|
### 7. 创建发送账户
|
|
|
|
面板`容器`界面，连接容器终端，执行以下命令
|
|
|
|
- 注意按需修改
|
|
|
|
```
|
|
maddy creds create postmaster@example.com
|
|
|
|
maddy imap-acct create postmaster@example.com
|
|
```
|
|
结束
|
|
|
|
## 参考资料
|
|
- 官网: <https://maddy.email>
|
|
- 源码: <https://github.com/foxcpp/maddy>
|