Skip to content

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ónDescripción
--config, -cRuta al archivo de configuración JSON (obligatorio).
--input, -iEnsamblado 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, -oAnula el outputDirectory de la config.
--preserve-public-api [true|false]Anula preservePublicApi.
--quiet, -qSuprime 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
  • verify lee el Informe de protección. --min-coverage <0..1> sale con código distinto de cero (código 5) cuando la cobertura de identificadores está por debajo del umbral — una verja de CI de una línea.
  • retrace es el comando gratuito de simbolización de trazas de pila (el antiguo deobfuscate se mantiene por compatibilidad). Un mapa de otro ensamblado se rechaza en lugar de mapear mal; usa --assembly <name> para exigir la coincidencia.
  • doctor muestra lo que la detección automática de Nebula ya preserva, con un motivo por entrada y patrones exclude listos para pegar — ver Mantener tu app funcionando.
  • mcp expone protect, verify y retrace a Claude Code / Cursor / Copilot. Apunta el cliente MCP del agente al comando nebula con el único argumento mcp. Un protect con 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ódigoSignificado
0Éxito
2Configuración no válida
5Verificación fallida (p. ej. verify --min-coverage no alcanzado)
6Licencia requerida / activación fallida
64Error de uso

Usa el código de salida en CI para hacer fallar una compilación si la protección no tuvo éxito.