Laravel Homestead环境下MailHog端口1025被占用无法访问如何解决

1. 解决1025端口占用报错 #

报错核心原因是1025端口已经被其他进程占用，Homestead默认自带MailHog服务并开机自启，是最常见的占用原因。

• 先执行以下命令查看占用1025端口的进程：

sudo lsof -i :1025
# 或者
sudo netstat -tulpn | grep 1025

• 如果返回结果中进程为mailhog，说明Homestead默认服务已在后台运行，无需手动执行mailhog命令启动，直接跳过步骤1看后续访问配置即可。
• 如果要手动启动MailHog，先关闭默认自启的服务：

# 停止当前运行的MailHog服务
sudo systemctl stop mailhog
# 禁止开机自启（可选）
sudo systemctl disable mailhog

• 如果占用端口的是其他邮件服务（如postfix），执行对应命令关闭即可：

sudo systemctl stop postfix

• 关闭占用进程后再次执行mailhog命令即可正常启动。

2. 解决8025页面无法访问问题 #

• 首选验证方式：直接在主机浏览器访问Homestead虚拟机默认IP加端口 http://192.168.10.10:8025，多数情况可直接打开。
• 如果要使用localhost访问，需要确认Homestead端口映射配置：
  打开Homestead根目录下的Homestead.yaml文件，检查ports配置项是否包含以下映射：

ports:
    - send: 1025
      to: 1025
    - send: 8025
      to: 8025

配置完成后执行以下命令重启虚拟机生效：

vagrant reload --provision

3. 可选：自定义端口启动 #

如果不想修改现有服务占用状态，可手动指定MailHog端口启动：

mailhog -smtp-bind-addr 0.0.0.0:1026 -ui-bind-addr 0.0.0.0:8026

启动后需要将项目.env文件的MAIL_PORT修改为1026，访问界面使用http://localhost:8026或虚拟机IP加8026端口即可。

环境配置确认 #

你当前的.env邮件配置无需修改，保持如下配置即可正常对接MailHog：

MAIL_MAILER=smtp
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=reply@app.io
MAIL_FROM_NAME="${APP_NAME}"

内容的提问来源于stack exchange，提问作者Pathros