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,
"generateProtectionReport": true
}
Otras claves incluyen los filtros exclude / include, excludeNamespaces, controlFlowInclude / controlFlowExclude, encryptStringsInclude / excludeStrings, la firma de nombre seguro (strongNameKeyFile, delaySign) y Authenticode (authenticodeCertFile, authenticodeTimestampUrl).
generateProtectionReport (por defecto true) escribe un Informe de protección — <name>.protection-report.json y .html — junto a cada salida.
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 blazor --framework <wwwroot/_framework> [--config <file>] [--assembly <Name> ...] # protege una app Blazor WASM publicada
Novedades en 2.2.0
# Verifica el Informe de protección de una compilación; opcionalmente exige una cobertura mínima en CI.
nebula verify --assembly protected/MyApp.dll
nebula verify --report protected/MyApp.protection-report.json --min-coverage 0.80
# Revierte una traza de pila ofuscada usando el mapa de símbolos de la compilación (gratis — ver también deobfuscate).
nebula retrace --map MyApp.symbols.json --input trace.txt
cat trace.txt | nebula retrace --map MyApp.symbols.json
# Propone una keep-list revisable — qué rompería la reflexión/serialización/DI/XAML al renombrar.
nebula doctor --input bin/Release/net8.0/MyApp.dll
nebula doctor --input MyApp.dll --json
# Ejecuta un servidor Model Context Protocol (stdio) para que los agentes de codificación protejan / verifiquen / reviertan.
nebula mcp
verifylee el Informe de protección.--min-coverage <0..1>sale con código distinto de cero (código5) cuando la cobertura de identificadores está por debajo del umbral — una verja de CI de una línea.retracees el comando gratuito de simbolización de trazas de pila (el antiguodeobfuscatese mantiene por compatibilidad). Un mapa de otro ensamblado se rechaza en lugar de mapear mal; usa--assembly <name>para exigir la coincidencia.doctormuestra lo que la detección automática de Nebula ya preserva, con un motivo por entrada y patronesexcludelistos para pegar — ver Mantener tu app funcionando.mcpexponeprotect,verifyyretracea Claude Code / Cursor / Copilot. Apunta el cliente MCP del agente al comandonebulacon el único argumentomcp. Unprotectcon una licencia de prueba sigue incorporando la autodestrucción y la respuesta lo indica.
Los atributos en código [Keep] / [Protect] se documentan en Anotaciones.
Códigos de salida
| Código | Significado |
|---|---|
0 | Éxito |
2 | Configuración no válida |
5 | Verificación fallida (p. ej. verify --min-coverage no alcanzado) |
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.