> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/es/administracion-del-sistema/usb-passthrough.md). # Passthrough USB Cómo configurar el passthrough de dispositivos USB en VergeOS, incluyendo configuración del host, creación de grupos de recursos, configuración del sistema invitado de la VM y transferencia de dispositivos USB a tenants. Los dispositivos USB conectados a un host pueden pasarse a las VMs (y los inquilinos pueden pasarlos a sus VMs), lo que permite que un dispositivo aparezca y se comporte como si estuviera conectado directamente dentro de la VM. Los ejemplos de dispositivos USB para passthrough incluyen: * unidades que contienen claves de licencia de software * cámaras de seguridad/equipos de monitoreo * teclado/ratón (compatible con el uso entre varias VMs; a menudo más conveniente que las configuraciones de arranque dual/múltiple de VMs para hardware especializado) ## Instalación/Configuración del host Las siguientes instrucciones configurarán el passthrough de dispositivos creando automáticamente una nueva regla para cada dispositivo seleccionado y adjuntando el/los dispositivo(s) al grupo de recursos. Para obtener más información sobre cómo funcionan los grupos de recursos y las reglas de recursos, consulte: [**Passthrough de dispositivos - Reglas de recursos**](/run-the-platform/es/administracion-del-sistema/device-pass-overview.md#resource-rules). 1. Vaya al **Panel de Resource Manager** (*Infraestructura > Recursos*) **-O-** Vaya a un **nodo específico** donde estén conectados los dispositivos USB. (*Infraestructura > Nodos* > haga doble clic en el nodo deseado de la lista.) 2. Haga clic en **Dispositivos USB**. Se mostrará la lista de dispositivos USB detectados. {% hint style="success" %} **Un dispositivo USB que muestre un valor en la columna *****Grupo de recursos***** y *****Reglas de recursos***** ya está configurado para passthrough.** {% endhint %} 3. **Seleccione** el/los **dispositivo(s) USB** apropiado(s) de la lista. {% hint style="info" %} **Todos los dispositivos seleccionados se agregarán al mismo grupo de recursos (grupo de recursos), pero se creará una regla de recursos independiente para cada uno.** {% endhint %} 4. Haga clic en **Crear recurso** en el menú de la izquierda. 5. **Crear un nuevo grupo de recursos USB** **-O-** **Seleccione un grupo de recursos USB** apropiado(s) de la lista. ### Campos del grupo de recursos USB * **Nombre**: etiqueta utilizada para identificar el grupo de recursos (es decir, el grupo de dispositivos); use un nombre descriptivo para que los usuarios puedan identificar fácilmente el tipo de dispositivo(s) de este grupo. * **Tipo**: ***USB***. * **Descripción**: (opcional) campo para proporcionar más texto administrativo sobre el grupo de recursos. * **Clase**: permite seleccionar una clasificación general de dispositivos para el grupo; por ejemplo, dispositivo USB genérico, dispositivo de entrada humana, medios, etc. Este campo solo se usa para aplicar un icono asociado y no afecta la funcionalidad. #### Configuración de USB * **Permitir reinicio del invitado**: Cuando está marcada, el usuario de la VM puede reiniciar el dispositivo USB. * **Permitir que el invitado reinicie todo**: Cuando está marcada, el usuario de la VM puede reiniciar el concentrador USB al que está conectado el dispositivo. {% hint style="info" %} **La acción de reinicio de un dispositivo USB depende del controlador del dispositivo; algunos dispositivos admiten un reinicio y otros no.** {% endhint %} Después de seleccionar el grupo de recursos o crear uno nuevo, debería aparecer un mensaje de \**Éxito* \* que indique que se crearon reglas de recursos para el/los dispositivo(s). 6. **Puede ser necesario reiniciar el/los nodo(s) asociado(s)**; aparecerá un mensaje en la parte superior del panel de Resource Manager. {% hint style="warning" %} **Siga los** [**procedimientos adecuados de Modo de mantenimiento**](/run-the-platform/es/operaciones/maintenance-mode.md) **al reiniciar un nodo para evitar interrupciones de las cargas de trabajo.** {% endhint %} El panel del grupo de recursos contiene las reglas de recursos que se generaron automáticamente para los dispositivos seleccionados. Puede hacer clic en una regla individual para ver los detalles de configuración. Una regla creada por el sistema puede modificarse según sea necesario; por ejemplo, el filtro de *Nodo* puede cambiarse a *-- Ninguno --* para incluir los dispositivos coincidentes de todos los nodos. La información sobre las reglas de recursos está disponible en: [**Descripción general del passthrough de dispositivos - Reglas de recursos**](/run-the-platform/es/administracion-del-sistema/device-pass-overview.md#resource-rules) ## Configuración de la VM/invitado 1. Vaya al **panel de la VM** (desde el menú superior: Máquinas virtuales > Lista > haga doble clic en la VM deseada en la lista) 2. Haga clic en **Dispositivos** en el menú de la izquierda. 3. Haga clic en **Nuevo** en el menú de la izquierda. {% hint style="success" %} **También puede adjuntar dispositivos a una VM mediante Resource Manager: desde el panel de Grupo de recursos > haga doble clic en el grupo SR-IOV deseado > Ver dispositivos de la máquina > Nuevo; seleccione la VM en la lista desplegable Máquina.** {% endhint %} ### Campos del formulario de entrada del dispositivo * **Nombre**: proporcione un nombre para identificar el dispositivo, por ejemplo, "exapp license key", o deje el campo en blanco para permitir que el sistema genere automáticamente un nombre de dispositivo. * **Tipo**: ***USB*** * **Descripción**(opcional): aquí se puede introducir texto adicional con fines administrativos. * **Grupo de recursos**: seleccione el grupo de recursos USB apropiado de la lista desplegable * **Configuración de USB**: ver arriba. 4. Haga clic en **Enviar** para completar la adición del nuevo dispositivo. 5. Instale cualquier controlador de cliente requerido; consulte la documentación de hardware del dispositivo, si es necesario. 6. La VM necesitará un **reinicio** para adjuntar el dispositivo. Desde el panel de la VM, haga clic en el *Reiniciar* enlace del mensaje que aparece en la parte superior del panel, o haga clic en **Reiniciar** en el menú de la izquierda. ## Pasar un dispositivo USB a un inquilino Los dispositivos USB pueden pasarse a un inquilino para que este los pase a sus propias VMs. Cuando pasa dispositivos USB al inquilino, se crea un nuevo grupo de recursos dentro del inquilino. {% hint style="info" %} **Cuando los dispositivos se comparten con un inquilino, se aprovisionan en modo thick (es decir, el inquilino pasa a ser propietario de los dispositivos, por lo que no pueden asignarse a otras VMs o inquilinos aunque no se estén usando).** {% endhint %} 1. Vaya al deseado **panel del inquilino** (desde el menú superior: Inquilinos > Lista > haga doble clic en el inquilino dentro de la lista.) 2. Haga clic en **Nodos** en el menú de la izquierda. 3. **Haga doble clic en uno de los nodos del inquilino**. 4. Haga clic en **Dispositivos** en el menú de la izquierda. 5. Haga clic en **Nuevo** en el menú de la izquierda. 6. Introduzca un **Nombre** o deje en blanco para permitir que el sistema cree automáticamente un nombre; este nombre se utilizará para el grupo de recursos creado en el inquilino. 7. **Tipo**: ***USB***. 8. **Descripción**: proporciona un lugar para almacenar información administrativa adicional sobre el dispositivo/el grupo de dispositivos. 9. **Configuración de USB**: ver arriba. 10. Cuando se completen los campos, haga clic en **Enviar** para finalizar el traspaso al inquilino. 11. El/los dispositivo(s) ahora estarán disponibles como un grupo de recursos para adjuntar a las VMs del inquilino. Siga las [**Configuración de la VM/invitado**](#vmguest-configuration) instrucciones anteriores. Para usar el dispositivo de passthrough, la VM debe ejecutarse en el nodo del inquilino donde está conectado el dispositivo. ## Solución de problemas ### La VM no logra iniciarse después de reiniciar un nodo **Síntoma:** Una VM con un dispositivo USB de passthrough no logra iniciarse después de que se reinicia su nodo host (por ejemplo, después de una actualización de VergeOS). La VM intenta iniciarse repetidamente, pero no puede abrir el dispositivo USB. **Causa:** La regla de recursos generada automáticamente identifica el dispositivo usando su dirección física de bus (el filtro de ruta). Esa dirección se asigna cada vez que el dispositivo USB se enumera. Los cambios en la topología del hardware del servidor, como agregar o quitar dispositivos PCI, pueden alterar la forma en que el controlador USB presenta sus puertos, lo que da como resultado una ruta diferente. En una pequeña minoría de sistemas, el firmware de la placa base puede volver a enumerar los puertos USB de manera diferente después de un reinicio del controlador, lo que hace que la ruta cambie incluso sin modificaciones de hardware. Cuando el dispositivo aparece en una nueva dirección, la regla ya no coincide con un dispositivo activo, impidiendo que la VM se inicie. **Solución:** Edite la regla de recursos para que coincida con el dispositivo mediante sus ID de hardware estables en lugar de la dirección física: 1. Vaya a **Infraestructura > Recursos**. 2. En la ***Reglas*** sección, localice la regla generada automáticamente para el dispositivo USB. 3. **Haga doble clic en la regla** para abrirla y editarla. 4. Active los **ID del proveedor** (`vendor_id`) y **ID del modelo** (`model_id`) campos de filtro. El ID del modelo es el ID de producto USB. 5. Active los **Serie** campo (solo dispositivos compatibles) para fijar la regla a un dispositivo específico. La mayoría de las memorias USB, discos duros/SSD externos, cámaras web e impresoras/escáneres de marcas reconocidas incluyen una serie única programada de fábrica. 6. Desactive los campos de filtro de ubicación física (ruta y dispositivo) si su servidor no asigna una ruta PCI coherente entre reinicios. También puede desactivar estos campos si desea que la regla coincida con el dispositivo independientemente del puerto USB en el que esté conectado. 7. Haga clic en **Enviar** para guardar la regla. 8. Inicie la VM. El proveedor, el ID del modelo y el número de serie son estables entre reinicios, por lo que la regla coincide con el dispositivo independientemente de cómo se vuelva a enumerar. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/es/administracion-del-sistema/usb-passthrough.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.