Nota

Los términos smarthost y relayhost suelen usarse indistintamente. De aquí en adelante, nos limitaremos a utilizar el término smarthost.

resumen

You can configure a server-wide smarthost in Plesk Obsidian 18.0.64 or later. You can configure a smarthost at the domain level in Plesk Obsidian 18.0.76 or later.

En este tema descubrirá:

  • Cuándo es beneficioso utilizar un smarthost.

  • Cómo configurar un smarthost en Plesk.

  • Cómo la configuración de un smarthost afectará a una configuración manual existente.

  • Cómo cambia Plesk los archivos de configuración de los servicios de correo al configurar un smarthost.

You can send emails from Plesk using its local SMTP server. However, some hosting providers block outgoing mail from local SMTP servers. Even when they allow it, email deliverability may be poor and messages can end up in spam. To avoid these issues, configure a smarthost.

A smarthost is a mail server that accepts messages from any sender and forwards them to their final destination. A smarthost acts as an intermediary to improve email deliverability and reduce the chances of messages being marked as spam.

When you send an email through a smarthost, the message appears to originate from the smarthost’s IP address. If the smarthost has a strong sending reputation, your email is more likely to reach the recipient’s inbox instead of being marked as spam. For this reason, we recommend using a reputable SMTP relay service as your smarthost (for example, SendGrid, Mailgun, Mailjet, or similar providers).

Previously, you could configure a smarthost only manually. In Plesk Obsidian 18.0.64 and later, you can configure a smarthost in the Plesk graphical interface and via the CLI.

Configuring a Server-Wide Smarthost

You can configure a smarthost for the whole server. This works in Plesk for Linux with Postfix and Plesk for Windows with either MailEnable or SmarterMail.

Prudencia

Si ya ha configurado un smarthost manualmente, la activación de la función de smarthost en Plesk sobrescribirá la configuración existente. Antes de activar la función, le recomendamos que consulte la siguiente sección.

Nota

Con algunos servicios de retransmisión SMTP (por ejemplo, SendGrid), el reenvío de correo dejará de funcionar si se configura un smarthost.

To configure a server-wide smarthost:

  1. Choose a reputable SMTP relay service (for example, SendGrid, Mailgun, Mailjet, or similar providers) and create an account there.

  2. Acceso a Plesk.

  3. Vaya a Herramientas y configuración > Smarthost (en «Correo»).

  4. Seleccione la casilla «Enviar el correo de los usuarios a través de un smarthost».

  5. En el campo correspondiente, especifique la dirección IP o el nombre de host de un smarthost (por ejemplo, 192.0.2.1 o smtp.sendgrid.net).

    Nota

    En Plesk para Linux, puede desactivar las búsquedas MX o SRV poniendo el nombre de host o la dirección IP entre corchetes, por ejemplo, [example.com]. Si desea más información, consulte la documentación de Postfix (la sección sobre relayhost).

  6. Si su servicio de retransmisión SMTP requiere autenticación SMTP (y la mayoría de los servicios la requieren), seleccione la casilla «Se requiere autenticación».

  7. Si ha seleccionado «Se requiere autenticación» en el paso anterior, especifique las credenciales para autenticarse en su servicio de retransmisión SMTP.

    Si el servicio soporta la autenticación básica, especifique el nombre de usuario y la contraseña en los campos correspondientes. Si el servicio soporta la autenticación mediante claves de API, en el campo «Nombre de usuario», especifique el nombre de usuario predeterminado utilizado para las claves de API en el servicio (por ejemplo, en SendGrid, el nombre de usuario es apikey) y, en el campo «Contraseña», especifique el valor de la clave de API.

  8. (For SmarterMail only) In the «Encrypted connection» section, select whether to encrypt the credentials transmitted to the SMTP relay service. Choose if the encrypted connection is TLS, SSL, or not required.

    Nota

    If you choose a connection type that the SMTP relay service does not support (for example, SSL instead of TLS), the smarthost will refuse the connection.

  9. (Opcional) Es posible que desee comprobar si se puede establecer la conexión con el smarthost. Para ello, haga clic en Comprobar conexión.

    If you selected “Encrypted connection” in the previous step, Plesk tests the connection not only for encryption but also for a valid SSL/TLS certificate. If the connection is encrypted but the SSL/TLS certificate is not trusted (for example, expired or self‑signed), the smarthost will refuse the connection.

    Nota

    Puede cambiar el comportamiento predeterminado descrito anteriormente y permitir establecer la conexión incluso si no está protegida por un certificado SSL/TLS válido.

  10. Haga clic en ACEPTAR.

  11. Actualice el registro SPF y otros registros DNS relacionados en la plantilla DNS y en las zonas DNS de los dominios existentes. Los servicios de retransmisión SMTP proporcionan la información sobre los cambios DNS que se deben realizar.

    Ha configurado el smarthost a nivel de Plesk. Sin embargo, la mayoría de los servicios de retransmisión SMTP comerciales requieren autenticación de dominio a su nivel (también se puede llamar verificación de dominio). Los siguientes servicios de retransmisión SMTP la requieren: SendGrid, Mailjet, Mailgun.

  12. Acceda a su cuenta de servicio de retransmisión SMTP y autentique todos los dominios alojados en Plesk. Para conocer los pasos exactos sobre cómo hacerlo, consulte la documentación de su servicio.

  13. Envíe un email de prueba a un servicio de email externo (por ejemplo, Gmail) y asegúrese de que el email haya llegado a la bandeja de entrada.

Ha configurado el smarthost tanto en Plesk como en su servicio de retransmisión SMTP. Su smarthost ya está operativo.

Configuring Smarthost for a Domain

You can configure a smarthost for an individual domain. This works in Plesk for Linux with Postfix and Plesk for Windows with either MailEnable or SmarterMail.

To configure a smarthost for a domain:

  1. Choose a reputable SMTP relay service (for example, SendGrid, Mailgun, Mailjet, or similar providers) and create an account there.

  2. Acceso a Plesk.

  3. Go to Websites & Domains > [domain_name] > Mail > Smarthost.

  4. Seleccione la casilla «Enviar el correo de los usuarios a través de un smarthost».

  5. En el campo correspondiente, especifique la dirección IP o el nombre de host de un smarthost (por ejemplo, 192.0.2.1 o smtp.sendgrid.net).

    Nota

    En Plesk para Linux, puede desactivar las búsquedas MX o SRV poniendo el nombre de host o la dirección IP entre corchetes, por ejemplo, [example.com]. Si desea más información, consulte la documentación de Postfix (la sección sobre relayhost).

  6. Si su servicio de retransmisión SMTP requiere autenticación SMTP (y la mayoría de los servicios la requieren), seleccione la casilla «Se requiere autenticación».

  7. Si ha seleccionado «Se requiere autenticación» en el paso anterior, especifique las credenciales para autenticarse en su servicio de retransmisión SMTP.

    Si el servicio soporta la autenticación básica, especifique el nombre de usuario y la contraseña en los campos correspondientes. Si el servicio soporta la autenticación mediante claves de API, en el campo «Nombre de usuario», especifique el nombre de usuario predeterminado utilizado para las claves de API en el servicio (por ejemplo, en SendGrid, el nombre de usuario es apikey) y, en el campo «Contraseña», especifique el valor de la clave de API.

  8. (Opcional) Es posible que desee comprobar si se puede establecer la conexión con el smarthost. Para ello, haga clic en Comprobar conexión.

  9. Haga clic en ACEPTAR.

  10. Update the SPF record in the DNS zone of the domain you configured. This ensures the SMTP relay service is authorized to send mail for this domain.

    Ha configurado el smarthost a nivel de Plesk. Sin embargo, la mayoría de los servicios de retransmisión SMTP comerciales requieren autenticación de dominio a su nivel (también se puede llamar verificación de dominio). Los siguientes servicios de retransmisión SMTP la requieren: SendGrid, Mailjet, Mailgun.

  11. Go to your SMTP relay service account and authenticate the domain you just configured smarhost for in Plesk. For exact steps on how to do so, refer to the documentation of your service.

  12. Envíe un email de prueba a un servicio de email externo (por ejemplo, Gmail) y asegúrese de que el email haya llegado a la bandeja de entrada.

Ha configurado el smarthost tanto en Plesk como en su servicio de retransmisión SMTP. Su smarthost ya está operativo.

If you want to check which domains have an active smarthost, go to Mail> Smarthosts.

image smarthost list

Configuración de un smarthost tras una configuración manual previa

Si ya ha configurado un smarthost manualmente, al habilitar la función de smarthost en Plesk, se sobrescribirá la configuración existente. Aunque Plesk aplica la configuración más común para la mayoría de los servicios de smarthost, es posible que deba modificar la configuración para adaptarla a su smarthost.

Si ya ha configurado un smarthost manualmente, le recomendamos el siguiente algoritmo:

  1. Compare ambas configuraciones de smarthost: la manual y la de Plesk.

  2. Elimine de su configuración manual los parámetros que serán controlados por Plesk.

  3. Deje los parámetros adicionales no cubiertos por Plesk tal como están.

  4. Active la función de smarthost en Plesk.

Para ayudarle a comparar ambas configuraciones, a continuación describimos cómo funciona la función de smarthost entre bastidores: a qué archivos de configuración afecta y de qué manera.

(Plesk para Linux) Configuración del smarthost con Postfix

Nota

Domain‑level smarthosts take priority over the server‑wide smarthost configured in Plesk.

When you enable the smarthost feature, Plesk performs a few actions under the hood.

For server-wide smarthost:

  1. Plesk adds lines of the following pattern to the /etc/postfix/main.cf configuration file:

    # Sets an external SMTP relayhost with a port number
relayhost - [Your-SMTP-server-IP-or-hostname]:587
# Turns on authentication
smtp_sasl_auth_enable = yes
# Sets the username and password required for authentication
smtp_sasl_password_maps = /var/spool/postfix/plesk/relay_secrets
# Prohibits anonymous authentication methods.
smtp_sasl_security_options = noanonymous

  2. Plesk then checks that /etc/postfix/main.cf contains no duplicate directives, which can break the configuration:

    cat /etc/postfix/main.cf | grep -E "relayhost|smtp_sasl_auth_enable|smtp_sasl_password_maps|smtp_sasl_security_options"

  3. Plesk configures the API authentication to the SMTP relay service of your choice via the /etc/postfix/sasl_passwd file. For example, with the SendGrid service, the following line will be added:

    [smtp.sendgrid.net]:2525 apikey:<your-SendGrid-API-key-value>

  4. Finally, Plesk reloads the Postfix service to apply the changes:

    systemctl reload postfix

For a domain-specific smarthost:

  1. If no server-wide smarthost has been previously configured, Plesk adds the required baseline Postfix directives to the /etc/postfix/main.cf configuration file and also adds per-domain routing and credentials (no global relayhost is needed):

    # Turns on authentication
smtp_sasl_auth_enable = yes
# Sets the username and password required for authentication
smtp_sasl_password_maps = hash:/var/spool/postfix/plesk/relay_secrets.db
# Prohibits anonymous authentication methods.
smtp_sasl_security_options = noanonymous
# Enables per‑sender authentication and routing
smtp_sender_dependent_authentication = yes
# Maps sender addresses to specific relay hosts
sender_dependent_relayhost_maps = hash:/var/spool/postfix/plesk/sender_relay.db

  2. Plesk then checks that /etc/postfix/main.cf contains no duplicate directives, which can break the configuration:

    cat /etc/postfix/main.cf | grep -E "smtp_sasl_auth_enable|smtp_sasl_password_maps|smtp_sasl_security_options|smtp_sender_dependent_authentication|sender_dependent_relayhost_maps"

  3. Plesck adds or updates the sender‑dependent mapping files used for domain‑level smarthosts

    • /var/spool/postfix/plesk/sender_relay.db — maps domains to their relay hosts.

    • /var/spool/postfix/plesk/relay_secrets.db — stores credentials for the corresponding relay hosts.

    For example, with the SendGrid service, Plesk writes entries similar to:

    # sender_relay
admin@example.com    [smtp.sendgrid.net]:587

# relay_secrets
[smtp.sendgrid.net]:587    apikey:<your-SendGrid-API-key-value>

  4. Finally, Plesk reloads the Postfix service to apply the changes:

    systemctl reload postfix

(Plesk para Windows) Configuración del smarthost con MailEnable

Cuando se activa la función de smarthost, Plesk aplica la configuración de MailEnable que se muestra en la captura de pantalla siguiente. Utilizamos el servicio de retransmisión SMTP SendGrid como ejemplo.

La primera captura de pantalla muestra la configuración a nivel del servidor, mientras que la segunda muestra la configuración para los dominios.

image smarthost mailenable

image smarthost mailenable domain

Nota

Domain‑level smarthosts take priority over the server‑wide smarthost configured in Plesk.

(Plesk para Windows) Configuración del smarthost con SmarterMail

Cuando se activa la función de smarthost, Plesk aplica la configuración de SmarterMail que se muestra en las capturas de pantalla siguientes. Utilizamos el servicio de retransmisión SMTP SendGrid como ejemplo.

La primera captura de pantalla muestra la configuración a nivel del servidor, mientras que la segunda muestra la configuración para los dominios.

image smarthost smartermail 1

image smarthost smartermail 2

Nota

Domain‑level smarthosts take priority over the server‑wide smarthost configured in Plesk.

Desactivación de la función de smarthost

Puede desactivar la función de smarthost ocultándola en la interfaz gráfica de Plesk.

Para desactivar la función de smarthost:

  1. Abra el archivo panel.ini para proceder con su edición. Este se encuentra en:

    • (Plesk para Linux) /usr/local/psa/admin/conf/panel.ini

    • (Plesk para Windows) %plesk_dir%admin\conf\panel.ini

    También puede editar el archivo en la interfaz de Plesk usando la extensión Panel.ini Editor.

  2. To disable smarthost at the server level, add the following lines to the panel.ini file, and then save it:

    [mail]
smarthost.server.enabled = false

La función de smarthost ya no se muestra en Herramientas y configuración.

  1. To disable smarthost at the domain level, add the following lines to the panel.ini file, and then save it:

    [mail]
smarthost.domain.enabled = false

The smarthost feature is no longer shown in Websites & Domains > [domain_name] > Mail.

Nota

También puede desactivar la función de smarthost activando Modo restringido.

Desactivación de la comprobación de certificados SSL/TLS vinculados con el botón Comprobar conexión

By default, if the connection to a smarthost requires encryption, clicking Check Connection also verifies whether the connection uses a valid SSL/TLS certificate. If the certificate is invalid or missing, the smarthost will refuse the connection.

Si desea establecer la conexión aunque un certificado SSL/TLS no sea de confianza (por ejemplo, si ha expirado o es autofirmado), puede desactivar la comprobación del certificado.

Para desactivar la comprobación de un certificado SSL/TLS vinculado con el botón Comprobar conexión:

  1. Abra el archivo panel.ini para proceder con su edición. Este se encuentra en:

    • (Plesk para Linux) /usr/local/psa/admin/conf/panel.ini

    • (Plesk para Windows) %plesk_dir%admin\conf\panel.ini

    También puede editar el archivo en la interfaz de Plesk usando la extensión Panel.ini Editor.

  2. For disabling the check of the certificate at server level, add the following lines to the panel.ini file, and then save it:

    [mail]
smarthost.server.checkConnection.checkCertificate = false

  3. For disabling the check of the certificate at domain level, add the following lines to the panel.ini file, and then save it:

    [mail]
smarthost.domain.checkConnection.checkCertificate = false

Ahora puede establecer la conexión con un smarthost que no esté protegido con un certificado SSL/TLS válido.