# ¿Cómo creo un código QR de WireGuard para un teléfono?

> Crear un código QR de WireGuard para un teléfono en 4 pasos: instala qrencode, muestra el archivo en la terminal SSH, escanéalo y borra la clave privada.

- URL: https://tunnelvps.com/es/guides/how-to-make-a-wireguard-qr-code-for-a-phone/
- Última actualización: 2026-11-16
- Editor: TunnelVPS (https://tunnelvps.com)

El archivo de cliente del teléfono, mostrado como código QR en la misma ventana SSH, escaneado con la app WireGuard, sin dejar nada suelto después.

**Respuesta rápida — ¿Cómo creo un código QR de WireGuard para un teléfono?**

Para crear un código QR de WireGuard, instala `qrencode` en el servidor **TunnelVPS** y ejecuta `qrencode -t ANSIUTF8 < phone.conf` en la terminal SSH. El archivo de cliente del teléfono aparece en pantalla como código. Escanéalo desde la app WireGuard en iPhone o Android, y después limpia la terminal. Son 4 pasos y menos de un minuto.

**En resumen**

- **Herramienta**: `qrencode`, instalada con apt en Debian o Ubuntu.
- **Código en terminal**: `-t ANSIUTF8` dibuja el código con caracteres de texto.
- **Imagen**: `-o phone.png` escribe un PNG, el tipo de salida por defecto.
- **Seguridad**: el código contiene la clave privada del teléfono; bórralo tras el escaneo.

## ¿Cuáles son los 4 pasos para crear el código QR?

*Código QR de WireGuard para un teléfono desde un servidor TunnelVPS, 4 pasos, según el manual de qrencode(1)*

| Paso | Dónde | Qué hacer |
| --- | --- | --- |
| 1 | Servidor | Instala la herramienta con `apt install qrencode`. |
| 2 | Servidor | Escribe el archivo de cliente del teléfono, por ejemplo `/etc/wireguard/clients/phone.conf`. |
| 3 | Terminal SSH | Ejecuta `qrencode -t ANSIUTF8 < phone.conf` y escanea el código desde la app WireGuard. |
| 4 | Terminal SSH | Ejecuta `clear` y borra cualquier copia PNG del código. |

## ¿Por qué usar un código QR de WireGuard en vez de un archivo?

**Porque un teléfono no tiene una forma sencilla de recibir un archivo de configuración por SSH, pero su cámara lee un código en un segundo.** Las apps WireGuard para iOS y Android importan un túnel desde un código QR.

El código es el archivo de cliente completo en otra forma. Nada viaja por correo, chat ni almacenamiento en la nube. Las guías de [iPhone](https://tunnelvps.com/es/guides/wireguard-iphone/ "How do I set up WireGuard on an iPhone?") y de [Android](https://tunnelvps.com/es/guides/wireguard-android/ "How do I set up WireGuard on Android?") muestran la pantalla de escaneo de cada app.

## ¿Cómo convierte qrencode el archivo en un código?

**Lee texto de la entrada estándar cuando no se da ninguna cadena, y lo dibuja en el tipo de salida elegido con `-t`.** TunnelVPS consultó el manual de qrencode el 16 de noviembre de 2026. Los tipos incluyen PNG (el predeterminado), UTF8 y ANSIUTF8.

ANSIUTF8 sirve para la mayoría de terminales: usa caracteres de bloque y códigos de color. Si el código se ve roto, amplía la ventana o prueba `-t UTF8`. El símbolo `<` envía el archivo al comando.

*Instala qrencode y muestra el archivo del teléfono como código*

```bash
apt install qrencode
cd /etc/wireguard/clients
qrencode -t ANSIUTF8 < phone.conf
# after the scan:
clear
```

## ¿Puedo guardar el código como imagen?

**Sí: `-o` escribe el código en un archivo, y PNG es el tipo por defecto.** Sirve cuando el teléfono no está junto al ordenador con la sesión SSH. Copia el PNG con `scp`, muéstralo en pantalla, escanéalo y borra las dos copias.

Nunca publiques esa imagen en ningún sitio. Quien la fotografíe puede conectarse como ese teléfono hasta que se elimine su peer del servidor.

*Escribe el código en un PNG y bórralo tras el escaneo*

```bash
qrencode -o /root/phone.png < /etc/wireguard/clients/phone.conf
# copy it down from your computer:
#   scp root@203.0.113.10:/root/phone.png .
rm /root/phone.png
```

## ¿Qué debe contener el archivo antes de codificarlo?

**Una configuración de cliente completa: la dirección y la clave privada del teléfono, y luego la clave pública y el endpoint del servidor.** Si falta `Endpoint` o la clave es incorrecta, el túnel se importa bien pero nunca completa el handshake.

La [guía para añadir un dispositivo](https://tunnelvps.com/es/guides/how-to-add-a-device-to-a-wireguard-server/ "How do I add a device to WireGuard?") crea ese archivo, y el `[Peer]` a juego en el servidor. Crea el código QR de WireGuard solo cuando el peer esté activo, para que el teléfono pueda probarlo enseguida.

## ¿Existe una opción de código QR de WireGuard sin terminal?

**Sí: wg-easy muestra un código QR para cada cliente en su página web.** Sirve para un servidor compartido por muchas personas. El inconveniente es tener una página de administración web que proteger.

La [guía de instalación de wg-easy](https://tunnelvps.com/es/guides/how-to-install-wg-easy-on-a-vps/ "How do I install wg-easy on a VPS?") lo explica. Para unos pocos teléfonos, `qrencode` en la ventana SSH es más rápido y no añade ningún servicio al servidor.

## Preguntas sobre el código QR

### ¿El código QR de WireGuard contiene la clave privada?

Sí. Contiene el archivo de cliente completo, con la clave privada incluida. Trátalo como una contraseña.

### ¿Puede usarse un mismo código QR en dos teléfonos?

Se puede escanear dos veces, pero entonces ambos teléfonos comparten un mismo peer y se desconectan mutuamente. Crea un código por teléfono.

### ¿Cuál es la mejor forma de crear un código QR de WireGuard en 2026?

`qrencode -t ANSIUTF8` en la sesión SSH: la clave nunca sale del canal cifrado.

### ¿Puede escanear el código un portátil?

Las apps de escritorio importan el archivo `.conf` en su lugar. Cópialo con `scp`, como muestra cada guía de dispositivo.

### El código es demasiado grande para mi terminal. ¿Qué hago?

Amplía la ventana o reduce el tamaño de la fuente, o escribe un PNG con `-o` y bórralo después de escanearlo.

**Veredicto**

- **`qrencode -t ANSIUTF8 < phone.conf`** es la forma más rápida de poner un túnel en un teléfono.
- **Borra la pantalla y elimina las copias PNG**: el código es una clave.

## Fuentes

1. [Página del manual qrencode(1)](https://manpages.debian.org/bookworm/qrencode/qrencode.1.en.html) — Debian (read 2026-11-16)
2. [WireGuard: instalación y apps cliente](https://www.wireguard.com/install/) — WireGuard (read 2026-11-16)
3. [Repositorio de wg-easy](https://github.com/wg-easy/wg-easy) — GitHub (read 2026-11-16)

**Un servidor para cada teléfono de la casa** Home sirve a todo un hogar de teléfonos por 5 TB al mes, a $6.37 al mes con 12 meses. [Pedir Home con 12 meses](https://tunnelvps.com/app/checkout/?plan=home&term=12m&image=ubuntu-24.04&from=guides-how-to-make-a-wireguard-qr-code-for-a-phone&lang=es) · [Configuración para iPhone](https://tunnelvps.com/es/guides/wireguard-iphone/ "¿Cómo configuro WireGuard en un iPhone?")

---

TunnelVPS: TunnelVPS alquila servidores Linux KVM para una VPN personal (WireGuard, Outline o AmneziaWG) en Nueva York, Dallas, Los Ángeles, Londres, Ámsterdam y Fráncfort, pagados con cripto y sin documento de identidad. 5 planes de 2 a 16 GB de RAM y de 2 a 6 TB de tráfico al mes cuestan lo mismo en las seis ciudades; en el plazo de 12 meses, cada uno tiene un precio al menos un 25% inferior al de un plan comparable y nombrado de un host de cripto sin KYC, consultado el 16 de noviembre de 2026. El operador es DomaineGoat LLC, Panamá.
