Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.

Настройка электронной почты для получения уведомлений

Чтобы пользователи могли быстро реагировать на действия в GitHub Enterprise Server, можно настроить экземпляр GitHub Enterprise Server для отправки уведомлений по электронной почте о проблемах, запросах на вытягивание и фиксации комментариев.

Настройка SMTP для предприятия

  1. Из учетной записи администратора на GitHub Enterprise Server в правом верхнем углу любой страницы щелкните .

    Снимок экрана: значок ракетного корабля для доступа к параметрам администратора сайта

  2. Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.

    Снимок экрана: ссылка "Администратор сайта" 1. На боковой панели слева нажмите Консоль управления . Вкладка "Консоль управления" на боковой панели слева

  3. В верхней части страницы нажмите Параметры. Вкладка "Параметры"

  4. В левой боковой панели щелкните Электронная почта. Вкладка электронной почты

  5. Установите флажок Включить электронную почту. Это позволит включить как исходящие, так и входящие сообщения электронной почты, однако для работы входящих сообщений электронной почты необходимо также настроить параметры DNS, как описано ниже в разделе Настройка параметров DNS и брандмауэра для разрешения входящих сообщений электронной почты. Включение исходящих сообщений электронной почты

  6. Введите параметры для вашего SMTP-сервера.

    • В поле Адрес сервера введите адрес SMTP-сервера.
    • В поле Порт введите порт, используемый SMTP-сервером для отправки электронной почты.
    • В поле Домен введите доменное имя, которое SMTP-сервер будет отправлять с ответом HELO, если таковой имеется.
    • Щелкните раскрывающийся список Проверка подлинности и выберите в нем тип шифрования, используемый SMTP-сервером.
    • В поле Адрес электронной почты для автоматической рассылки введите адрес электронной почты, который будет использоваться в полях "От" и "Кому" для всех уведомлений.
  7. Если вы хотите отменить все входящие сообщения электронной почты, поступающие на адрес для автоматической рассылки, установите флажок Отменить сообщения на адрес электронной почты для автоматической рассылки. Флажок отмены сообщений электронной почты, поступающих на адрес для автоматической рассылки

  8. В разделе Поддержка выберите тип ссылки для предложения дополнительной поддержки вашим пользователям.

    • Электронная почта: внутренний адрес электронной почты.
    • URL-адрес: ссылка на внутренний сайт поддержки. Вы должны включить http:// или https://. Электронная почта или URL-адрес поддержки
  9. Проверьте доставку по электронной почте.

Проверка доставки по электронной почте

  1. В верхней части раздела Электронная почта щелкните Проверить параметры электронной почты. Проверить параметры электронной почты

  2. В поле Куда отправить тестовое сообщение введите адрес электронной почты, на который следует отправить тестовое сообщение. Проверка адреса электронной почты

  3. Нажмите Отправить тестовое сообщение. Отправьте тестовое сообщение электронной почты

    Совет. Если при отправке тестового сообщения электронной почты возникают ошибки SMTP( например, сбой немедленной доставки или ошибка конфигурации исходящей почты), вы увидите их в диалоговом окне "Проверка параметров электронной почты".

  4. Если проверка электронной почты завершается неудачно, исправьте параметры электронной почты.

  5. После успешной проверки электронной почты нажмите кнопку Сохранить параметры внизу страницы. Кнопка "Сохранить параметры" 1. Ожидайте завершения запуска конфигурации.

    Настройка экземпляра

Принудительное применение TLS для SMTP-подключений

Шифрование TLS можно применить для всех входящих SMTP-подключений, чтобы обеспечить соответствия требованиям сертификации ISO-27017.

Примечание. Принудительное применение ПРОТОКОЛА TLS для SMTP-подключений недоступно в GitHub Enterprise Server 3.6.0 и 3.6.1. Эта функция доступна в версии 3.6.2 и более поздних версиях.

  1. Из учетной записи администратора на GitHub Enterprise Server в правом верхнем углу любой страницы щелкните .

    Снимок экрана: значок ракетного корабля для доступа к параметрам администратора сайта

  2. Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.

    Снимок экрана: ссылка "Администратор сайта" 1. На боковой панели слева нажмите Консоль управления . Вкладка "Консоль управления" на боковой панели слева

  3. В верхней части страницы нажмите Параметры. Вкладка "Параметры"

  4. В левой боковой панели щелкните Электронная почта. Вкладка электронной почты

  5. В разделе "Проверка подлинности" выберите Принудительно применить проверку подлинности TLS (рекомендуется) .

    Снимок экрана: флажок "Принудительно применить проверку подлинности TLS (рекомендуется)" 1. Нажмите кнопку Сохранить параметры под левой боковой панелью.

    Снимок экрана кнопки сохранения параметров в Консоль управления

    Примечание. Сохранение параметров в Консоль управления перезапускает системные службы, что может привести к простою, заметному для пользователей.

  6. Ожидайте завершения запуска конфигурации.

    Настройка экземпляра

Настройка параметров DNS и брандмауэра для разрешения входящих сообщений электронной почты

Если вы хотите разрешить ответы на уведомления по электронной почте, необходимо настроить параметры DNS.

  1. Убедитесь, что порт 25 в экземпляре доступен для вашего SMTP-сервера.
  2. Создайте запись A, указывающую на reply.[hostname]. В некоторых конфигурациях поставщика DNS и узла экземпляра можно вместо этого создать одну запись A, указывающую на *.[hostname].
  3. Создайте запись MX, указывающую на reply.[hostname], чтобы сообщения электронной почты для данного домена перенаправлялись в этот экземпляр.
  4. Создайте запись MX, указывающую noreply.[hostname] на [hostname], чтобы ответы на адрес cc в сообщениях с уведомлениями перенаправлялись в этот экземпляр. Дополнительные сведения см. в разделе Настройка уведомлений.

Устранение неполадок доставки электронной почты

Создание Пакета поддержки

Если вы не можете определить проблему из отображаемого сообщения об ошибке, можно скачать Пакет поддержки, содержащий все SMTP-взаимодействие между вашим почтовым сервером и GitHub Enterprise Server. После того как вы скачаете и извлечете этот пакет, проверьте записи в enterprise-manage-logs/unicorn.log для всего журнала SMTP-взаимодействия и все связанные ошибки.

В журнале unicorn должна отображаться транзакция, аналогичная следующей:

This is a test email generated from https://10.0.0.68/setup/settings
Connection opened: smtp.yourdomain.com:587
-> "220 smtp.yourdomain.com ESMTP nt3sm2942435pbc.14\r\n"
<- "EHLO yourdomain.com\r\n"
-> "250-smtp.yourdomain.com at your service, [1.2.3.4]\r\n"
-> "250-SIZE 35882577\r\n"
-> "250-8BITMIME\r\n"
-> "250-STARTTLS\r\n"
-> "250-ENHANCEDSTATUSCODES\r\n"
-> "250 PIPELINING\r\n"
<- "STARTTLS\r\n"
-> "220 2.0.0 Ready to start TLS\r\n"
TLS connection started
<- "EHLO yourdomain.com\r\n"
-> "250-smtp.yourdomain.com at your service, [1.2.3.4]\r\n"
-> "250-SIZE 35882577\r\n"
-> "250-8BITMIME\r\n"
-> "250-AUTH LOGIN PLAIN XOAUTH\r\n"
-> "250-ENHANCEDSTATUSCODES\r\n"
-> "250 PIPELINING\r\n"
<- "AUTH LOGIN\r\n"
-> "334 VXNlcm5hbWU6\r\n"
<- "dGhpc2lzbXlAYWRkcmVzcy5jb20=\r\n"
-> "334 UGFzc3dvcmQ6\r\n"
<- "aXRyZWFsbHl3YXM=\r\n"
-> "535-5.7.1 Username and Password not accepted. Learn more at\r\n"
-> "535 5.7.1 http://support.yourdomain.com/smtp/auth-not-accepted nt3sm2942435pbc.14\r\n"

Журнал показывает, что на устройстве произошли следующие события.

  • Открыто подключение к SMTP-серверу (Connection opened: smtp.yourdomain.com:587).
  • Подключение успешно выполнено и выбрано использование TLS (TLS connection started).
  • Выполнен тип login проверки подлинности (<- "AUTH LOGIN\r\n").
  • SMTP-сервер отклонил проверку подлинности как недопустимую (-> "535-5.7.1 Username and Password not accepted.).

Проверка журналов экземпляр GitHub Enterprise Server

Если вам нужно убедиться, что входящие сообщения электронной почты функционируют, вы можете изучить два файла журнала в вашем экземпляре: /var/log/mail.log и /var/log/mail-replies/metroplex.log.

Журнал /var/log/mail.log проверяет, что сообщения достигают вашего сервера. Ниже приведен пример успешного ответа по электронной почте.

Oct 30 00:47:18 54-171-144-1 postfix/smtpd[13210]: connect from st11p06mm-asmtp002.mac.com[17.172.124.250]
Oct 30 00:47:19 54-171-144-1 postfix/smtpd[13210]: 51DC9163323: client=st11p06mm-asmtp002.mac.com[17.172.124.250]
Oct 30 00:47:19 54-171-144-1 postfix/cleanup[13216]: 51DC9163323: message-id=<b2b9c260-4aaa-4a93-acbb-0b2ddda68579@me.com>
Oct 30 00:47:19 54-171-144-1 postfix/qmgr[17250]: 51DC9163323: from=<tcook@icloud.com>, size=5048, nrcpt=1 (queue active)
Oct 30 00:47:19 54-171-144-1 postfix/virtual[13217]: 51DC9163323: to=<reply+i-1-1801beb4df676a79250d1e61e54ab763822c207d-5@reply.ghe.tjl2.co.ie>, relay=virtual, delay=0.12, delays=0.11/0/0/0, dsn=2.0.0, status=sent (delivered to maildir)
Oct 30 00:47:19 54-171-144-1 postfix/qmgr[17250]: 51DC9163323: removed
Oct 30 00:47:19 54-171-144-1 postfix/smtpd[13210]: disconnect from st11p06mm-asmtp002.mac.com[17.172.124.250]

Обратите внимание, что клиент сначала подключается, затем очередь становится активной. Затем сообщение доставляется, клиент удаляется из очереди, и сеанс отключается.

Журнал /var/log/mail-replies/metroplex.log показывает, обрабатываются ли входящие сообщения электронной почты для добавления в проблемы и запросы на вытягивание в виде ответов. Ниже приведен пример успешного сообщения.

[2014-10-30T00:47:23.306 INFO (5284) #] metroplex: processing <b2b9c260-4aaa-4a93-acbb-0b2ddda68579@me.com>
[2014-10-30T00:47:23.333 DEBUG (5284) #] Matched /data/user/mail/reply/new/1414630039.Vfc00I12000eM445784.ghe-tjl2-co-ie
[2014-10-30T00:47:23.334 DEBUG (5284) #] Moving /data/user/mail/reply/new/1414630039.Vfc00I12000eM445784.ghe-tjl2-co-ie => /data/user/incoming-mail/success

Обратите внимание, что metroplex перехватывает входящее сообщение, обрабатывает его, а затем перемещает файл в /data/user/incoming-mail/success.

Проверка параметров DNS

Для правильной обработки входящих сообщений электронной почты необходимо настроить допустимую запись A (или CNAME), а также запись MX. Дополнительные сведения см. в разделе Настройка параметров DNS и брандмауэра для разрешения входящих сообщений электронной почты.

Проверка параметров брандмауэра или группы безопасности AWS

Если экземпляр GitHub Enterprise Server находится за брандмауэром или обслуживается через группу безопасности AWS, убедитесь, что порт 25 открыт для всех почтовых серверов, отправляющих сообщения электронной почты в reply@reply.[hostname].

Обращение в службу поддержки

Если вам все же не удалось устранить проблему, обратитесь в Поддержка GitHub Enterprise. Вложите в свое сообщение электронной почты выходной файл из http(s)://[hostname]/setup/diagnostics, чтобы помочь нам устранить проблему.