clover-mail

关于

# clover 三叶草邮局 🍀 项目地址： https://github.com/Vincentkeio/clover-mail 在自己的服务器上搭建邮件服务，通过 Web 面板管理域名、邮箱和转发规则。 ## 三步开邮局： 1.接入 cloudflare token; 2.面板一键安装邮件服务器 TLS ； 3.点击创建邮箱。 ## 全程可视化，傻瓜配置，5 分钟创建强大易用的个人邮局。 ## 功能特色 - **可视化管理**：集中管理多个域名、邮箱账户、密码和邮件转发，支持别名、前缀匹配与 Catch-all 。 - **Cloudflare DNS 自动配置**：导入域名，一键生成并推送 MX 、SPF 、DKIM 、DMARC 等邮件记录，也可导出后手动配置。 - **Roundcube Webmail**：从面板选择邮箱，在新标签页免密进入；使用原生搜索、星标、文件夹、编辑器和通讯录。 - **兼容邮件客户端**：支持 IMAP 、POP3 、SMTP 和 ManageSieve ，可使用 Thunderbird 、Foxmail 、Apple Mail 等客户端。 - **全局邮箱设置**：统一管理协议开关、远程图片策略及附件上限；附件默认 100 MB ，可设置为无限额。 - **证书与运维**：支持 HTTPS 、邮件 TLS 证书管理和自动续期，提供环境检查、反垃圾统计、邮件队列、日志及备份入口。 - **账户安全与 API**：单管理员管理，支持两步验证、Passkey 、API Token 和审计日志。 ## 安装准备 - Debian 11–13 或 Ubuntu 22.04+ 服务器；默认发布镜像支持 **amd64**。 - 最低配置：**1 vCPU 、2 GB 内存**；推荐配置：**2 vCPU 、4 GB 内存**。 - 准备一个面板域名和邮件域名，将面板域名的 A 记录指向服务器公网 IP 。 - 公网开放 **80 、443 、25**；邮件客户端按需开放 **465 、587 、993**，POP3S 使用 **995**。 - 确认服务器提供商允许邮件收发，并支持设置 PTR/rDNS 。 安装器可安装 Docker ；已有受支持的宿主机 Caddy 或 Nginx 时，可共享 Web 入口。 ## 快速安装 推荐使用一键安装： ```bash curl -fsSL https://raw.githubusercontent.com/Vincentkeio/clover-mail/main/bootstrap.sh -o /tmp/clover-bootstrap.sh bash /tmp/clover-bootstrap.sh ``` 也可克隆仓库后安装： ```bash git clone https://github.com/Vincentkeio/clover-mail.git clover cd clover bash install.sh ``` 按提示填写面板域名。首次安装会在终端显示随机生成的管理员账号和密码，请保存后登录面板。 ### Docker Compose 安装 适合已安装 Docker 和 Compose v2 、可独占 80/443 等所需端口的 Linux 服务器。以 root 在服务器操作： ```bash git clone https://github.com/Vincentkeio/clover-mail.git clover cd clover cp .env.example .env nano .env ``` 将 `PANEL_HOSTNAME`、`MAIL_DOMAIN`、`MAIL_HOSTNAME` 和 `ACME_EMAIL` 改为自己的域名和邮箱；可同时填写 `CLOVER_VPS_IP`、调整时区及其他参数。首次安装的密钥项保留模板值或留空即可，初始化会自动生成。 保存后运行一条命令完成安装： ```bash CLOVER_HOME="$PWD" docker compose --profile install run --rm installer ``` Compose 初始化会生成密钥、准备邮件 TLS 、启动服务、创建管理员并安装 `clover` 快捷命令。管理员凭据显示在终端；已有数据和管理员会保留。后续可直接用 `docker compose up -d` 启动服务。已有宿主机 Nginx/Caddy 需共享端口时，请使用上方推荐的安装器。 ## 开始使用 1. **环境配置**：连接 Cloudflare ，选择邮件域名并设置邮件主机名，生成和推送 DNS 记录。 2. **检查环境**：检查 DNS 、端口及 TLS 证书；为邮件主机申请证书，并在服务器提供商处设置 PTR/rDNS 。 3. **邮箱账户**：创建邮箱及密码；需要转发时，在“别名与转发”中添加规则。 4. **Webmail**：选择邮箱并点击“进入 Roundcube”，或按[客户端配置指南](docs/mail-client-setup.md)连接邮件客户端。 Cloudflare Token 需要目标域名的区域读取及 DNS 编辑权限。邮件主机的 A 记录应设为 **DNS only**。 首次邮件证书可能为自签证书，请在连接客户端前申请可信证书。邮件能否送达还取决于服务器 IP 信誉、PTR 和收件方策略。 ## 更新与日常管理 在服务器输入 `clover` 打开管理菜单，或直接运行： ```bash clover status # 查看服务状态 clover update # 更新 clover logs # 查看日志 clover backup # 备份面板数据库与邮件配置 clover admin list # 查看管理员 ``` 更新会保留配置和 Docker 数据卷。 管理员密码遗失时，在服务器运行 `clover admin reset `。 ## 数据与安全 - 邮件与配置保存在服务器的 Docker 数据卷中； Roundcube 的通讯录和偏好独立保存。 - `.env` 含服务密钥，请妥善保管，不要公开上传。 - 面板仅有一个管理员；免密 Webmail 入口允许管理员进入所选邮箱。 ## 许可证 Clover 采用 AGPL-3.0-or-later ，具体条款及来源声明见仓库中的 LICENSE 和 NOTICE 。 Roundcube 、docker-mailserver 等第三方组件遵循各自的开源许可证。  

收录记录

1. V2EX·分享创造

   2026年10月21日 · 1 次收录