red · Referencia de comando
qzx diagnoseWebsite
Qué hace
Diagnostica por qué un sitio HTTPS puede estar fallando al correlacionar DNS, certificado TLS y alcance HTTP en un solo flujo.
Madurez del comando: Alpha
Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.9. La documentación corresponde al checkout alpha 0.2.2.0.9.
Comportamiento y protecciones integradas
Inspecciona sin cambiar el estado
Ejecución directa para esta operación
Usa una herramienta nativa cuando hace falta
Usa la red para la tarea documentada
Diseñado para funcionar sin elevación
Realiza únicamente comprobaciones de diagnóstico: resolución DNS, inspección del certificado TLS y una solicitud HTTPS de alcance. Los dominios sin esquema usan HTTPS de forma predeterminada. Antes de cualquier acceso de red rechaza esquemas distintos de HTTPS, direcciones IP numéricas, credenciales embebidas, query strings, fragmentos y destinos con caracteres sensibles al shell. Un DNS autoritativo de nombre inexistente evita consultas TLS/HTTP innecesarias; los fallos internos de una sonda se señalan como diagnóstico parcial y no se presentan falsamente como una caída del sitio.
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Sol contra el digest de implementación sha256:7da1246f5eb89d528f235dfc19e325e3e697c7b7b902cbb26078d0955e4c4452 el 2026-09-10.
Sintaxis exacta
qzx diagnoseWebsite <target> [timeout] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| target | str | Sí | No declarado | Dominio o URL HTTPS que se diagnosticará; puede incluir un puerto o una ruta |
| timeout | float | No | 10 | Tiempo máximo de espera de la solicitud HTTP en segundos (0.1-60; valor predeterminado: 10) |
Ejemplos de entrada
qzx diagnoseWebsite example.comDiagnosticar DNS, TLS y HTTP de un sitio web con un solo comando
qzx diagnoseWebsite https://example.com/docs --jsonObtener un diagnóstico estructurado de una ruta HTTPS específica
qzx diagnoseWebsite example.com:8443/status --timeout 15 --jsonDiagnosticar un servicio HTTPS en un puerto personalizado con un timeout HTTP mayor
Para obtener la carga estructurada completa, añade --json: qzx diagnoseWebsite <target> [timeout] --json
Ejemplo de salida representativa
Este JSON ilustrativo deriva del contrato de resultado respaldado por la implementación actual. Muestra lo que el comando puede devolver sin afirmar que es una ejecución grabada; los valores varían según entradas, equipo, permisos y herramientas opcionales.
Comando del ejemplo: qzx diagnoseWebsite example.com --json
{
"success": true,
"message": "Diagnoses why an HTTPS website may be failing by correlating DNS, TLS certificate, and HTTP reachability evidence. In this illustrative example, the command completed successfully.",
"meta": {
"command": "diagnoseWebsite",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 0,
"schema_version": 1
},
"details": {
"summary": "Additional structured context is included here."
},
"dns": [
{
"name": "example",
"status": "ok"
}
],
"findings": [
{
"name": "example",
"status": "ok"
}
],
"healthy": true,
"host": "example.com",
"http": "Example value",
"network_requests": true,
"overall_status": [
{
"name": "example",
"status": "ok"
}
],
"partial": "Example value",
"path": "C:\\project\\example.txt",
"port": 443,
"primary_issue_layer": "Example value",
"probe_status": [
{
"name": "example",
"status": "ok"
}
],
"read_only": true,
"recommendations": [
{
"name": "example",
"status": "ok"
}
],
"related_commands": [
{
"name": "example",
"status": "ok"
}
],
"remediation": "Example value",
"report": "Analysis complete.\nNo blocking issues were found.",
"target": "Example value",
"timeout_seconds": [
{
"name": "example",
"status": "ok"
}
],
"tls": [
{
"name": "example",
"status": "ok"
}
],
"url": "https://example.com"
}Ver el contrato de resultado JSON
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"details": [],
"dns": [],
"error": [],
"error_code": [],
"findings": [],
"healthy": {
"type": "boolean"
},
"host": [],
"http": [],
"network_requests": {
"type": "boolean"
},
"overall_status": [],
"partial": [],
"path": [],
"port": [],
"primary_issue_layer": [],
"probe_status": [],
"read_only": {
"type": "boolean"
},
"recommendations": [],
"related_commands": {
"type": "array"
},
"remediation": {
"type": "string"
},
"report": [],
"target": [],
"timeout_seconds": [],
"tls": [],
"url": []
},
"additionalProperties": true
}Errores y límites
El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.
QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.
Flujo de evidencia: requiere un endpoint autorizado o una fixture revisada.
Evidencia y procedencia
- Implementación
- src/qzx/commands/network/diagnose_website.py
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Disponibilidad
- 0.2.2.0.9 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de red. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx checkUrlStatusConsulta una URL HTTP y devuelve código de estado, tiempo de respuesta y cabeceras básicas.qzx getNetworkConfigMuestra interfaces, IP locales, DNS, IP pública y detección de VPN.qzx checkSslCertificateInspecciona fechas del certificado, cobertura del nombre de host y validación de la cadena de confianza.qzx testInternetSpeedMide la latencia HTTP en milisegundos y una descarga limitada en Mbps y MiB/s.