jaringan · Referensi perintah
qzx diagnoseWebsite
Apa fungsinya
Mendiagnosis mengapa situs HTTPS mungkin gagal dengan mengorelasikan DNS, sertifikat TLS, dan jangkauan HTTP dalam satu alur.
Kematangan perintah: Alpha
Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.
Perilaku dan perlindungan bawaan
Memeriksa tanpa mengubah status
Eksekusi langsung untuk operasi ini
Menggunakan alat native saat diperlukan
Menggunakan jaringan untuk tugas yang didokumentasikan
Dirancang untuk bekerja tanpa elevasi hak akses
Hanya menjalankan pemeriksaan diagnostik: resolusi DNS, inspeksi sertifikat TLS, dan satu request HTTPS untuk jangkauan. Domain tanpa skema menggunakan HTTPS secara default. Sebelum akses jaringan apa pun, QZX menolak skema selain HTTPS, alamat IP numerik, kredensial tertanam, query string, fragment, dan target dengan karakter sensitif shell. Jawaban DNS otoritatif bahwa nama tidak ada mencegah kueri TLS/HTTP yang tidak perlu; kegagalan internal probe ditandai sebagai diagnosis parsial dan tidak disajikan secara keliru sebagai situs yang down.
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Sol terhadap digest implementasi sha256:7da1246f5eb89d528f235dfc19e325e3e697c7b7b902cbb26078d0955e4c4452 pada 2026-09-10.
Sintaks persis
qzx diagnoseWebsite <target> [timeout] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| target | str | Ya | Tidak dideklarasikan | Domain atau URL HTTPS yang akan didiagnosis; dapat menyertakan port atau jalur |
| timeout | float | Tidak | 10 | Waktu tunggu maksimum request HTTP dalam detik (0.1-60; default: 10) |
Contoh input
qzx diagnoseWebsite example.comDiagnosis DNS, TLS, dan HTTP situs web dengan satu perintah
qzx diagnoseWebsite https://example.com/docs --jsonDapatkan diagnosis terstruktur untuk jalur HTTPS tertentu
qzx diagnoseWebsite example.com:8443/status --timeout 15 --jsonDiagnosis layanan HTTPS pada port khusus dengan timeout HTTP yang lebih panjang
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx diagnoseWebsite <target> [timeout] --json
Contoh output representatif
JSON ilustratif ini berasal dari kontrak hasil yang didukung implementasi saat ini. Ini menunjukkan apa yang dapat dikembalikan perintah tanpa mengklaim sebagai eksekusi yang direkam; nilainya bervariasi menurut input, mesin, izin, dan alat opsional.
Perintah contoh: 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"
}Lihat kontrak hasil 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
}Kesalahan dan batasan
Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.
QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.
Alur bukti: memerlukan endpoint terotorisasi atau fixture yang telah ditinjau.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/network/diagnose_website.py
- Kanal dokumentasi
- Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Ketersediaan
- 0.2.2.0.9 atau lebih lama
Lanjut jelajahi
Perintah terkait
Perintah ini juga termasuk kategori jaringan. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx checkUrlStatusMengueri URL HTTP dan mengembalikan kode status, waktu respons, serta header dasar.qzx getNetworkConfigMenampilkan interface, IP lokal, DNS, IP publik, dan deteksi VPN.qzx checkSslCertificateMemeriksa tanggal sertifikat, cakupan nama host, dan validasi rantai kepercayaan.qzx testInternetSpeedMengukur latensi HTTP dalam milidetik dan unduhan terbatas dalam Mbps serta MiB/s.