¿Qué es una variable de entorno y para qué sirve en un servidor?

Publicado el 2026-10-20 por frfrand

Variables de entorno explicadas: PATH, PORT, claves de API, archivos .env, seguridad y configuración de aplicaciones en producción.

Una variable de entorno es un nombre asociado a un valor que un proceso puede utilizar para configurar su comportamiento. En servidores se usa para indicar puertos, nombres de servicios, rutas y otros parámetros sin tener que cambiar continuamente el código fuente.

Por ejemplo, una aplicación puede utilizar PORT=8000 en tu computadora y PORT=5000 en producción. El mismo programa responde en puertos diferentes porque el entorno es distinto.

El ejemplo de dos sucursales

Imaginá una cafetería con dos sucursales. La receta del café es la misma, pero cada local tiene una dirección, un horario y un teléfono diferente.

Una aplicación también puede utilizar una base común y recibir configuraciones diferentes según dónde se ejecute.

Las variables de entorno son una manera de proporcionar esos valores. No son el único sistema de configuración: también existen archivos, parámetros de inicio y servicios externos.

¿Dónde se ven en Linux?

Podés consultar algunas variables con printenv. Por ejemplo:

printenv HOME
printenv PATH

HOME suele indicar el directorio personal. PATH contiene rutas donde la shell o determinadas funciones del sistema buscan programas ejecutables.

No significa que todas las variables estén definidas siempre ni que su contenido sea confiable para tomar decisiones de seguridad.

¿Qué significa exportar una variable?

En Bash, export NOMBRE=valor establece una variable que puede heredarse por procesos hijos iniciados desde esa shell.

Esto explica una confusión habitual: modificás una variable en tu terminal, pero un servicio del sistema sigue utilizando la configuración anterior. Ese servicio puede haberse iniciado en otro entorno, quizá mediante systemd o un contenedor.

Los procesos suelen recibir una copia de la configuración de entorno al comenzar; modificar tu propia terminal no actualiza mágicamente todos los servicios que ya están ejecutándose.

¿Qué es un archivo .env?

Es una convención utilizada por muchas herramientas para guardar pares nombre-valor en un archivo de texto.

Ejemplo:

PORT=8000
LOG_LEVEL=info
APP_MODE=development

Pero un archivo .env no es una función integrada de todas las aplicaciones ni de Linux. Para que funcione, una biblioteca o herramienta debe leerlo y transmitir esa configuración al proceso.

Además, el formato exacto puede variar entre herramientas. No conviene dar por hecho que cualquier línea válida en una implementación lo será en todas.

¿Es seguro guardar contraseñas ahí?

Una variable de entorno puede utilizarse para proporcionar secretos, pero no equivale a una caja fuerte. Las variables pueden aparecer en registros, volcados de memoria o entornos de procesos accesibles a usuarios con determinados permisos.

En producción, considerá gestores de secretos, permisos estrictos y mecanismos de rotación. Nunca publiques claves en repositorios públicos ni las agregues a una imagen de contenedor que compartirás.

Tampoco subas un archivo .env con credenciales reales a Git solo para que el despliegue «funcione más fácil». Existen métodos más adecuados.

¿Por qué funciona en mi PC y falla en producción?

Quizás falta una variable, el valor tiene un formato diferente o el proceso no heredó la configuración que esperabas.

En vez de imprimir una contraseña en los registros para depurar, comprobá de forma segura si la variable está definida, si el servicio recibe el nombre esperado y si la configuración se actualizó después del reinicio.

¿Qué diferencias hay entre desarrollo y producción?

En desarrollo podés usar una base local y activar mensajes de diagnóstico. En producción necesitás direcciones reales, permisos adecuados y restricciones de seguridad.

No deberías activar configuraciones inseguras únicamente porque facilitan las pruebas. Separar entornos ayuda a evitar que una modificación accidental afecte a usuarios reales.

¿Cómo encaja en ArduMaker?

Los despliegues Git y las aplicaciones ejecutadas en VPS de ArduMaker pueden necesitar variables de entorno para conectarse a bases de datos o configurar servicios. La plataforma facilita el despliegue, pero cada proyecto debe definir qué valores son públicos, cuáles son secretos y cómo llegan al proceso.

En resumen: una variable de entorno configura el comportamiento de un proceso. Resulta práctica para separar código y configuración, pero también necesita cuidado con secretos y permisos.

Fuente: Entorno de procesos según GNU · Por qué importa el .env.