Escapar contraseñas para archivos .env
Escribe una contraseña en una línea .env que shell, dotenv de Node.js, python-dotenv o docker --env-file lean exactamente igual, con comillas y $ incluidos.
Cada línea se entrecomilla para que el analizador lea exactamente tu contraseña: la shell usa comillas simples con '\'' para cada comilla, el dotenv de Node elige comillas simples, dobles o invertidas, python-dotenv escapa \ y \' dentro de comillas simples, y docker --env-file toma el resto de la línea literalmente (sin comillas).
Se ejecuta completamente en tu navegador. Tus datos nunca se suben.
¿Qué es Escapar contraseñas para .env?
Las contraseñas con comillas, signos de dólar, # o barras invertidas suelen romper los archivos .env o se modifican por la expansión de variables. Esta herramienta escribe líneas KEY=value que cada parser lee exactamente como tu contraseña, y avisa cuando un parser no puede representar el valor.
Cómo usar Escapar contraseñas para .env
- Introduce el Nombre de la variable, por ejemplo DB_PASSWORD.
- Escribe la contraseña en el campo Contraseña.
- Copia la línea para tu destino: shell/POSIX, dotenv de Node.js, python-dotenv o docker run --env-file.
- Pégala en tu archivo .env.
Ejemplo
Variable DB_PASSWORD, password p@ss'w"rd$1
Shell: DB_PASSWORD='p@ss'\''w"rd$1' Node dotenv: DB_PASSWORD=`p@ss'w"rd$1` python-dotenv: DB_PASSWORD='p@ss\'w"rd$1' docker --env-file: DB_PASSWORD=p@ss'w"rd$1
Cuándo usar Escapar contraseñas para .env
Úsalo siempre que un secreto contenga caracteres que no sean letras y dígitos. Si controlas el secreto, un valor alfanumérico largo evita por completo los problemas de escape.
Cómo funciona Escapar contraseñas para .env
Shell: el valor se envuelve en comillas simples y cada ' se convierte en '\'' (dentro de comillas simples no hay expansión). dotenv de Node (v15+): las comillas simples son literales; si el valor contiene ', se usan comillas dobles (solo se interpretan \n y \r) y, si no, comillas invertidas; los valores que terminan en barra invertida o contienen los tres tipos de comillas no se pueden representar. python-dotenv: comillas simples, con \ y ' escapados como \\ y \'. docker --env-file: sin comillas; el resto de la línea es el valor, así que los saltos de línea son imposibles.
Casos de Uso Comunes
- Añadir a un .env una contraseña de base de datos con $ y comillas
- Preparar secretos para docker run --env-file
- Corregir valores de dotenv que se cortan en #
- Escribir sentencias export para scripts de shell
Preguntas Frecuentes
¿Por qué no usar simplemente comillas dobles?
Dentro de comillas dobles, los shells y algunos cargadores dotenv expanden $VAR e interpretan las barras invertidas, lo que cambia la contraseña sin avisar.
¿Por qué la línea de docker --env-file va sin comillas?
docker run --env-file no procesa comillas; las comillas pasarían a formar parte del valor.
¿Docker Compose usa las mismas reglas?
El parser .env de Docker Compose tiene sus propias reglas de interpolación, que esta herramienta no modela; consulta la documentación de Compose o usa $$ para signos de dólar literales.