mirror of
https://github.com/QYG2297248353/appstore-1panel.git
synced 2025-02-22 19:34:24 +08:00
127 lines
3.8 KiB
Markdown
127 lines
3.8 KiB
Markdown
# 使用说明
|
||
|
||
## 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
|
||
```
|
||
结束
|
||
|
||
# 原始相关
|
||
|
||
Maddy Mail Server
|
||
=====================
|
||
> Composable all-in-one mail server.
|
||
|
||
Maddy Mail Server implements all functionality required to run a e-mail
|
||
server. It can send messages via SMTP (works as MTA), accept messages via SMTP
|
||
(works as MX) and store messages while providing access to them via IMAP.
|
||
In addition to that it implements auxiliary protocols that are mandatory
|
||
to keep email reasonably secure (DKIM, SPF, DMARC, DANE, MTA-STS).
|
||
|
||
It replaces Postfix, Dovecot, OpenDKIM, OpenSPF, OpenDMARC and more with one
|
||
daemon with uniform configuration and minimal maintenance cost.
|
||
|
||
**Note:** IMAP storage is "beta". If you are looking for stable and
|
||
feature-packed implementation you may want to use Dovecot instead. maddy still
|
||
can handle message delivery business.
|
||
|
||
[](https://github.com/foxcpp/maddy/actions/workflows/cicd.yml)
|
||
[](https://github.com/foxcpp/maddy)
|
||
|
||
* [Setup tutorial](https://maddy.email/tutorials/setting-up/)
|
||
* [Documentation](https://maddy.email/)
|
||
|
||
* [IRC channel](https://webchat.oftc.net/?channels=maddy&uio=MT11bmRlZmluZWQb1)
|
||
* [Mailing list](https://lists.sr.ht/~foxcpp/maddy)
|