
📅 Publicado el 11 de noviembre, 2026 · Por Equipo RedServicio

Los archivos .env resuelven un problema que todos hemos sufrido alguna vez: tener credenciales de base de datos, claves de API y configuraciones sensibles mezcladas con el código fuente. Ahí no pintan nada. Lo que sigue es una guía práctica para crearlas, estructurarlas y protegerlas bien en tu servidor, sin caer en los fallos típicos que acaban exponiendo información confidencial.
¿Qué son las variables de entorno y por qué usar archivos .env?
Una variable de entorno es, en esencia, un par clave-valor que el sistema operativo o el framework pone a disposición del código cuando este se ejecuta. La idea detrás es simple pero potente: separar la configuración del código. Gracias a eso, la misma aplicación puede correr en desarrollo, pruebas y producción sin tocar ni una línea.
El archivo .env es hoy la forma más extendida de guardar estas variables en proyectos web. Lo usan Laravel, Node.js con dotenv, Symfony y hasta WordPress mediante plugins especializados. Es, digamos, el punto central de configuración.
¿Por qué molestarse? Piensa en este ejemplo típico de mala práctica:
- Credenciales escritas directamente en el código PHP o JavaScript.
- Contraseñas de base de datos subidas a un repositorio Git público.
- La imposibilidad de cambiar configuraciones sin editar y redesplegar código.
Con un archivo .env bien gestionado, la cosa cambia:
- Seguridad: los secretos nunca viajan con el código fuente.
- Portabilidad: la misma base de código funciona en distintos entornos.
- Mantenimiento: cambiar una contraseña o URL lleva segundos.
Cómo crear y estructurar un archivo .env correctamente
Crear el archivo es fácil. Estructurarlo de forma consistente, eso ya te ahorra dolores de cabeza después. Empieza creándolo en la raíz del proyecto con un editor de texto plano. Luego define tus variables con el formato CLAVE=valor: en mayúsculas y separando palabras con guiones bajos.
Una estructura limpia para un proyecto típico sería algo así:
- APP_ENV=production (entorno de la aplicación).
- APP_URL=https://tudominio.com (URL base del sitio).
- DB_HOST=localhost (host de la base de datos).
- DB_NAME=mi_base_datos (nombre de la base de datos).
- DB_USER=usuario_db (usuario con permisos restringidos).
- DB_PASS=contraseña_segura (contraseña generada aleatoriamente).
- MAIL_API_KEY=clave_api_correo (credencial de servicios externos).
Algunas recomendaciones a la hora de estructurarlo:
- Agrupa las variables por prefijos temáticos (DB_, MAIL_, APP_). Se lee mucho mejor.
- Si el valor contiene espacios, enciérralo entre comillas dobles: APP_NAME=»Mi Web».
- Crea un archivo .env.example con las mismas claves pero valores vacíos o de ejemplo, y súbelo al repositorio. Sirve como documentación viva de la configuración necesaria.
- Añade .env al .gitignore desde el primer día. El primero, no el último.
Consejo práctico: nunca reutilices contraseñas entre entornos. La de tu base de datos en desarrollo debe ser distinta de la de producción, y ambas conviene generarlas con un gestor de contraseñas.
Una estructura ordenada también ayuda al equipo. Cualquiera que herede tu proyecto sabrá exactamente qué configurar con solo mirar el .env.example.
Variables de entorno .env: permisos y ubicación segura en el servidor
Dejar el archivo .env accesible desde el navegador es, con diferencia, el error más grave que nos llega al soporte técnico. Si alguien teclea https://tudominio.com/.env y ve el contenido, ya está: todas tus credenciales expuestas. Evitarlo exige cuidar dos cosas. La ubicación. Y los permisos.
Ubicación fuera de la raíz pública
Lo ideal es guardar el .env fuera del directorio público del servidor (public_html, www o public). Por ejemplo: si tu estructura es /home/usuario/app/.env y el documento raíz apunta a /home/usuario/app/public, el archivo queda inaccesible vía HTTP. Fino.
Protección adicional vía .htaccess
¿Y si el hosting no permite salir de la raíz pública? Entonces bloquea el acceso con reglas de Apache:
- Añade al .htaccess la directiva: RedirectMatch 404 ^/\.env
- O bloquea todos los dotfiles de golpe con: RewriteRule ^\. – [F,L]
Permisos de archivo recomendados
En servidores Linux, aplica permisos restrictivos desde la terminal:
- chmod 640 .env — lectura solo para el propietario y el grupo del servidor web.
- chown usuario:www-data .env — así el proceso de PHP puede leerlo, pero nadie más.
Un último apunte: verifica tras cada despliegue que el archivo no sea accesible por HTTP, y échale un ojo de vez en cuando a los registros de acceso buscando visitas a rutas como /.env. Es un patrón muy habitual entre bots maliciosos. En RedServicio ofrecemos hosting con protección activa contra estos ataques y soporte 24/7 para ayudarte a configurar tus variables de entorno con total seguridad.
Cómo cargar el archivo .env según tu stack (PHP, Node.js, Python)
No hay una única manera de cargar las variables de entorno .env. Cada lenguaje lo hace a su manera, y conviene saber cuál corresponde al tuyo antes de meterse en faena.
PHP con Laravel o PHP dotenv
Si trabajas con Laravel, buena noticia: el .env se carga solo, desde la raíz del proyecto. Pero si vas con PHP puro u otro framework, tocará hacerlo a mano con la librería vlucas/phpdotenv vía Composer.
- Instala la librería: composer require vlucas/phpdotenv.
- Cárgala al inicio de tu aplicación:
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();
A partir de ahí ya puedes acceder a los valores con $_ENV[‘DB_PASSWORD’] o con getenv(). Un detalle que mucha gente pasa por alto: evita putenv con datos sensibles si tu configuración expone variables en phpinfo(). Es un agujero silencioso.
Node.js con dotenv
Aquí el paquete de toda la vida es dotenv. Lo instalas con npm y lo cargas en la primera línea de tu punto de entrada:
require(‘dotenv’).config();
console.log(process.env.API_KEY);
Eso sí, desde Node.js 20 ya no necesitas dependencias: puedes usar la opción nativa –env-file=.env al arrancar la aplicación. ¿Producción? Entonces quizá te convenga inyectar las variables directamente desde el sistema o desde el panel de tu hosting y olvidarte del archivo.
Python con python-dotenv
En Python, python-dotenv es lo más extendido, sobre todo si vienes de Flask o FastAPI:
- Instala: pip install python-dotenv.
- Cárgalo antes de leer cualquier variable:
from dotenv import load_dotenv
load_dotenv()
import os
clave = os.getenv(«SECRET_KEY»)
¿Y Django? También se integra sin dolor, combinado con django-environ, que añade validación de tipos y valores por defecto (útil, la verdad). En cualquier caso, carga el .env lo antes posible en el arranque. Si lo retrasas, acabarás persiguiendo errores de variables vacías que no entiendes.
Errores comunes que exponen tu archivo .env (y cómo evitarlos)
La mayoría de sitios comprometidos no lo son por culpa de la tecnología. Son descuidos. Fallos tontos, evitables, que se repiten una y otra vez:
- Commitear el .env a Git: el error número uno, sin competencia. Añade .env a tu .gitignore antes del primer commit y crea un .env.example con las claves sin valores reales para documentar la estructura.
- Dejar el .env en una carpeta pública: si tu raíz web coincide con la carpeta del proyecto, cualquier bot puede pedir /.env. Y los bots lo hacen, constantemente. Coloca el archivo fuera del directorio público o bloquea el acceso en .htaccess o nginx.
- Permisos de archivo laxos: un .env con permisos 644 lo lee cualquier usuario del servidor. Restringe a 600 y al propietario correcto con chmod 600 .env.
- Duplicar secretos en logs y depuración: activar el modo debug en producción, o imprimir process.env completo en una respuesta de error, expone todo el contenido. Desactiva el detalle de errores en entornos reales.
- No rotar credenciales tras una filtración: si sospechas exposición, cambia ya las contraseñas de base de datos y las claves de API. Borrar el archivo no basta; el secreto ya salió.
Tip: si trabajas en equipo, plantéate los gestores de secretos o el almacenamiento cifrado que ofrezca tu panel de hosting. El archivo .env va genial en local; en producción no siempre es la mejor solución.
Conclusión: checklist de seguridad para tus variables de entorno
Hay una diferencia enorme entre una configuración profesional y una improvisada, y muchas veces esa diferencia está en cómo manejas el .env. Bien aplicado te da flexibilidad entre entornos, evita fugas de credenciales y simplifica el despliegue. Antes de publicar tu sitio, repasa esto:
- Incluye .env en .gitignore desde el primer commit y mantén un .env.example documentado.
- Ubica el archivo fuera del directorio público o bloquea su acceso desde el servidor web.
- Asigna permisos 600 y verifica que solo el usuario del proceso pueda leerlo.
- Nunca expongas variables en respuestas, logs ni modo debug en producción.
- Carga las variables correctamente según tu stack: Laravel, dotenv en Node.js o python-dotenv.
- Rota credenciales de forma periódica y de inmediato ante cualquier sospecha de filtración.
Y si lo que quieres es dedicarte a tu proyecto y no pelearte con la infraestructura, en RedServicio tienes hosting con configuración segura por defecto, protección activa contra accesos a archivos sensibles y soporte 24/7 para acompañarte. Tus credenciales merecen el mismo cuidado que tu código. Al menos yo lo haría así.
Equipo RedServicio
Artículos escritos y revisados por nuestro equipo técnico especializado en hosting e infraestructura web en España.
¿Listo para un hosting de verdad?
Servidores en España · Soporte 24/7 en español · Migración gratuita
Ver Planes desde 3,95€/mes →