> For the complete documentation index, see [llms.txt](https://docs.violetlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.violetlabs.com/es/recursos/administrativo/conecte-software-autoalojado/tunel-vpn.md).

# Túnel VPN

### Conecta software autohospedado mediante un túnel VPN

Permite a Violet conectarse directamente a tus herramientas de software autohospedado estableciendo un túnel de red privada virtual (VPN). Esto proporciona una conexión segura y cifrada de punto a punto que oculta tu dirección IP.&#x20;

{% hint style="warning" %}
Las instrucciones a continuación son específicas de [Tailscale](https://tailscale.com/), nuestra solución VPN recomendada.

Tailscale utiliza una topología de red en malla y el protocolo WireGuard para proporcionar conexiones de red seguras y completamente cifradas.

Si prefieres una solución sitio a sitio/IPsec en su lugar, salta a la [página siguiente](https://docs.violetlabs.com/es/recursos/administrativo/conecte-software-autoalojado/tunel-vpn-sitio-a-sitio.md).
{% endhint %}

#### **Configuración de una VPN de Tailscale**

[Tailscale](https://tailscale.com/) es una solución de VPN que simplifica la configuración de redes seguras para acceder a tus aplicaciones locales. Usa WireGuard para cifrar el tráfico de red y admite diversos dispositivos como Linux, macOS, Windows e incluso servidores en la nube.&#x20;

#### **Requisitos previos**

1. Un servidor o equipo que pueda actuar como tu puerta de enlace VPN de Tailscale para tus aplicaciones locales (AWS EC2, Azure VM, Google Compute Engine, etc.)
2. Privilegios de administrador en todos los dispositivos que formarán parte de la red VPN
3. Acceso a Internet para instalar Tailscale

***

#### **Paso 1: Configura tu cuenta de Tailscale**

1. **Regístrate** para obtener una cuenta de Tailscale en [tailscale.com](https://tailscale.com/).
2. Después de registrarte, podrás acceder a la consola de administración en `https://login.tailscale.com/admin`.

***

#### **Paso 2: Instala Tailscale en tu servidor puerta de enlace**

1. **Elige una máquina** dentro de tu red para que actúe como puerta de enlace (por ejemplo, un servidor o una VM dedicada).
2. **Instala Tailscale** en tu máquina Linux de puerta de enlace:

   ```bash
   curl -fsSL <https://tailscale.com/install.sh> | sh
   ```
3. **Autentica** la máquina ejecutando el siguiente comando:

   ```bash
   sudo tailscale up
   ```

   * Esto abrirá un navegador para que inicies sesión y autentiques el dispositivo en tu cuenta de Tailscale.
   * Una vez autenticada, la máquina aparecerá en tu consola de administración de Tailscale bajo **Máquinas**.

***

#### **Paso 3: Habilita el enrutamiento de subred en la puerta de enlace**

El enrutamiento de subred permite que los dispositivos fuera de tu red local accedan a recursos internos a través de la máquina puerta de enlace.

1. **Identifica la subred** que quieres enrutar (por ejemplo, `<subnet-to-route>`).
2. En la máquina puerta de enlace, ejecuta el siguiente comando:

   ```bash
   sudo tailscale up --advertise-routes=<subnet-to-route>
   ```

   Reemplaza `<subnet-to-route>` por la subred adecuada de tu red.
3. Después de habilitar el enrutamiento de subred, ve a la consola de administración de Tailscale y **aprueba la ruta**:
   * Ve a la **Máquinas** página.
   * Busca la máquina puerta de enlace y haz clic en el ícono de engranaje junto a ella.
   * En **Configuración de rutas**, aprueba la ruta anunciada.

***

#### **Paso 4: Instala Tailscale en tu(s) dispositivo(s) cliente**

1. Instala Tailscale en cualquier dispositivo que se conectará a tu VPN (por ejemplo, portátiles, servidores remotos).
   * Sigue la [guía de instalación](https://tailscale.com/kb/1347/installation) para tu plataforma específica (Linux, Windows, macOS).
2. **Autentica** cada dispositivo cliente con tu cuenta de Tailscale usando:

   ```bash
   sudo tailscale up
   ```
3. Una vez que los dispositivos cliente estén autenticados, aparecerán en tu consola de administración como parte de tu red de Tailscale.

***

#### **Paso 5: Accede a las aplicaciones**

Ahora que la VPN de Tailscale está configurada, cualquier dispositivo de tu red de Tailscale puede acceder a los recursos locales a través de la máquina puerta de enlace.

1. **Prueba de ping**: Desde un dispositivo cliente, puedes intentar hacer ping a una dirección IP interna dentro de tu red local para comprobar la conectividad:

   ```shellscript
   ping <internal-ip-address>
   ```
2. **Accede a tus aplicaciones**: Si tienes una aplicación web ejecutándose en un servidor dentro de tu red local, simplemente accede a ella usando la IP interna (por ejemplo, `http:/<internal-ip-addr>:8080`).

***

#### Paso 6: Configura la autenticación

Recomendamos activar OAuth para la conexión de Tailscale. Para hacerlo:

1. Inicia sesión en tu Tailnet como administrador y ve a [Credenciales de confianza](https://login.tailscale.com/admin/settings/trust-credentials)
2. Crea una nueva **credencial**. Selecciona **OAuth** como tipo
3. Habilita los alcances `Dispositivos: Core: Escritura` y `Claves: Claves de autenticación: Escritura`
   1. Nota: Se te pedirá seleccionar una etiqueta para estos alcances. Si no tienes ninguna etiqueta, crea una nueva llamada `violet` en [Controles de acceso](https://login.tailscale.com/admin/acls/visual/tags)
4. Haz clic en **Generar credenciales**
5. Comparte de forma segura el ID de cliente y el secreto de cliente con Violet a través de la **Credenciales** página en tu entorno de Violet.

Alternativamente, puedes utilizar una clave de autenticación simple para la autenticación, pero te pediremos que generes una clave única cada 90 días. Sigue las instrucciones de Tailscale [aquí](https://tailscale.com/kb/1085/auth-keys) para generar una, asegurándote de que la clave de autenticación sea **reutilizable**, no de un solo uso.

También puede ser útil compartir una dirección IP o dominio en tu red privada que Violet pueda hacer ping para probar la conexión.

***

### **Consejos para solucionar problemas**

* **Comprueba la conectividad del dispositivo**: Asegúrate de que tus dispositivos sean visibles en la consola de administración de Tailscale y estén conectados a la misma red.
* **Problemas con el firewall**: Asegúrate de que el firewall de tu servidor local permita conexiones entrantes desde la subred de Tailscale.
* **Las rutas no aparecen**: Asegúrate de que la máquina puerta de enlace anuncie correctamente las rutas usando `sudo tailscale up --advertise-routes=<your-subnet>`.
* **Demasiados dispositivos antiguos en Tailscale:** Si los hosts se reinician o reemplazan con frecuencia, cambia a claves efímeras emitidas por OAuth para esos nodos, de modo que las máquinas inactivas se eliminen automáticamente.

***

### Recursos adicionales

Recomendamos consultar [Inicio rápido de Tailscale](https://tailscale.com/kb/1017/install) para obtener información más detallada.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.violetlabs.com/es/recursos/administrativo/conecte-software-autoalojado/tunel-vpn.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
