NestJS poskytuje balíček @nestjs/config pro správu konfigurace a proměnných prostředí strukturovaným, typově bezpečným a injektabilním způsobem. Načítá soubory .env, ověřuje konfiguraci a zpřístupňuje hodnoty v celé aplikaci prostřednictvím injektabilní ConfigService.
{ } ;
({
: [
.({
: ,
: ,
: .({
: .().(),
: .().(),
: .().(),
}),
}),
],
})
{}
ConfigModule.forRoot() načítá proměnné prostředí (ze .env + procesního prostředí) a — což je zásadní — může ověřit je pomocí schématu (Joi), takže chybějící nebo neplatná konfigurace selhá při startu aplikace s jasnou chybou namísto tajného selhání za běhu.
@Injectable()
export class DatabaseService {
constructor(private configService: ConfigService) {} // inject ConfigService
connect() {
const url = this.configService.get<string>("DATABASE_URL");
const port = this.configService.get<number>("PORT", 3000); // with a default
}
}
Místo čtení process.env přímo všude vkládáte ConfigService a voláte get() — typově bezpečné, testovatelné a centralizované.
// config/database.config.ts — group related config with registerAs
export default registerAs("database", () => ({
host: process.env.DB_HOST,
port: parseInt(process.env.DB_PORT, 10),
}));
// load it: ConfigModule.forRoot({ load: [databaseConfig] })
// access it: configService.get("database.host")
Jmenné prostory seskupují související nastavení a udržují konfiguraci organizovanou při jejím růstu.
process.env přímo?✗ process.env scattered everywhere → hard to test, no validation, stringly-typed
✓ ConfigService → injectable (mockable in tests), validated at startup, typed,
centralized — the structured NestJS way
✓ Keep secrets in .env (GITIGNORED) — commit a .env.example documenting required vars
✓ In production, inject config via the platform's env vars / secret manager
✓ Validate at startup so misconfiguration fails immediately with a clear message
Správná správa konfigurace je nezbytná pro jakoukoli skutečnou aplikaci — bezpečné a pružné zpracování databázových URL, API klíčů, portů, tajemství a příznaků funkcí v různých prostředích (vývoj, příprava, produkce).
NestJS @nestjs/config poskytuje strukturovaný, idiomatický způsob, jak to dělat, a pochopení jeho není triviální.
Klíčové výhody oproti přímému čtení process.env jsou významné: injektabilní ConfigService činí konfiguraci testovatelnou (mockování v testech) a centralizovanou; ověření při startu (se schématem Joi) okamžitě odhalí chybějící nebo špatně formátovanou konfiguraci jasnou chybou namísto matoucího selhání za běhu hluboko v požadavku; a jmenné prostory udržují rostoucí konfiguraci organizovanou.
V kombinaci s bezpečnostní praxí uchovávání tajemství v souboru .env ignorovaném gitem (a potvrzeném .env.example) vám to dává bezpečnou, přenositelnou a ověřenou konfiguraci.
Znalost nastavení ConfigModule, vkládání a používání ConfigService a ověřování konfigurace jsou zásadní pro vytváření produkčně připravených NestJS aplikací a odráží profesionální praxi back-endu.