.env fájl

angolul: .env file (dotenv)

haladóelterjedt

A .env fájl egy egyszerű szöveges fájl, amelyben a program a jelszavait, kulcsait és beállításait tartja, külön a programkódtól.

Érthetően

Képzeld el, hogy a széfed kódját nem a széf ajtajára írod, hanem egy külön cetlire, amelyet otthon tartasz. A .env fájl ilyen cetli a programok világában. Ide kerülnek a titkos adatok (jelszavak, API-kulcsok) és azok a beállítások, amelyek gépenként eltérnek. A cetli maga nincs elzárva: aki megtalálja, el tudja olvasni.

A fájl nagyon egyszerű: minden sora egy név és egy érték, például ADATBAZIS_JELSZO=valami. A program induláskor beolvassa, és úgy használja az értékeket, mintha a futtatási környezet beállításai lennének.

Azért hasznos, mert így a kódot nyugodtan meg lehet osztani másokkal, vagy fel lehet tölteni egy közös tárhelyre, a titkok pedig a saját gépeden maradnak. Ugyanaz a program más .env fájllal vagy más beállításokkal a tesztgépen és az éles szerveren is futhat, a kód átírása nélkül.

Az AI-eszközök miatt ma többen találkoznak vele, mint korábban. Aki nyelvi modellt használó programot vagy agentet futtat, annak gyakran ide kell beírnia a szolgáltatótól kapott kulcsot.

Hogyan működik

A projekt főkönyvtárában létrehozol egy .env nevű fájlt, és soronként beírod a NÉV=érték párokat.
A program indulásakor egy kis segédkönyvtár (vagy maga a futtatókörnyezet) beolvassa a fájlt, és az értékeket környezeti változóként teszi elérhetővé.
A kód ezután név szerint kéri le az értékeket, így a jelszó vagy a kulcs sehol nem szerepel benne.
A .env fájlt felveszik a kizárási listára (.gitignore), hogy a verziókezelő ne töltse fel a közös kódtárba.
A többieknek egy kitöltetlen mintafájl (például .env.example) mutatja meg, milyen értékeket kell megadniuk a sajátjukban.

Példa a mindennapokból

Letöltesz egy nyílt forráskódú csevegőrobotot, és a leírás azt kéri, hogy másold le a .env.example fájlt .env néven, majd írd be a saját API-kulcsodat. Ettől kezdve a program a te kulcsoddal éri el az AI-szolgáltatást, és a te számládra fogyaszt.

Kit érint

fejlesztőNaponta használja a titkok és a gépenként eltérő beállítások kezelésére, és neki kell ügyelnie arra, hogy a fájl ne kerüljön ki. → Kód

vállalkozó, vezetőEgy kiszivárgott .env fájl a cég adatbázisához, fizetős szolgáltatásaihoz és ügyféladataihoz is hozzáférést adhat.

szülő, diák, tanárAki programozni tanul vagy AI-projektet próbál ki, jellemzően az első lépések között találkozik vele. → Oktatás és család

munkavállalóHa kódoló agenttel vagy automatizáló eszközzel dolgozol, tudnod kell, hogy ez a fájl bizalmas, és nem illik képernyőfotón vagy csevegésben megosztani. → Munka és HR

Gyakori félreértés

TévhitA .env fájl biztonságos, titkosított tároló, ezért amit oda írok, az védve van.

ValójábanA .env sima, titkosítatlan szöveg, amelyet bárki elolvashat, aki hozzáfér a géphez vagy a fájlhoz. Csak annyit ad, hogy a titok nem a kódban van, tehát nem megy vele együtt, amikor a kódot megosztod.

Korlátok és kockázatok

Ha véletlenül feltöltöd egy nyilvános kódtárba, a benne lévő kulcsokat automata keresők percek alatt megtalálhatják, ezért ilyenkor azonnal cserélni kell őket. A fájl utólagos törlése nem elég, mert a verziókezelő korábbi változataiban megmarad.
A gépeden futó kódoló agent vagy más program is el tudja olvasni, ezért érdemes beállítani, hogy mihez férhet hozzá.
Nincs rá egységes szabvány: az idézőjelek, a megjegyzések és a többsoros értékek kezelése eszközönként kicsit eltér.
Nagyobb csapatban és éles rendszerben kevés. Ott olyan titokkezelő szolgáltatás való, amely jogosultságokat kezel és naplózza a hozzáféréseket.

Hasonló, de nem ugyanaz

környezeti változó – A környezeti változó maga a futó program számára látható beállítás, a .env fájl csak egy kényelmes hely, ahonnan ezeket betöltik.
titokkezelő (secrets manager) – A titokkezelő titkosítva, jogosultságokkal és naplózással őrzi a kulcsokat, a .env fájl viszont védelem nélküli szöveg a lemezen.
konfigurációs fájl – Az általános konfigurációs fájl (például JSON vagy YAML) jellemzően a kóddal együtt utazik és nem titkos, a .env fájl viszont a gépen marad.

Kapcsolódó fogalmak

Tágabb

környezeti változó, konfiguráció, titokkezelés

Szűkebb

.env.example fájl

Rokon

API-kulcs, .gitignore, verziókezelés, token, kódoló agent

Röviden a története

A gyakorlatot a 2011-ben közzétett „tizenkét faktoros alkalmazás” (Twelve-Factor App) módszertan tette népszerűvé. Ez azt javasolta, hogy a beállítások környezeti változókban legyenek, ne a kódban. Erre épültek a dotenv nevű segédkönyvtárak: 2012-ben Rubyhoz, majd Node.js-hez is megjelent egy. 2023 óta (a 20.6-os változattól) a Node.js külön kapcsolóval beépítve is be tudja olvasni a .env fájlt.

Hol tart most

2026 végén a .env fájl a legtöbb programnyelvben és fejlesztőeszközben megszokott megoldás, az AI-projektekben pedig az API-kulcsok egyik szokásos helye. A figyelem közben arra terelődött, hogyan lehet megvédeni a kiszivárgástól és a gépen futó agentektől.

Állapot: 2026. november

Más nevei

.env · dotenv · .env fájl · env fájl · dotenv fájl · .env file · környezeti fájl · environment file

Források

A szócikk gépi szerkesztéssel készült és gépi szakmai lektoráláson ment át; a „hírekben” rész az Agent Age sztorijaiból automatikusan frissül.