Tu propio servidor VPN · WireGuard, Outline, AmneziaWG · 6 ciudades · Paga en BTC, USDT, USDC, ETH, SOL, LTC, XMR
Idioma: Español
Consigue tu servidor VPN

Guía · qrencode en el servidor

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

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.

Última actualización: · 4 min de lectura

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)
PasoDóndeQué hacer
1ServidorInstala la herramienta con apt install qrencode.
2ServidorEscribe el archivo de cliente del teléfono, por ejemplo /etc/wireguard/clients/phone.conf.
3Terminal SSHEjecuta qrencode -t ANSIUTF8 < phone.conf y escanea el código desde la app WireGuard.
4Terminal SSHEjecuta 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 y de 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
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
qrencode -o /root/phone.png < /etc/wireguard/clients/phone.conf
# copy it down from your computer:
#   scp [email protected]:/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 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 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 (3)
  1. Página del manual qrencode(1) — Debian (read 2026-11-16)
  2. WireGuard: instalación y apps cliente — WireGuard (read 2026-11-16)
  3. Repositorio de 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.

Desde $2.25/mes con 12 meses · sin KYC

Consigue un servidor