Coremail 常见问题排查 FAQ与故障快速定位

快速定位原则

遇到邮件问题时，按这个顺序排查：

1. 先确认范围：只有你一个人有问题？还是全组织都有问题？
2. 看是哪一端：Webmail 不行？客户端不行？都不行？
3. 看是什么操作：收信不行？发信不行？搜索不行？附件不行？
4. 查错误提示：有没有明确的错误信息？
5. 联系管理员：如果排除了个人问题，可能是服务器或网络层面的

一、登录问题

问题：登录时提示"用户名或密码错误"

排查步骤：

1. 确认账号和密码是否正确（注意大小写）
2. 确认域名是否选择正确（有些组织有多个域名）
3. 如果是自建系统，检查 LDAP/AD 同步是否正常
4. 管理员后台查看该账号状态（是否被禁用/密码过期）

解决：

• 如果密码忘了，点"忘记密码"按流程重置
• 如果账号被禁用，联系管理员启用
• 如果是 AD 同步问题，管理员排查同步服务状态

问题：登录时提示"账号已锁定"

原因：连续多次密码错误触发锁定（防暴力破解）。

解决：

• 等待 15-30 分钟自动解锁（管理员可配置时长）
• 管理员在后台手动解锁

问题：登录成功但页面一直加载

排查步骤：

1. 检查网络连接是否正常
2. 清除浏览器缓存和 Cookie，重新登录
3. 换一个浏览器试试（Chrome/Edge/Firefox）
4. 检查浏览器是否拦截了 Coremail 的脚本（隐私插件/广告拦截）
5. 如果是自建系统，检查服务器负载（可能高负载导致响应慢）

二、收信问题

问题：收不到某封邮件

按顺序排查：

1. 垃圾箱：最常见——邮件被反垃圾引擎拦截了
2. 隔离区：可能在隔离区等待处理
3. 检查规则：是否有邮件规则把它移到其他文件夹了
4. 发件方确认：让发件方检查是否收到退信（退信原因能定位问题）
5. 收件人地址：确认邮箱地址没写错
6. 管理员后台：管理员查看邮件是否到达服务器（如果没到，问题在发件方或网络）

问题：收信延迟

排查步骤：

1. 检查网络是否正常
2. 管理员检查邮件服务器负载和队列积压情况
3. 如果是自建系统，检查磁盘空间（满了会影响收发）
4. 如果只有部分邮件延迟，可能是发件方服务器的问题
5. 海外邮件延迟通常是网络原因（可以用 CACTER 海外中继解决）

问题：附件打不开

排查步骤：

1. 确认本机有能打开该格式的软件
2. 如果是 Outlook/Foxmail，确认附件下载完整
3. 如果是 Webmail，试试"保存到本地"后再打开
4. 常见能引起问题的格式：.exe（被拦截）、.zip（被安全策略标记）、.docm（宏文件）
5. Coremail 的附件安全策略可能会拦截某些格式——管理员可以调整

三、发信问题

问题：发信后提示"发送失败"

常见原因和排查：

问题：发出去的邮件对方没收到

排查步骤：

1. 检查"已发送"文件夹里有没有这封邮件（确认是否真的发出去了）
2. 如果已发送里有，说明 Coremail 已经发出去了——问题在对方那边
3. 让对方检查垃圾箱
4. 如果对方也没收到，查发件日志（管理员后台可查）
5. 海外发信问题常见——用 CACTER 海外中继

问题：发信速度慢

排查步骤：

1. 网络带宽是否充足
2. 附件是否太大
3. 管理员检查 MTA 队列是否积压
4. 自建系统检查服务器负载和磁盘 I/O

四、搜索问题

问题：搜索不到应该有的邮件

排查步骤：

1. 搜索关键词是否准确（支持关键词搜索，不支持自然语言——除非用 Coremail AI）
2. 是否选错了搜索范围（默认是收件箱，可能邮件在其他文件夹）
3. 试试更宽泛的关键词或按发件人/时间范围筛选
4. 如果是自建系统，管理员检查全文搜索索引状态（索引服务挂了会导致搜不到）

问题：搜索结果太慢

排查步骤：

1. 搜索范围是否太大（全量搜索比单文件夹慢）
2. 自建系统检查搜索服务器负载
3. SaaS 版通常是 Coremail 负责，联系管理员

五、客户端问题

问题：客户端频繁断连

排查步骤：

1. 网络是否稳定
2. 客户端设置的超时时间是否太短
3. 自建系统检查服务器连接数限制
4. 重启客户端试试

问题：客户端和 Webmail 不同步

排查步骤：

1. 确认用的是 IMAP 协议（POP3 不会同步）
2. 在客户端手动触发同步
3. 检查客户端设置的同步频率
4. 自建系统检查 IMAP 服务状态

六、Webmail 界面问题

问题：界面显示不正常

排查步骤：

1. 浏览器缓存清除
2. 换浏览器试试
3. 确认浏览器版本（Coremail 不支持 IE，Chrome/Edge/Firefox/Safari 最新两版）
4. 检查是否开启了"兼容模式"（如果有，关掉）

问题：写信编辑器异常

排查步骤：

1. 清除浏览器缓存
2. 关闭广告拦截插件（可能拦截了编辑器脚本）
3. 确认浏览器版本
4. 换浏览器试试

七、管理员后台问题

管理员常见检查清单

遇到任何问题，管理员第一时间检查：

• [ ] 服务器状态：所有服务是否正常运行
• [ ] 磁盘空间：是否快满了（>80% 要告警）
• [ ] 系统负载：CPU/内存是否正常
• [ ] 邮件队列：是否有大量积压邮件
• [ ] 反垃圾状态：是否在正常拦截
• [ ] 日志查看：错误日志中是否有异常
• [ ] 用户状态：是否有大量用户登录异常

核心管理员命令（XT6 自建）

# 检查邮件收发状态
./mailc status

# 查看邮件队列
./mailc queue list

# 强制清理队列（慎用）
./mailc queue flush

# 查看服务器负载
top / htop

# 查看磁盘空间
df -h

# 查看服务状态
systemctl status coremail-*

快速联系渠道

如果以上排查解决不了：