Referencia
Referencia de la CLI
Comandos, opciones y códigos de salida de la herramienta de línea de comandos nebula.
El comando nebula protege ensamblados a partir de una config JSON y ofrece comandos de apoyo para el licenciamiento y los diagnósticos.
Proteger (comando raíz)
nebula --config <file> [options]
| Opción | Descripción |
|---|---|
--config, -c | Ruta al archivo de configuración JSON (obligatorio). |
--input, -i | Ensamblado de entrada a ofuscar; anula inputs en la config. Repetible. Permite que una config compartida “solo de ajustes” (sin inputs) dirija las transformaciones mientras quien la invoca proporciona el ensamblado — lo usa la integración de MSBuild para pasar la salida de cada target framework. |
--output, -o | Anula el outputDirectory de la config. |
--preserve-public-api [true|false] | Anula preservePublicApi. |
--quiet, -q | Suprime el progreso; sigue mostrando advertencias/errores. |
--json <file> | Escribe un resumen de ejecución legible por máquina (útil en CI). |
Claves de configuración
{
"schemaVersion": 1,
"inputs": ["bin/Release/net8.0/MyApp.dll"],
"outputDirectory": "protected",
"preservePublicApi": true,
"encryptStrings": true,
"controlFlowObfuscation": true,
"encryptResources": true,
"antiTamper": true,
"antiDebug": true,
"metadataHardening": true,
"verifyOutput": true
}
Otras claves incluyen los filtros exclude / include, excludeNamespaces, controlFlowInclude / controlFlowExclude, encryptStringsInclude / excludeStrings, la firma de nombre seguro (strongNameKeyFile, delaySign) y Authenticode (authenticodeCertFile, authenticodeTimestampUrl).
Otros comandos
nebula inspect <assembly> # lista métodos y literales de cadena para protección selectiva
nebula register --key LIC-... # activa una licencia en línea en esta máquina
nebula machine-id # muestra el id de activación de esta máquina
nebula license # muestra la edición / licencia actual
nebula deobfuscate --map <symbols.json> --input <trace.txt> # traduce una traza de pila
nebula blazor --framework <wwwroot/_framework> [--config <file>] [--assembly <Name> ...] # protege una app Blazor WASM publicada
Códigos de salida
| Código | Significado |
|---|---|
0 | Éxito |
2 | Configuración no válida |
6 | Licencia requerida / activación fallida |
64 | Error de uso |
Usa el código de salida en CI para hacer fallar una compilación si la protección no tuvo éxito.