Inicio / Notas técnicas / Fallo de establecimiento del túnel VXLAN

El túnel VXLAN no se establece: vecinos EVPN, rutas Inclusive y VPN Target

Un túnel VXLAN que nunca llega a subir en absoluto es una falla distinta de uno que está activo pero fluctúa, o activo pero al que le falta una ruta. Este es el orden capa por capa que la encuentra — el vecino BGP EVPN, la ruta que realmente construye el túnel, y el cruce de VPN Target que decide si esa ruta es aceptada.

Por Yuwen Zhang (Atlas), fundador de AtlasCommTech — 13 años de despliegues de redes de operadores y empresariales · Actualizado en julio de 2026

Tres capas, divididas por tipo de túnel

Un túnel que nunca se establece falla en exactamente una de tres capas, y la capa depende de si es un túnel L2 o L3.

En un fabric de gateway distribuido BGP EVPN VXLAN, el túnel entre dos VTEP no se configura directamente — se construye dinámicamente una vez recibida la ruta correcta. Un túnel L2 se construye a partir de una ruta Inclusive Multicast de tipo 3; un túnel L3 se construye a partir de una ruta IP Prefix de tipo 5 (también llamada ruta IRB). Cualquiera de las dos rutas solo se acepta si la lista de importación VPN Target local se superpone con lo que el lado remoto exportó. Un túnel que no se establece en absoluto, entonces, falla en exactamente una de estas tres capas: el propio vecino BGP EVPN, la ruta que construye ese tipo específico de túnel, o el cruce de VPN Target que decide si la ruta se deja pasar.

Esto es distinto de un túnel que sube y luego cae, o de uno donde el túnel existe pero falta una ruta específica dentro de él — esas son fallas propias, referenciadas de forma cruzada al final de esta nota. A continuación, la división en tres capas, las comprobaciones display bgp evpn para túneles L2 y L3 en paralelo, las causas detrás de cada capa, y respuestas probadas en campo.

Lea la división antes de tocar cualquier configuración

Las fallas de establecimiento de túnel VXLAN se dividen primero por tipo de túnel — L2 o L3 — y luego por las mismas tres capas subyacentes a ambos.

Un túnel L2 y uno L3 comparten la capa 1 (el vecino BGP EVPN) pero divergen en la capa 2, porque se construyen a partir de dos tipos de ruta EVPN distintos, con dos comandos de configuración distintos a revisar.

VXLAN Tunnel Won't Establish L2 Tunnel -- Type 3 Inclusive Route L3 Tunnel -- Type 5 IP Prefix Route Layer 1 · BGP EVPN neighbor not Establishedshared with the L3 branch -- loopback reachability, TCP session Layer 2 · Inclusive Multicast route not learnedNVE source address, generated locally, received remotely Layer 3 · VPN Target doesn't cross (EVPN instance)no evpn keyword at this level -- import/export-extcommunity Layer 1 · BGP EVPN neighbor not Establishedshared with the L2 branch -- same session, same checks Layer 2 · IP Prefix route not learnedVbdif gateway subnet, generated locally, received remotely Layer 3 · VPN Target doesn't cross (VPN instance)evpn keyword required -- export/import-extcommunity evpn

Las etiquetas del diagrama se mantienen en inglés por claridad técnica.

La capa 1 es compartida — corrija el vecino una vez y ambos tipos de túnel se benefician. Las capas 2 y 3 son específicas del tipo de túnel que persigue, y los comandos realmente difieren entre ellas.

Recorriendo cada capa

Una capa compartida, luego dos capas específicas de cada túnel con su propio tipo de ruta y su propio comando VPN Target.

Capa 1 — El vecino BGP EVPN nunca llega a Established

Ningún tipo de túnel puede construir nada antes de que esta capa esté sólida — revísela primero, sin importar si persigue una falla L2 o L3.

  1. Ejecute display bgp evpn peer. Established con un PrefRcv distinto de cero significa que la capa de vecino está bien; vaya directo a la capa 2 para el tipo de túnel correspondiente.
  2. Si el peer no está Established, encuentre la dirección de origen que cada lado usa para la sesión TCP de BGP (generalmente una Loopback) con display current-configuration configuration bgp, y luego confirme que las dos loopbacks realmente pueden alcanzarse: ping -a <loopback-local> <loopback-remoto>.
  3. Si las loopbacks no pueden alcanzarse, la falla está en el enrutamiento IGP entre los dos VTEP, no en BGP o EVPN en absoluto — corrija eso primero.
  4. Si las loopbacks sí se alcanzan, revise display tcp status para la sesión entre los dos Router ID; si no está claramente Established, algo en la ruta (una ACL, un límite CPCAR, un middlebox) está descartando los propios paquetes TCP de BGP.
<VTEP2> display bgp evpn peer
BGP local router ID : 10.3.3.3
Local AS number : 100
Total number of peers : 2        Peers in established state : 2

 Peer          V      AS MsgRcvd MsgSent OutQ Up/Down             State PrefRcv

 10.1.1.1      4      100    4010    4016     0 0066h46m Established     1
 10.2.2.2      4      100    4009    4010     0 0066h40m Established     4

<VTEP2> ping -a 10.2.2.2 10.3.3.3
Reply from 10.3.3.3: bytes=32 time=1ms TTL=126
Ping statistics for 10.3.3.3:
   Packets: Sent = 4, Received = 4, Lost = 0 (0% loss)
// loopback-to-loopback reachable -> if peer still isn't Established, check TCP session state next

<VTEP2> display tcp status
TCPCB Tid/Soid Local Add:port   Foreign Add:port      VPNID State
49f3370c 262/8 10.2.2.2:53342     10.3.3.3:179       0      Established
49f339f4 262/7 10.2.2.2:55160   10.1.1.1:179       0      Established
// clean Established state here -> the neighbor layer is not the problem

Capa 2, túneles L2 — ruta Inclusive Multicast (tipo 3) no aprendida

Un túnel L2 entre dos VTEP se construye enteramente a partir de este único tipo de ruta — si no está, el túnel tampoco.

  1. Encuentre la dirección de origen NVE propia de este VTEP (display current-configuration interface nve 1) y su máscara (display ip interface brief), luego busque la ruta Inclusive en el formato M:L:X.X.X.X — M siempre es 0, L es la longitud de máscara de la dirección de origen, X.X.X.X es la propia dirección de origen.
  2. Confirme que la ruta se genera localmente: display bgp evpn all routing-table inclusive-route <M:L:X.X.X.X>. Una entrada local muestra From: 0.0.0.0 y lista Advertised to such N peers.
  3. Ejecute la misma búsqueda para la dirección de origen del VTEP remoto, en este VTEP. Si falta, o la ruta no se generó en el lado remoto o no está llegando a este — revise de nuevo la capa de vecino y cualquier route-policy intermedia.
  4. Si la ruta está presente tanto localmente como remotamente, el túnel L2 debería estar construyéndose — pase a la comprobación de VPN Target en la capa 3.
<VTEP2> display current-configuration interface nve 1
interface Nve1
 source 10.2.2.2
 vni 10 head-end peer-list protocol bgp

<VTEP2> display bgp evpn all routing-table inclusive-route 0:32:10.2.2.2
Total routes of Route Distinguisher(1:10): 1
BGP routing table entry information of 0:32:10.2.2.2:
Imported route.
From: 0.0.0.0 (0.0.0.0)
Ext-Community: RT <1 : 100>, RT <10 : 1>, Tunnel Type <VxLan(8)>
Route Type: 3 (Inclusive Multicast Route)
Advertised to such 2 peers:
   10.3.3.3
   10.1.1.1
// From: 0.0.0.0 = generated locally; check the same prefix for the remote VTEP's source address next

Capa 2, túneles L3 — ruta IP Prefix (tipo 5) no aprendida

Un túnel L3 se construye a partir de la ruta IP Prefix del gateway en su lugar — misma idea, distinto tipo de ruta y distinto comando.

  1. Encuentre la dirección de gateway Vbdif y la máscara para la subred en cuestión: display current-configuration interface vbdif <ID-BD>. El dispositivo genera automáticamente la ruta IP Prefix a partir de esta dirección de gateway.
  2. Busque la ruta en el formato L:X.X.X.X:M (L siempre es 0, X.X.X.X:M es la subred del gateway): display bgp evpn all routing-table prefix-route <L:X.X.X.X:M>.
  3. Confirme que el mismo prefijo aparece bajo la entrada VPN-Instance correspondiente, no solo en la address-family EVPN — un túnel L3 necesita que la ruta se resuelva en la tabla de enrutamiento propia de la instancia VPN, no solo visible a nivel EVPN.
  4. Si falta en el lado remoto, trabaje de nuevo la capa 1 para ese peer; si está presente remotamente pero falta localmente, pase a la comprobación de VPN Target.
<VTEP2> display current-configuration interface vbdif 10
interface Vbdif10
 ip binding vpn-instance vpn1
 ip address 192.168.10.1 255.255.255.0

<VTEP2> display bgp evpn all routing-table prefix-route 0:24:192.168.20.0
Total routes of Route Distinguisher(3:100): 1
BGP routing table entry information of 0:192.168.20.0:24:
Ext-Community: RT <1 : 100>, Tunnel Type <VxLan(8)>
Route Type: 5 (Ip Prefix Route)

VPN-Instance vpn1, Router ID 10.2.2.2:
BGP routing table entry information of 192.168.20.0/24:
Relay Tunnel Out-Interface: VXLAN
// showing up under VPN-Instance vpn1, not just the EVPN address family, is what confirms the L3 tunnel can actually use it

Capa 3 — El VPN Target no cruza (comando distinto para cada tipo de túnel)

La ruta llegó; el lado local todavía tiene que dejarla entrar — y el comando que controla eso es distinto para túneles L2 y L3.

  1. Para un túnel L2, compare los valores Ext-Community RT de la ruta Inclusive recibida con la instancia EVPN de este VTEP: display current-configuration configuration evpn-instance <nombre>. Busque vpn-target ... import-extcommunity (sin la palabra clave evpn al final).
  2. Para un túnel L3, en cambio, compare los valores Ext-Community RT de la ruta IP Prefix recibida con la instancia VPN de este VTEP: display current-configuration configuration vpn-instance <nombre>. Busque vpn-target ... import-extcommunity evpn — note la palabra clave evpn final, fácil de omitir por costumbre si está acostumbrado a escribir la forma L2.
  3. En cualquier caso, solo un valor RT tiene que superponerse entre lo recibido y lo configurado para importar — si no hay superposición en absoluto, agregue el valor faltante a la línea import-extcommunity correspondiente en lugar de cambiar el lado remoto.
// L2 -- EVPN instance, no "evpn" keyword
<VTEP2> display current-configuration configuration evpn-instance evpn10
evpn vpn-instance evpn10 bd-mode
 vpn-target 1:100 10:1 export-extcommunity
 vpn-target 10:1 import-extcommunity

// L3 -- VPN instance, "evpn" keyword required
<VTEP2> display current-configuration configuration vpn-instance vpn1
ip vpn-instance vpn1
 ipv4-family
  vpn-target 1:100 export-extcommunity evpn
  vpn-target 1:100 import-extcommunity evpn
 vxlan vni 100

5 causas que aparecen una y otra vez

Una vez que las tres capas anteriores le han indicado dónde está el problema, estas cinco causas explican la mayor parte de lo que realmente falla.

1. El vecino BGP EVPN nunca llega a Established porque las loopbacks no pueden enrutarse entre sí

SÍNTOMAdisplay bgp evpn peer muestra un peer atascado indefinidamente en un estado no Established, y nada río abajo — ni ruta Inclusive, ni ruta IP Prefix — tiene con qué construirse.

CAUSATanto las rutas que construyen el túnel L2 como las del L3 viajan sobre la misma sesión BGP EVPN, y esa sesión se origina desde una Loopback en cada VTEP. Si el IGP entre los dos VTEP no lleva realmente una ruta hacia la Loopback del peer, la sesión TCP detrás de BGP no puede formarse en absoluto, y parece un problema de EVPN cuando en realidad es de IGP.

SOLUCIÓNHaga Ping desde la dirección de origen Loopback local directamente hacia la remota (ping -a <local> <remoto>) antes de tocar cualquier configuración de EVPN o VPN-target — si eso falla, corrija primero la ruta IGP.

2. Algo en la ruta descarta silenciosamente la sesión TCP de BGP

SÍNTOMALas dos Loopbacks se hacen ping mutuamente sin problema, pero display bgp evpn peer sigue sin llegar a Established.

CAUSALa alcanzabilidad entre las dos loopbacks confirma que el enrutamiento está bien, pero no confirma que la propia sesión TCP de BGP sobreviva a la ruta — una ACL de defensa de CPU, un límite de tasa CPCAR, o un middlebox en algún punto intermedio puede descartar silenciosamente el tráfico del puerto TCP 179 mientras el ICMP sigue pasando limpiamente.

SOLUCIÓNRevise display tcp status para el estado real de la sesión entre los dos Router ID; si no está claramente Established, busque límites CPCAR o ACL en la ruta que afecten específicamente al puerto TCP 179, no solo la alcanzabilidad general.

3. La ruta Inclusive del túnel L2 se genera bien localmente pero nunca se acepta remotamente

SÍNTOMAdisplay bgp evpn all routing-table inclusive-route en el VTEP de origen muestra la ruta con From: 0.0.0.0 y la lista como anunciada al peer remoto — pero la propia búsqueda del VTEP remoto para el mismo prefijo no devuelve nada.

CAUSALa ruta Inclusive Multicast del túnel L2 solo se acepta en el extremo remoto si el import-extcommunity de la instancia EVPN de ese VTEP comparte un valor con el RT con el que se exportó la ruta — sin superposición, la ruta se descarta silenciosamente al llegar, sin error en ninguno de los dos lados.

SOLUCIÓNCompare el import-extcommunity de la evpn-instance del VTEP remoto directamente con los valores Ext-Community RT mostrados en la ruta anunciada del lado de origen, no con lo que usted supone que se configuró.

4. La ruta Prefix del túnel L3 está configurada en un nivel completamente equivocado

SÍNTOMALa ruta IP Prefix parece generarse correctamente e incluso aparece en la address-family EVPN en el VTEP receptor, pero el túnel hacia ese gateway sigue sin construirse y la subred permanece inalcanzable.

CAUSAUn túnel L3 necesita que su VPN Target esté configurado bajo la ipv4-family de la instancia VPN con la palabra clave evpn final (vpn-target ... export-extcommunity evpn / import-extcommunity evpn) — configurarlo como un vpn-target simple sin esa palabra clave, o configurarlo bajo la instancia EVPN en su lugar (que es donde pertenece la forma L2), deja la ruta visible a nivel EVPN pero nunca resuelta en la tabla de enrutamiento propia de la instancia VPN.

SOLUCIÓNConfirme con display current-configuration configuration vpn-instance <nombre> que las líneas export/import-extcommunity llevan ambas la palabra clave evpn, y que la ruta aparece específicamente bajo la entrada VPN-Instance en la salida de la tabla de enrutamiento, no solo en la sección de address-family EVPN de arriba.

5. Los túneles L2 y L3 hacia el mismo peer fallan de forma independiente — corregir uno no corrige el otro

SÍNTOMADespués de resolver un problema de establecimiento de túnel L2 entre dos VTEP, el túnel L3 entre los mismos dos dispositivos sigue sin subir, y parece que la corrección anterior no funcionó.

CAUSALos dos tipos de túnel solo comparten la capa de vecino BGP EVPN — todo lo que está por encima (el tipo de ruta, el nivel de configuración de VPN Target, el comando específico de import/export) es independiente entre L2 y L3. Corregir una discrepancia de RT a nivel de instancia EVPN no hace nada por una discrepancia de RT a nivel de instancia VPN en el mismo equipo.

SOLUCIÓNTrate una corrección L2 y una corrección L3 como dos tickets separados en el mismo par de vecinos, y vuelva a ejecutar las comprobaciones de capa 2 y capa 3 para cada tipo de túnel por separado, incluso después de que el otro se confirme funcionando.

Diseños de soluciones relacionadas

Seis preguntas que surgen constantemente

Sacadas directamente del terreno — las que vale la pena tener una respuesta lista.

display bgp evpn peer muestra Established — ¿por qué el túnel todavía no está ahí?

Established solo confirma que la sesión del plano de control BGP EVPN está activa entre los dos VTEP. El túnel en sí todavía necesita que su tipo de ruta — Inclusive Multicast para L2, IP Prefix para L3 — se genere, anuncie, reciba, y acepte mediante el cruce de VPN Target. Un vecino saludable con una ruta faltante o rechazada sigue sin producir túnel.

¿Qué diferencia real hay entre una ruta Inclusive Multicast y una ruta IP Prefix?

Inclusive Multicast (tipo de ruta 3) es lo que construye un túnel VXLAN L2 — está ligada a la dirección de origen NVE del VTEP y no lleva información de host en absoluto, solo «este VTEP existe y es alcanzable para este VNI». IP Prefix (tipo de ruta 5) es lo que construye un túnel L3 — está ligada a una subred de gateway (Vbdif) específica y es lo que un gateway IRB anuncia para que otros VTEP puedan enrutar hacia esa subred a través de él.

Mis valores de VPN Target son idénticos en ambos extremos — ¿por qué la ruta sigue siendo descartada?

Revise en qué nivel de comando realmente lo configuró. Para un túnel L2, el VPN Target vive bajo la instancia EVPN (evpn vpn-instance ... vpn-target ... export/import-extcommunity, sin palabra clave final); para un túnel L3 vive bajo la ipv4-family de la instancia VPN con la palabra clave evpn (vpn-target ... export/import-extcommunity evpn). Números RT de apariencia idéntica configurados en el nivel equivocado, o la falta de la palabra clave evpn en el lado L3, producen exactamente este síntoma.

¿En qué se diferencia un túnel que «no se establece» de uno que está activo pero fluctúa, cubierto en la otra nota VXLAN?

Esta nota asume que el túnel literalmente nunca ha subido — ningún estado Established de BGP EVPN, o ninguna ruta Inclusive/IP Prefix jamás aceptada. Si el túnel sí se estableció y luego cae, fluctúa, o sube bien pero una migración de VM o un flujo de tráfico específico se comporta de forma extraña, esas son comprobaciones distintas — vea la nota Fallas de overlay VXLAN, que retoma desde un túnel que ya existe.

El túnel no se establece, pero no encuentro ninguna ruta faltante en ningún lado — ¿qué más puede ser?

Si cada comprobación de ruta de esta nota vuelve limpia — vecino Established, ruta Inclusive o IP Prefix generada y recibida, VPN Target superpuesto — y el túnel sigue sin reenviar tráfico, la falla ha pasado más allá del establecimiento del túnel hacia una categoría distinta: revise si falta la ruta EVPN de un host específico en lugar del propio túnel, cubierto en la nota Ruta EVPN no aprendida.

¿Puedo ejecutar todos estos comandos display y ping en un fabric de producción en vivo?

Sí — todos los comandos de esta nota son de solo lectura excepto el ping loopback-a-loopback usado para probar la alcanzabilidad, que no toca el plano de datos del fabric. Ninguno requiere cambios de configuración solo para diagnosticar, así que no hay razón para esperar una ventana de mantenimiento antes de ejecutar las comprobaciones en sí.

Límites honestos de esta nota

Límites honestos de esta nota

Esta nota se basa en el fabric de gateway distribuido BGP EVPN de estilo Huawei CloudEngine y sus comandos display bgp evpn peer / display bgp evpn all routing-table inclusive-route / prefix-route / display current-configuration configuration evpn-instance / vpn-instance, además de los casos de campo que los respaldan. Asume un diseño EVPN VXLAN estándar de dos niveles (L2 + L3) y no cubre el aprovisionamiento automático de underlay/overlay orquestado por controlador (fabric SDN), donde estos mismos síntomas pueden remontarse al controlador en lugar de a la configuración del dispositivo mostrada aquí.

¿El túnel entre dos VTEP todavía no sube?

Cuéntenos en qué capa está atascado — vecino, ruta, o VPN Target — además de si es un túnel L2 o L3, y la salida relevante de display bgp evpn, y le ayudamos a interpretarla.

WhatsApp con un ingeniero →

Lectura relacionada

Solo usamos cookies para analítica anónima — sin publicidad ni rastreo entre sitios.Política de privacidad