mailcow/phpfpmmailcow: dockerized 是一个基于 Docker 容器化技术构建的开源邮件服务器套件,集成了邮件服务所需的核心组件(如 SMTP、POP3、IMAP、Webmail、反垃圾邮件、防病毒等),旨在提供开箱即用、易部署、易维护的邮件服务解决方案。其主要用途是帮助企业、组织或个人快速搭建功能完整、安全可靠的自建邮件系统,支持自定义域名、邮件收发、日历协作、地址簿管理等核心邮件服务场景。
确保 Docker 和 Docker Compose 已安装并运行:
bash# 验证 Docker 状态 docker --version docker compose version systemctl status docker
mailcow 通过 Git 仓库提供完整的 Docker Compose 配置与脚本,需先克隆仓库:
bash# 克隆官方仓库 git clone [***] cd mailcow-dockerized
运行配置脚本生成基础配置(如域名、网络参数等):
bash./generate_config.sh
根据提示输入邮件服务器域名(如 mail.example.com)、时区等信息,脚本会自动生成 mailcow.conf 配置文件。
通过 Docker Compose 启动所有组件:
bashdocker compose up -d
首次启动需拉取镜像(约 10-30 分钟,取决于网络),启动后可通过 docker compose ps 查看服务状态。
mailcow.conf:主配置文件,存储域名、端口、TLS 等核心参数(由 generate_config.sh 生成,可手动修改后重启服务)。data/conf/:各组件详细配置目录(如 Postfix、Dovecot、Nginx 等),修改后需重启对应服务。| 变量名 | 说明 | 默认值示例 |
|---|---|---|
MAILCOW_HOSTNAME | 邮件服务器主机名(需解析 A 记录) | mail.example.com |
TLS_TYPE | TLS 证书类型(letsencrypt/manual) | letsencrypt |
HTTP_PORT/HTTPS_PORT | HTTP/HTTPS 端口(默认 80/443) | 80/443 |
SKIP_LETS_ENCRYPT | 是否跳过 Let's Encrypt 证书申请 | n(不跳过) |
DBROOTPW | MySQL 根密码(自动生成,可手动修改) | 随机字符串 |
bash# 启动服务 docker compose up -d # 停止服务(保留数据) docker compose down # 停止并删除数据(谨慎使用) docker compose down -v
服务启动后,通过 https://<MAILCOW_HOSTNAME> 访问管理界面,默认管理员账户:
admindata/conf/soapbox/credentials.secret 文件中查看bash# 查看所有服务日志 docker compose logs -f # 查看特定服务日志(如 postfix) docker compose logs -f postfix-mailcow
mailcow 包含多个组件(如 Postfix、Dovecot、MySQL、Redis 等),完整配置通过 docker-compose.yml 管理,无需手动编写。以下为核心服务结构示例:
yaml# 来自 mailcow-dockerized/docker-compose.yml version: '2.1' services: postfix-mailcow: image: mailcow/postfix:latest depends_on: - mysql-mailcow - redis-mailcow environment: - MAILCOW_HOSTNAME=${MAILCOW_HOSTNAME} - TLS_TYPE=${TLS_TYPE} volumes: - ./data/conf/postfix:/etc/postfix restart: always dovecot-mailcow: image: mailcow/dovecot:latest depends_on: - mysql-mailcow - redis-mailcow environment: - MAILCOW_HOSTNAME=${MAILCOW_HOSTNAME} volumes: - ./data/conf/dovecot:/etc/dovecot - ./data/vmail:/var/vmail restart: always # 其他服务:nginx、roundcube、clamav、spamassassin 等...
./data/ 目录,建议定期备份该目录。git pull 更新仓库后,执行 docker compose pull && docker compose up -d 升级。完整文档请参考 mailcow 官方文档。


manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务