宝塔邮局+Roundcube Webmail自建邮局部署说明

转载最新推荐文章于 2026-09-15 09:57:37 发布 8.7k 阅读 AI写同款

收录于

PHP

withoutfear

码龄13年墨衍会员 · AI 创作全网分发

541粉丝79篇原创

关注

基于宝塔面板与Roundcube的自建邮箱系统完整部署指南邮件系统是现代网络通信的基础设施，其核心依赖于SMTP、IMAP等标准协议实现邮件的发送、接收与存储。自建邮件服务器不仅能深入理解邮件协议栈的工作原理，更能实现数据的完全自主可控，对于注重隐私、成本与定制化的场景具有重要技术价值。在中小企业内部通讯、个人开发者专属邮箱、项目组隔离环境等应用场景中，自建方案提供了比公有云服务更灵活的部署选择。本文将聚焦于如何利用宝塔面板的图形化管理能力与Roundcube开源Webmail客户端，在云服务器上快速搭建一套功能完备、支持用户注册的私有邮箱系统，其中会详细解析宝塔阅读详情

AI摘要

本文介绍了使用宝塔邮局和Roundcube搭建邮箱服务的方法。首先选择程序，邮局部分选宝塔邮局，Webmail部分选Roundcube。接着做好准备工作，包括准备云服务器、域名等。然后开始搭建，安装宝塔邮局插件、新建网站、配置Roundcube，最后测试服务配置。搭建完成后可登录网页端体验邮箱服务。

原文：https://www.wifilu.com/3126.html 这里作者略有修改

一，程序选型
1，邮局部分
选择宝塔邮局。因为这是宝塔面板的免费插件之一，安装方便操作非常简单。

2，Webmail部分
选择Roundcube。首先这是一个开源webmail程序，界面较为美观，支持PHP+NGINX+MYSQL 很好上手，然后这个程序目前一直更新中。

二，准备工作
1，一台合适的云服务器

2，需要一个域名
如果你选择国内服务器，那么你的域名需要已备案。

3，下载 Roundcube 程序
你可以在 https://roundcube.net/download/ 下载Complete包（包括所有插件的），或者在可以去本文原址中的网盘下载。

4，安装宝塔面板
请前往宝塔面板下载，免费全能的服务器运维软件获取最新的安装命令。
并安装基础的php，niginx，mysql运行环境。

三，开始搭建
1，宝塔面板开始安装宝塔邮局插件
请参考官方帮助文档：【宝塔邮局管理器】使用教程 - Linux面板 - 宝塔面板论坛
1.1，需要注意的是，宝塔的脚本有概率无法安装Rspamd服务，导致无法提供DKIM记录的值。出现如下错误

此时需要你手动安装Rspamd服务
debian/ubuntu: apt install rspamd
centos: yum install rspamd

1.2，需要你新建一个邮箱用户，方便后续Roundcube webmail的测试。

2，宝塔新建一个网站
2.1，新建一个网站，需要有PHP，需要有mysql。推荐域名使用：mail.xxxx.com(xxx.com是你自己的域名)
新建完成之后，记得保存数据库信息，后面有用。

2.2，roundcubemail-1.6.7.tar.gz解压后，将roundcubemail-1.6.7文件夹内的文件上传到网站根目录。

3，配置Roundcube3.1，进入安装界面
访问 http://mail.xxx.com/installer，进入安装界面
第一步（Check environment）是检查你的服务器各种配置是否满足，绝大部分情况是满足的。点击 next 下一步。

3.2，详细配置（Create config）

在这个界面你需要关注的几个配置是：
General configuration 常规配置
product_name 邮箱名称，请起一个名字（支持中文）
support_url，登录界面给用户的一个链接，可以点击跳转其他地方，一般用作帮助页面，可以不填。
temp_dir 临时目录，保持默认即可。
des_key，加密imap的密钥，自己随便填一个英文+数字字符串即可。
identities_level，建议选择 one identity with possibility to edit all params but not email address（一个身份可以编辑所有参数，但不能编辑电子邮件地址）
其他保持默认
Logging & Debugging 日志记录和调试
保持默认设置
Database setup 数据库配置
Database type选择 mysql
Database server 数据库服务器，如果是本机就是localhost
Database name 数据库名称，参看建站时记录
Database user name 数据库用户名，参看建站时记录
Database password 数据库密码，参看建站时记录
其他保持默认
IMAP Settings IMAP 设置imap_host imap服务器地址
这个需要具体参考你在宝塔邮局的设置，如果你在宝塔邮局设置的邮局服务器时mail.xxx.com
那么常规填写：mail.xxx.com:143
如果设置了SSL加密则填写：ssl://mail.xxx.com:993
username_domain 用户名_域名，一般是xxx.com。设置了以后，网页用户登录时可以省略@xxx.com的部分。
auto_create_user 自动创建用户，勾选。这样首次登录就可以同步到Roundcube 数据库，否则需要手动修改数据库。
sent_mbox，填写 已发送。
trash_mbox，填写 已删除。
drafts_mbox，填写草稿。
junk_mbox，填写 垃圾邮件。

SMTP Settings SMTP设置
smtp_host smtp服务器地址
这个需要具体参考你在宝塔邮局的设置，如果你在宝塔邮局设置的邮局服务器时mail.xxx.com
那么常规填写：mail.xxx.com:25
如果设置了SSL加密则填写：ssl://mail.xxx.com:465
其他保持默认

Display settings & user prefs 显示设置和用户偏好
language 语言，填写 zh_CN
其他保持默认

Plugins 插件
插件是丰富邮箱的功能的。建议启用以下插件，其他插件可以自行测试。
acl，访问控制列表
additional_message_headers，附加消息标头
archive，档案
autologon，自动登录
emoticons，表情符号
filesystem_attachments，文件系统附件，核心插件，提供基本的、基于文件系统的附件临时文件处理。这包括存储当前正在撰写的消息的附件、在重新打开带有附件的草稿时将附件写入磁盘以及将附件写入磁盘以便在当前 html 撰写中内联显示。
hide_blockquote，隐藏区块引用
identicon，身份识别图标
identity_select，身份选择
managesieve，管理筛选器
markasjunk，垃圾标记
new_user_identity，新用户身份（登陆时填充默认的@xxx.com部分）
newmail_notifier，新邮件通知程序，支持三种通知方式：1. 基本 - 聚焦浏览器窗口并更改图标 2. 声音 - 播放 wav 文件 3. 桌面 - 显示桌面通知（使用 HTML5 通知 API 功能）。
redundant_attachments，冗余附件
show_additional_headers，显示附加标题
userinfo，用户信息
vcard_attachments，检测 vCard 电子名片
zipdownload，zip下载，当邮件包含多个附件时，添加一个选项，可以将邮件的所有附件下载到一个 zip 文件中。
然后点击 CREATE/UPDATE CONFIG 更新设置。

3.3，测试服务配置（Test config）
上一步更新配置后，会配置更新完毕。点击下面的 CONTINUE按钮，则进入测试界面。