plmail是自托管网页邮件客户端,可通过官方docker compose部署,再连接已有imap邮箱;它不负责替你运行收信邮件服务器,也不需要开放25端口。首次部署的关键是使用当前官方compose.yaml、先限制安装入口访问、完成首个管理员设置,并保留数据库、生成密钥及附件等持久卷。
用官方Compose启动,先保护首次设置入口
准备Docker与Docker Compose,检查80、443端口是否与现有服务冲突。镜像提供linux/amd64和linux/arm64版本。先将部署入口限制在自己的管理网络,避免尚无用户时,其他人先打开/install创建管理员。
git clone https://github.com/karatektus/pl_mail.git cd pl_mail docker compose config --services docker compose up -d --wait docker compose ps
使用发布镜像的compose.yaml,不附加开发用途的compose.dev.yaml。默认发布80/tcp、443/tcp和443/udp;已有反向代理或需改变端口时,按官方配置参考设置HTTP_PORT、HTTPS_PORT和HTTP3_PORT。使用可解析到该机器的域名配置SERVER_NAME,或让受信任的反向代理提供HTTPS证书。

项目官方收件箱示例,邮件与账户为演示数据
完成管理员和邮箱账户设置
通过计划供用户使用的HTTPS地址进入安装页,填写首个管理员及正确公共URL。官方也提供docker compose exec php php bin/console app:setup终端设置方式。不要把仅本机可访问的localhost误填为需要外部推送服务使用的公共地址。
「在我电脑上明明能跑」——因为少了Docker。帮你写Dockerfile、构建镜像、配置多环境、编排docker-compose,从本地开发到服务器部署一条龙。支持Node.js/Python/Go/Java/前端全栈,覆盖CI/CD集成、安全加固、监控告警,告别环境不一致的噩梦。 触发词:Docker部署、容...
进入Settings的Mail accounts后,按邮箱服务商提供的IMAP和SMTP主机、端口与认证方式添加账户。Gmail和Outlook另需各自的OAuth配置,不能套用普通IMAP密码;这里只完成已有标准IMAP账户接入,不包含申请第三方OAuth应用的流程。先检查连接状态,再等待首轮历史邮件同步,邮件较多时任务队列增长不等于故障。
检查后台进程和持久数据
docker compose logs --tail=100 php worker database docker compose exec php php bin/console list

项目官方管理页示例,实际进程状态以自己的部署为准
当前Compose由secrets-init生成密钥,database运行PostgreSQL,php提供网页,worker承载后台处理。管理页可检查进程存活及队列,不要照抄旧文档中已经拆分过的容器名称来判断服务缺失。
持久数据不只有PostgreSQL:app_secrets保存generated.env等密钥,app_attachments、app_raw、app_uploads保存邮件相关文件。备份需覆盖数据库与所需卷,并在隔离环境验证恢复;仅有数据库而丢失原加密密钥,可能无法解开保存的账户凭据。升级前先查当前部署说明,避免用空卷覆盖已有目录;不要运行docker compose down -v清空业务卷。

















