GitLab Linux配置中的邮件设置

GitLab Linux配置邮件设置指南

一、基础配置步骤

1. 编辑GitLab主配置文件

使用文本编辑器（如nano或vim）打开GitLab的全局配置文件/etc/gitlab/gitlab.rb，这是配置邮件通知的核心文件。

2. 开启SMTP邮件发送功能

找到gitlab_rails['smtp_enable']配置项，将其值从默认的false修改为true，启用SMTP邮件发送。

3. 配置SMTP服务器参数

根据邮件服务商（如Gmail、企业邮箱、自建SMTP服务器）的要求，填写以下关键参数：

SMTP服务器地址：gitlab_rails['smtp_address']（如Gmail为smtp.gmail.com，自建服务器为smtp.yourdomain.com）；
SMTP端口：gitlab_rails['smtp_port']（常用587（TLS）或465（SSL），需与服务商一致）；
SMTP用户名：gitlab_rails['smtp_user_name']（发件邮箱地址，如your-email@gmail.com）；
SMTP密码：gitlab_rails['smtp_password']（邮箱密码或应用专用密码，如Gmail需开启“不太安全的应用访问”或创建应用密码）；
SMTP域名：gitlab_rails['smtp_domain']（发件域名，如gmail.com或yourdomain.com）；
认证方式：gitlab_rails['smtp_authentication']（通常为login，部分服务商支持plain）；
TLS/SSL设置：gitlab_rails['smtp_enable_starttls_auto']设为true（自动启用STARTTLS加密），gitlab_rails['smtp_tls']设为false（避免与STARTTLS冲突）；
证书验证：gitlab_rails['smtp_openssl_verify_mode']设为peer（验证服务器证书，生产环境推荐）；若使用自签名证书，可设为none（不推荐）。

二、常见邮件服务商示例

1. Gmail配置

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.gmail.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "your-email@gmail.com"
gitlab_rails['smtp_password'] = "your-app-password"  # 需替换为Gmail应用专用密码
gitlab_rails['smtp_domain'] = "gmail.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false
gitlab_rails['smtp_openssl_verify_mode'] = 'peer'

2. 自建SMTP服务器配置

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.yourdomain.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "gitlab@yourdomain.com"
gitlab_rails['smtp_password'] = "your-smtp-password"
gitlab_rails['smtp_domain'] = "yourdomain.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false
gitlab_rails['smtp_openssl_verify_mode'] = 'peer'

三、应用配置与测试

1. 重新配置GitLab

修改gitlab.rb后，运行以下命令使配置生效：

sudo gitlab-ctl reconfigure

2. 重启GitLab服务

重启服务以加载新的邮件配置：

sudo gitlab-ctl restart

3. 测试邮件发送

登录GitLab Web界面，执行以下操作触发邮件通知：

创建新项目并添加成员；
提交代码并触发合并请求；
在项目中创建议题（Issue）。

检查收件箱（或垃圾邮件箱）是否收到GitLab发送的通知邮件。若未收到，可通过以下命令查看GitLab日志排查问题：

tail -f /var/log/gitlab/gitlab-rails/production.log

注意事项

应用密码：部分邮件服务商（如Gmail）要求使用应用专用密码，而非邮箱登录密码；
防火墙：确保服务器防火墙允许GitLab进程访问SMTP服务器端口（如587）；
证书问题：自签名证书需将smtp_openssl_verify_mode设为none，但生产环境建议使用有效证书并开启验证；
日志排查：若邮件发送失败，优先查看GitLab日志中的错误信息（如连接超时、认证失败）。