From 717feaf725aee0f3fd0d8f3129b1e51cb3223211 Mon Sep 17 00:00:00 2001 From: TYF009 Date: Tue, 10 Nov 2026 17:35:21 +0800 Subject: [PATCH 1/4] fix: align web container runtime with Node requirements --- web/Dockerfile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/web/Dockerfile b/web/Dockerfile index 42b2f05..54b2a09 100644 --- a/web/Dockerfile +++ b/web/Dockerfile @@ -1,4 +1,4 @@ -FROM node:22-slim AS build +FROM node:24-slim AS build ENV NEXT_TELEMETRY_DISABLED=1 WORKDIR /app RUN npm install -g pnpm@11.25.0 @@ -6,7 +6,7 @@ COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./ RUN pnpm install --frozen-lockfile COPY . . RUN pnpm build -FROM node:22-slim +FROM node:24-slim ENV NODE_ENV=production NEXT_TELEMETRY_DISABLED=1 WORKDIR /app COPY --from=build --chown=node:node /app ./ From 3b8e9b88fdc69eba2c61be57c8ca60a870096909 Mon Sep 17 00:00:00 2001 From: TYF009 Date: Tue, 10 Nov 2026 17:38:31 +0800 Subject: [PATCH 2/4] docs: improve NetGuardian portfolio presentation --- README.md | 547 +++++---------------------- docs/operations/LOCAL_DEVELOPMENT.md | 460 ++++++++++++++++++++++ packaging/source-files.txt | 1 + 3 files changed, 562 insertions(+), 446 deletions(-) create mode 100644 docs/operations/LOCAL_DEVELOPMENT.md diff --git a/README.md b/README.md index 43b0ea8..8fe6537 100644 --- a/README.md +++ b/README.md @@ -1,489 +1,144 @@ -# NetGuardian V2 +# NetGuardian — Network Diagnostics & Evidence-Based Troubleshooting Platform -**Network diagnostics and monitoring for approved targets.** Run a probe, compare -results from two network locations, and review the evidence behind an incident. +NetGuardian helps IT teams investigate why a service is unreachable by checking +each layer of the connection and keeping a record of what each check found. -[Get started](#local-development-setup) · [Windows launcher](#windows-local-launcher) · [System design](docs/architecture/SYSTEM_DESIGN.md) · [Delivery status](docs/product/DELIVERY_STATUS.md) +[Quick start](#quick-start) · [Architecture](#system-architecture) · [Demo evidence](#demo-evidence) · [Verification](#test--verification-status) -## What you can do +## Why I Built This -- **Diagnose connectivity** with DNS, TCP, TLS and HTTP HEAD probes. View individual - timing measurements and TLS certificate details. Enable bounded ICMP and - traceroute checks when needed. -- **Monitor over time** with scheduled checks, collection freshness, and incident - and recovery history. -- **Compare network locations** by pairing a server-side check with a check from an - outbound-only Windows Agent that enforces its own target policy. -- **Review incident evidence** in redacted reports with checksums. Optional Ollama - investigations cite recorded evidence and can be reopened alongside the report. +When a workstation can reach one service but a front-desk device cannot, +the support ticket rarely tells you whether the failure is in name resolution, +connectivity, TLS, or the application. I built NetGuardian to make that investigation +repeatable and to give the next technician the observations behind a finding. -## How it fits together +NetGuardian grew from a Python and Streamlit toolkit into an independent portfolio +project informed by my work troubleshooting LAN/WLAN, TCP/IP, DNS, DHCP and +Windows endpoint connectivity. The scenarios here use controlled test systems. -| Component | Role | -| --- | --- | -| [Next.js dashboard](web/) | Submit diagnostics and review monitoring, comparisons and reports. | -| [FastAPI service and worker](service/) | Authorize requests, schedule and run server-side jobs, and store results with SQLAlchemy. | -| [Probe engine](probe_core/) | Validate targets and collect protocol-specific measurements. | -| [Windows Agent](agent/) | Run approved checks from a local network location and return results over an outbound connection. | - -V2 is currently scoped to local Windows evaluation. See the -[Windows delivery record](docs/product/WINDOWS_DELIVERY.md) for verified scenarios -and the [delivery checklist](docs/product/DELIVERY_STATUS.md) for remaining -production and Linux deployment work. - -## Local development setup - -Prerequisites: Python 3.11, uv 0.13.7, Node.js 24 or later, pnpm 11.25.0. -The lockfiles are `uv.lock` and `web/pnpm-lock.yaml`. +## Key Features -```sh -git clone https://github.com/TYF009/NetGuardian.git -cd NetGuardian -python -m pip install uv==0.13.7 -uv sync --locked +| Capability | What it shows | +| --- | --- | +| Layered diagnostics | DNS records, TCP connectivity, TLS handshake and certificate details, and HTTP HEAD status and timing. Opt-in ICMP and traceroute provide additional reachability and path evidence. | +| Scheduled monitoring | Pause and resume checks, review collection freshness, and follow incident and recovery history. Missing observations are shown as gaps. | +| Two-location comparison | Pair a server-side check with one from an enrolled Windows Agent. Compare the recorded observations within the limits of their endpoints and timing. | +| Incident evidence | Open saved, redacted report snapshots, verify their SHA-256 digests, and trace findings back to the underlying observations. | +| Optional investigation | Use a configured Ollama model to summarize report evidence. Validated findings and unverified hypotheses are displayed separately. | + +## System Architecture + +```mermaid +flowchart LR + Operator --> Web["Next.js dashboard"] + Web --> API["FastAPI control API"] + API --> DB[("SQLite / PostgreSQL")] + Worker["Background Worker"] --> DB + Worker --> Engine["Shared probe engine"] + Agent["Outbound Windows Agent"] -->|"Poll jobs and return observations over HTTPS"| API + Agent --> Engine + Engine --> Targets["Approved targets"] ``` -Configure the following environment in the API, worker and migration shells: - -| Variable | Meaning | -|---|---| -| `NETGUARDIAN_TOKENS` | JSON object mapping random ASCII bearer tokens (32–512 characters) to workspace IDs; required by API/worker | -| `NETGUARDIAN_ORIGINS` | JSON object mapping workspace IDs to exact approved HTTP(S) origins; defaults to no targets | -| `NETGUARDIAN_DATABASE_URL` | SQLAlchemy URL; defaults to `sqlite:///netguardian.db` for local development | -| `NETGUARDIAN_VANTAGE_ID` | Required by the worker: stable non-nil UUID identifying its network location | -| `NETGUARDIAN_ENABLE_SYSTEM_PROBES` | Set to `true` on the worker/agent to enable fixed ICMP/traceroute tools | +- [Web dashboard](web/) and [FastAPI API](service/api.py) handle authenticated requests and workspace views. +- The [Worker](service/worker.py) claims leased jobs from the database and persists observations. The [Agent](agent/) polls the API over HTTPS and applies its own local target policy. +- The [probe engine](probe_core/) runs bounded checks. [Alembic migrations](migrations/) track schema changes, and [report export](service/report_files.py) checks saved snapshot integrity. -Generate a token locally with `python -c "import secrets; print(secrets.token_urlsafe(32))"`. -Keep it out of source control and shell history. A token mapping has the shape -`{"":"local"}`. An origin mapping has the shape -`{"local":["https://:443"]}`. These are placeholders, not usable -credentials or authorization to probe third-party services. Start with `{}` origins -until you have approved a target you own or are authorized to diagnose. -Configuration files named `.env` are **not loaded automatically** by the Python CLI. +See the [system design](docs/architecture/SYSTEM_DESIGN.md) and [data model](docs/architecture/DATA_MODEL.md). -From the repository root, migrate before starting either service: +## Engineering Highlights -```sh -uv run --locked alembic upgrade head -uv run --locked uvicorn service.api:app_factory --factory --host 127.0.0.1 --port 8000 -``` +- **Probe safety.** Server-side probes deny targets by default and require exact approved origins. The executor connects to a validated numeric address while preserving the hostname for HTTP and TLS. HTTP uses HEAD with bounded headers and no redirect following. +- **Measurement semantics.** DNS, TCP, TLS and HTTP timing are kept separate. HTTP duration describes an application-layer request, while ICMP round-trip time measures an echo exchange. +- **Asynchronous delivery.** API acceptance is separate from execution. Jobs have leases and expiry, and the Agent has a local result spool to retry delivery without repeating a completed probe. +- **Reproducible evidence.** Reports retain the observations used to explain an incident. The export preserves the stored snapshot for [offline checksum verification](scripts/verify_report.py). -Generate a probe-location UUID once with `python -c "import uuid; print(uuid.uuid4())"` -and set `NETGUARDIAN_VANTAGE_ID` in the worker environment. Preserve it across restarts. -Workers sharing one network location may share it; distinct locations must use distinct -IDs. This is an operator assertion, not automatic location attestation. Old records -retain the legacy shared ID and cannot distinguish historical worker deployments. +See [responsible probing and measurement details](docs/operations/LOCAL_DEVELOPMENT.md#target-policy-and-measurement-semantics) and the [threat model](docs/security/THREAT_MODEL.md). -In another shell with the same configuration and repository working directory: +## Demo Evidence -```sh -uv run --locked python -m service.worker -``` - -In a third shell: +| Scenario | Evidence | +| --- | --- | +| Service returns HTTP 503, then recovers to HTTP 204 | A controlled loopback HTTPS integration exercised an Agent monitor. The local browser QA recorded both statuses, incident recovery and the checksum-verified report. [Browser QA record](docs/product/BROWSER_QA.md#populated-workflow-check-2026-11-05) | +| Operator exports a report | A local browser download was checked with the offline verifier. The test environment used isolated evidence and a test workspace. [Export QA record](docs/product/BROWSER_QA.md#real-model-investigation-and-report-export-2026-11-06) | +| An operator browses missing observations | A synthetic fixture of 101 failed jobs exercised pagination and the UI message for missing measurements. [Fixture QA record](docs/product/BROWSER_QA.md#retained-history-production-web-build-2026-11-05) | -```sh -cd web -pnpm install --frozen-lockfile -pnpm dev -``` +These are local QA records. The HTTPS results came from a controlled test server, and the history fixture contains synthetic job state. -Open [the local interface](http://127.0.0.1:3000) and enter the workspace token. -The Web proxy uses `http://127.0.0.1:8000` by default. Override `NETGUARDIAN_API_URL` -only with a trusted API origin. Browser users cannot select the proxy destination. -The API buffers at most 64 KiB per request before JSON parsing, with a 10-second -body-receive deadline (including chunked uploads). This does not replace deployment -connection limits or general request throttling. -Tokens stay in React memory; disconnect remounts the workspace and cancels requests. -A browser abort does not roll back an operation already committed by the API. +## Technology Stack -For a local production build, run `pnpm build` then `pnpm start` inside `web/`. -Keep the development services on loopback. Non-loopback operation needs verified -TLS and the unfinished production controls listed in the delivery checklist. +Python 3.11 · FastAPI · SQLAlchemy · Alembic · SQLite / PostgreSQL · Next.js · React · TypeScript · Node.js 24 · pnpm · pytest · Ruff · GitHub Actions -## Windows local launcher +## Quick Start -After installing the locked Python dependencies, installing Web dependencies and -running `pnpm build` in `web/`, configure the environment variables described above -(including a stable vantage ID). From the repository root: +**Windows local evaluation.** Install Python 3.11 and Node.js 24. From PowerShell: ```powershell +git clone https://github.com/TYF009/NetGuardian.git +Set-Location NetGuardian +python -m pip install uv==0.13.7 +npm install -g pnpm@11.25.0 +uv sync --locked +pnpm --dir web install --frozen-lockfile +pnpm --dir web build + +$workspaceToken = (uv run --locked python -c "import secrets; print(secrets.token_urlsafe(32))").Trim() +$env:NETGUARDIAN_TOKENS = @{ $workspaceToken = 'local' } | ConvertTo-Json -Compress +$env:NETGUARDIAN_ORIGINS = '{}' +$env:NETGUARDIAN_VANTAGE_ID = [guid]::NewGuid().ToString() +$workspaceToken uv run --locked python -m scripts.run_windows --migrate ``` -`--migrate` explicitly upgrades the configured database before startup; back up an -existing database first. Omit it on later starts. The launcher requires an existing -production Web build and starts API, worker and Web on fixed loopback ports 8000 -and 3000. It refuses occupied ports, missing configuration or outdated schemas. -It does not install dependencies, generate credentials, approve targets, start an -Agent or configure Ollama. Browser access still requires your workspace token. -The worker uses the configured target policy; use empty origins for a no-probe trial. - -`--check` validates prerequisites without starting services or migrating. For a -bounded smoke run, use `--run-seconds 5`; the timer starts after API and Web are ready. -The worker process is supervised, but this is not a worker health/throughput check. -Ctrl+C or a child-process exit stops the process trees created by this launcher. -Shutdown is forced: in-flight work relies on existing leases and retry rules. -The launcher joins an unnamed Windows Job Object before spawning children; its -termination also terminates owned descendants, including after force-kill. It -refuses startup if the host prevents this containment. This is not a Windows -Service manager or a signed installer. - -Per-run logs remain under ignored `.netguardian-local/`; review and protect them as -local operational data. Credentials are not printed or written by the launcher; -the Web child does not inherit NetGuardian backend configuration or credentials. -Rebuild Web after source changes. This launcher has been smoke-tested on Windows; -it does not change the deferred Linux support scope. - -## Target policy and measurement semantics - -Cloud policy defaults to deny. Only administrator-configured exact origins are -accepted; mixed public/private DNS answers, special addresses, credentials in URLs, -ambiguous hosts and unsupported schemes are rejected. Connections use validated -numeric addresses while retaining the original hostname for Host/SNI and certificate -verification. HTTP uses HEAD, downloads no body, caps headers at 16 KiB and does not -follow redirects. Ambient proxies are not used. The overall probe deadline is at most -10 seconds; only the first approved address is attempted. - -| Measurement | Meaning | -|---|---| -| `dns_lookup_ms` | Resolution and address-policy planning duration | -| `tcp_connect_ms` | TCP connection establishment duration | -| `tls_handshake_ms` | TLS stream setup/handshake duration | -| `http_ttfb_ms` | Time from sending HEAD until the first response byte | -| `http_total_ms` | Total probe time through complete HTTP response headers, including setup | -| `icmp_rtt_ms` | Exact ICMP echo RTT when the OS reports one; less-than bounds remain separate samples | - -HTTP duration is not ICMP RTT. A cloud result describes the worker's network, not the -browser's. TLS evidence does not prove service ownership or certificate revocation -checking. Agent observations are self-reported. - -System probes use canonical numeric addresses and fixed executable/argument lists, -never arbitrary shell commands. ICMP sends one echo; traceroute uses at most 15 hops. -The process runner caps execution at nine seconds and output at 64 KiB. Missing tools -or recognized permission failures are explicit. No automatic privilege elevation is -performed. Locale variations can cause parse failures. Production cloud policy still -rejects loopback; integration tests use an isolated test-only policy. - -## Monitoring and comparisons - -Create a monitor with an approved target, probe kind and cloud/agent vantage. -Intervals are at least 60 seconds. Schedules run independently of browser sessions; -at most one unfinished run exists per monitor. Each workspace currently permits -20 monitors, 20 pending jobs and 60 newly created jobs per rolling 60 seconds. -Manual submissions, diagnostic pairs and schedules share the rate budget, including -completed jobs. Pairs consume two slots. API rejection returns 429/Retry-After; schedules -wait without a catch-up burst. This is not a complete HTTP request-rate limiter. - -Pause prevents new scheduled jobs; queued/running jobs may finish. Resume rechecks -authorization, resets consecutive counters and starts a current cycle without replaying -missed intervals. HTTP 4xx/5xx is unhealthy; policy denial and unsupported capability -are not network outages. Missing results break consecutive counters without recovering -open incidents. Collection freshness is distinct from target health. - -New incidents include the failures that triggered their threshold and subsequent -observations through recovery. Missing measurements are listed explicitly. Links retain -at most the latest 1000 observations; older incidents are not automatically backfilled. - -Compare can queue matching cloud/agent jobs atomically, consuming two pending slots. -Execution is asynchronous. Numeric deltas require compatible target, kind, configuration, -probe version and destination, distinct vantages, successful observations and at most -30 seconds of skew. DNS results record A/AAAA addresses, observed TTL, canonical name and resolver endpoint. -DNS timing deltas remain withheld for every probe kind: an endpoint does not -establish equivalent cache state. Other comparable timings include an explicit -reminder that HTTP total duration includes resolution and connection setup. -IP literal targets skip DNS and leave `dns_lookup_ms` absent. -Differences do not establish causality. - -Monitor **View history** retrieves the latest 100 runs in chronological order via -`GET /api/monitors/{id}/runs`. Choose one timing metric for a scatter plot and an -accessible evidence table. Missing timings are not zero and points are not joined -across gaps. The time axis is server job creation time, not claimed agent observation -time. History is an explicit snapshot; reopen it to refresh. Timing alone does not -establish target health. The initial chart uses a small SVG component rather than a -charting dependency; richer zoom/aggregation is still future work. - -## Optional local agent - -Copy `agent/config.example.json` to an ignored local configuration and set its HTTPS -control API origin. Explicitly list allowed probe origins. Private addresses require -explicit RFC1918/IPv6 ULA `private_cidrs`; loopback, link-local and metadata addresses -remain prohibited. Server jobs cannot expand local policy. The server policy must also -authorize the origin. - -Issue a ten-minute single-use enrollment token from Agents, then run: +Open [the local dashboard](http://127.0.0.1:3000), enter the test workspace token printed +in PowerShell. The empty origin list lets you explore the UI +without enabling probes. Use a fresh checkout or back up an existing database +before migration. Keep a stable Worker location ID when retaining observations +across sessions. -```sh -uv run --locked python -m agent.client --config agent/config.local.json --enroll -uv run --locked python -m agent.client --config agent/config.local.json -``` +For separate API, Worker and Web processes, authorized targets, Agent enrollment +and configuration, see the [local development guide](docs/operations/LOCAL_DEVELOPMENT.md). +See the [operations runbook](docs/operations/RUNBOOK.md) for readiness, backups and +troubleshooting. + +## Test & Verification Status -Enter the enrollment token at the hidden prompt. The agent credential is stored in -Windows Credential Manager or Linux Secret Service/KWallet, not the JSON file. The -agent fails closed without a supported store, uses outbound verified HTTPS, and opens -no listener. Revocation stops access, pauses its monitors and terminates pending jobs -without fabricating results. Uploads must match the job, attempt, configuration digest -and lease; identical duplicate uploads are accepted. - -Control responses have a 64 KiB limit and 20-second total deadline; compressed or -malformed responses are rejected. One result is retried in memory, or in an opt-in bounded local spool; see the runbook. -Credential rotation is available through `--rotate-credential`; see the runbook. -Signed distribution and service installers remain unfinished. -Without a configured spool, restarting the agent can lose its pending result. Do not claim offline durability. - -## Reports, AI and audit - -The Reports view reopens the latest 100 saved snapshots without regenerating them. -Readable reports show incident times, recorded findings with in-page evidence citations, -missing observations, limitations and per-observation timings. Raw JSON remains available -for inspection and download. -Reports store redacted snapshots with SHA-256 checksums. Query strings and free-form -errors are removed; paths and addresses remain operational data to review before sharing. -Reads and AI submission recompute the checksum; mismatch returns HTTP 409. The checksum -is not a signature or protection against changing both content and digest. - -Optional AI requires administrator-set `NETGUARDIAN_OLLAMA_URL` and -`NETGUARDIAN_OLLAMA_MODEL`. Remote endpoints require HTTPS; loopback HTTP is allowed. -No model is downloaded automatically. The adapter uses Ollama -[structured output](https://docs.ollama.com/capabilities/structured-outputs) via -[chat](https://docs.ollama.com/api/chat), with a 30-second deadline and 64 KiB response cap. -Only the latest 30 selected evidence records are submitted, excluding URLs, IPs and -endpoint free text. Facts must match recorded values; hypotheses require citations and -remain unverified. Model tools are prohibited. Missing/rejected model output remains -explicit; deterministic reports still work. Real inference quality is not yet evaluated. - -Investigations reopens saved output and source reports without calling the model again. -Audit shows the latest 100 covered operator events. Logs identify roles, not individual -humans, and are not tamper-proof. See the [runbook](docs/operations/RUNBOOK.md) for scope. - -## Checks and operations +- **Automated checks.** GitHub Actions runs Python unit and selected runtime tests on Windows and Ubuntu, PostgreSQL integration tests, and Web tests, TypeScript checks, schema drift checks and a Next.js production build. See the [workflow](.github/workflows/ci.yml) and [main baseline run](https://github.com/TYF009/NetGuardian/actions/runs/42789779017). +- **Controlled local verification.** The [Windows delivery record](docs/product/WINDOWS_DELIVERY.md) documents loopback TLS, Agent workflows, database verification and browser checks with their scope. +- **Reproduce checks.** Run these from the repository root. The [local guide](docs/operations/LOCAL_DEVELOPMENT.md#checks-and-operations) describes optional integration prerequisites. ```sh uv run --locked ruff check . uv run --locked ruff format --check . -uv run --locked python -m compileall -q app.py diagnostics.py probe_core service agent migrations tests integration uv run --locked pytest -q -uv run --locked pytest integration/test_tls.py integration/test_process_cleanup.py -q +uv run --locked pytest integration -q -rs +pnpm --dir web test +pnpm --dir web typecheck +pnpm --dir web build ``` -The default unit suite blocks network and process execution. Integration tests are -separate: TLS uses loopback fixtures; process tests launch fixed local Python fixtures. -Windows system-tool tests require `NETGUARDIAN_TEST_SYSTEM_PROBES=true`. -PostgreSQL tests require a disposable `netguardian_test` database and -`NETGUARDIAN_TEST_POSTGRES_URL`; absent configuration produces skips, not verification. -GitHub Actions runs Python checks on Windows and Ubuntu, Web checks on Ubuntu, and PostgreSQL integration tests. See the [CI workflow](.github/workflows/ci.yml) for the test matrix. - -Back up existing databases before migration. Do not blindly stamp schemas from old -unversioned development snapshots. Docker Compose configuration is provided but remains -unverified locally. See the [operations runbook](docs/operations/RUNBOOK.md). - -## Legacy Streamlit and project documents - -The repaired legacy UI remains available with -`uv run --locked streamlit run app.py --server.address 127.0.0.1`. -Its probe entry points are intentionally disabled; use the V2 API/Web path for approved -probes. Streamlit keeps default CORS/XSRF protections. Historical HTTP timing must never -be relabeled as ICMP or component timings. - -- [Product requirements](docs/product/PRD.md) -- [System design](docs/architecture/SYSTEM_DESIGN.md) -- [Data model](docs/architecture/DATA_MODEL.md) -- [Threat model](docs/security/THREAT_MODEL.md) -- [Implementation plan and original audit](docs/product/IMPLEMENTATION_PLAN.md) -- [Current delivery gates](docs/product/DELIVERY_STATUS.md) -- [Browser QA scope](docs/product/BROWSER_QA.md) - -See [NOTICE.md](NOTICE.md) for licensing scope and the legacy asset redistribution review. - -The Web API proxy bounds POST/PATCH bodies to 8 KiB of raw UTF-8 bytes and a -10-second read deadline, including chunked requests. Encoded/compressed bodies -are rejected. Run its focused regression checks with `cd web` and `pnpm test`. - -Agent jobs have a 120-second delivery window from creation. The scheduler (or an -agent poll) marks overdue unclaimed work and exhausted retries as failed without -a measurement, records an audit event, and releases monitor queue capacity. -A live 30-second lease is allowed to finish. Missing delivery breaks consecutive -incident evidence; it never establishes target failure or recovery. - - -The opt-in local transport integration suite includes -`uv run --locked pytest integration/test_agent_workflow.py -q`. It starts an ephemeral -loopback HTTPS API and HTTP HEAD fixture, enrolls an agent, executes two real probes -(503 then 204), reloads a pending upload from disk, verifies duplicate acceptance, -and checks incident recovery and report evidence. It also executes an atomic cloud/agent -diagnostic pair through both real transports and compares their recorded measurements. Test-only DNS mapping, loopback -address authorization and a private test CA are scoped to the test; production -policies and system certificate trust are unchanged. This is not evidence of a -cross-machine agent installation, all crash boundaries, Linux keyring behavior -or PostgreSQL operation. No public target is contacted. - -Probe version 0.2.1 measures durations with Python `perf_counter`, a high-resolution -monotonic clock. This avoids the coarse Windows Python 3.11 `monotonic` timer. -Historical measurements are preserved; different probe versions are not compared. - -Diagnostic pairs now have persistent IDs and a workspace-scoped history in the -Compare page. Reloading the page does not lose pair membership. Existing jobs are -not retroactively grouped. Generic retention preserves paired evidence; automated -pair expiration is not yet implemented. Apply database migrations before startup. - -TLS certificate/hostname validation failures use `tls_verification_failed`, distinct -from generic transport errors. When available, `error.tls_verify_code` preserves the -TLS runtime verification code; its interpretation is runtime-specific. Failed -verification does not yield verified TLS certificate metadata or an HTTP status. - -Control API admission is process-local: 32 concurrent API requests, a 120-request -burst replenished at 60/second, plus a 60-mutation workspace burst replenished at -1/second. Agent poll/result traffic uses only the global budget. Health endpoints -remain accessible. These are protective defaults, not benchmarked capacity or -aggregate limits across replicas; 429 responses carry `Retry-After`. - - -Windows PostgreSQL 17.11 has now passed local schema, concurrent-worker, -concurrent-startup and tenant-constraint tests, plus the real HTTPS Agent/report/ -comparison workflow. A local dump/restore comparison matched all 12 public tables. -See `docs/operations/RUNBOOK.md` for exact scope and limitations; Docker and Linux -execution are not inferred from these results. The HTTPS integration test now runs -on SQLite and, when the explicitly named disposable PostgreSQL database is configured, -on PostgreSQL as well; otherwise its PostgreSQL case is skipped. - - -Setting `NETGUARDIAN_TEST_KEYRING=true` also opts the HTTPS workflow into a real OS -credential-store rotation check. It creates a randomly named test service, commits -a server credential rotation while retaining the old local credential and pending -rotation entry, then runs normal recovery. It verifies old-token rejection, -new-token access, revocation, and cleanup of both temporary credential entries. -This passed with Windows Credential Manager. It reproduces lost-acknowledgement -state; it does not inject an actual dropped socket or terminate an agent process. - -The model adapter requests identity encoding and rejects compressed responses -before consuming their bodies. Its 64 KiB response cap applies to raw streamed -bytes before JSON decoding. Model transport tests do not establish model quality. - - -The Agent CLI holds an OS file lock for its control origin and agent ID before -opening the keyring or processing jobs. Duplicate instances fail instead of racing -spool writes or credential rotation. Lock files live under `~/.netguardian/locks`; -they remain after exit, but ownership is released by the OS when the process dies. -Do not delete lock files while an agent is running. This coordinates processes -under the same OS user; separate users/machines must not share one enrollment. - - -### Long incident history - -Run `uv run alembic upgrade head` before starting this version. Incident links are -now stored independently of the latest-1000 summary. Authenticated control API -clients can read `/api/incidents/{id}/evidence?after=0&limit=100`, following -`next_after` until it is null. Earlier links already discarded by older versions -cannot be reconstructed. Reports remain bounded snapshots. In the Incidents tab, choose **Browse retained -history** to navigate pages of 100 links and inspect individual observations. Linked jobs are protected from generic retention; -plan storage accordingly. Downgrading populated incident history is refused. - - -### Local Ollama GPU compatibility fallback (Windows) - -The local validation machine could not load Ollama 0.40.14's CUDA runner -(`device kernel image is invalid`). CPU inference worked without driver changes. -To run a separate loopback-only CPU instance, use a PowerShell terminal: +## Current Limitations -```powershell -$env:CUDA_VISIBLE_DEVICES = "-1" -$env:OLLAMA_VULKAN = "0" -$env:OLLAMA_HOST = "127.0.0.1:11435" -& "$env:LOCALAPPDATA/Programs/Ollama/ollama.exe" serve -``` +- The documented delivery target is local Windows evaluation. Docker Compose deployment and broader Linux runtime qualification remain open. +- Loopback tests cover the job and Agent flows. Cross-machine rollout, signed Agent distribution and sustained multi-replica load remain unverified. +- Ollama is optional and experimental. A bounded local scenario demonstrates the evidence checks, with broader diagnosis quality still to evaluate. -In the API terminal, configure `NETGUARDIAN_OLLAMA_URL=http://127.0.0.1:11435` -and the installed model name in `NETGUARDIAN_OLLAMA_MODEL`. These are process-local -settings; the default Ollama tray service may still use its original GPU settings. -The official [hardware guide](https://docs.ollama.com/gpu) documents these GPU -selection controls. Stop the CPU server with Ctrl+C when no longer needed. +See the [delivery checklist](docs/product/DELIVERY_STATUS.md) for the current verification boundaries. -Real-model acceptance can be explicitly enabled using an existing verified report: +## Roadmap -```powershell -$env:NETGUARDIAN_TEST_MODEL_REPORT = "C:/path/to/exported-report.json" -$env:NETGUARDIAN_TEST_MODEL_URL = "http://127.0.0.1:11435" -$env:NETGUARDIAN_TEST_MODEL = "qwen2.5:1.5b" -uv run pytest integration/test_model_workflow.py -q -``` +- Publish a read-only demo of a controlled incident and recovery with clearly labeled data and a verifiable report. +- Verify Compose startup and migrations from a clean environment, then document the supported operating scope. +- Validate Agent enrollment, reconnect and two-location comparisons across separate test hosts. -This opt-in test calls the real model and checks persisted investigation access. -It does not certify diagnosis quality. Qwen2.5 0.5B produced unsupported causal -hypotheses in local testing and is not recommended as the default investigator. +## Author -Qwen2.5 1.5B passed the local CPU integration check against the recorded 503/204 -HTTPS workflow: both facts were correctly cited and no hypothesis was invented. -This single scenario does not establish general diagnostic reliability. +I am a Communication Engineering graduate with Huawei HCIP Datacom certification, +experience in 400G optical transport operations, and hands-on IT infrastructure +and network support experience. NetGuardian brings that troubleshooting practice +together with Python automation and a web-based evidence workflow. ## License -Project code and documentation use the [MIT License](LICENSE). See [NOTICE.md](NOTICE.md) -for third-party components and the unresolved legacy portrait asset scope. - -Current delivery target: **Windows local use**. Linux runtime support and release -validation for deployment are deferred. CI covers selected Linux test scenarios. - - -### Missing cloud-worker results - -Cloud jobs have a 120-second delivery-age limit, separate from the probe's -10-second execution deadline. Old queued jobs and expired leases become failed -without a measurement on the next job read, submission, worker claim or scheduler -tick. Active leases are not interrupted. An offline worker therefore does not -leave observed jobs queued forever, and restarting it will not execute stale work. -Expiry is evaluated when a service handles work; no clock runs while every service -is stopped. Missing measurements do not establish target failure or recovery. -The audit action is `cloud_job.delivery_expired`; each cleanup batch is bounded. - - -### Diagnostic API contract - -Task submission, history and details use generated OpenAPI types and an -`openapi-fetch` client. FastAPI validates their response models, including the -shared measurement envelope. After changing API schemas, run from the root: - -```sh -uv run python -m scripts.export_openapi -cd web -pnpm generate:api -pnpm typecheck -``` - -Commit both `web/openapi.json` and `web/lib/api-schema.d.ts` with the change. -CI checks the server export and regenerated types for drift. Schema export creates -an isolated temporary database, reads no operator environment and starts no server. -Other UI workflows still have manual TypeScript response types. Web tests use -Node.js 24's native TypeScript support; no new Python production dependency is added. - - -### Local source archive - -For a reviewed Windows source-only ZIP with a file checksum manifest, see -[packaging/README.md](packaging/README.md). This excludes dependencies, builds, -tests, test keys and local data. It is not a signed installer or a public release. - - -### Opt-in Streamlit V2 diagnostics - -The original direct probe tools remain disabled. To use the legacy page as a thin -client of the same V2 API/shared worker, start API/worker first, then in PowerShell: - -```powershell -$env:NETGUARDIAN_STREAMLIT_V2 = 'true' -$env:NETGUARDIAN_API_URL = 'http://127.0.0.1:8000' -uv run --locked streamlit run app.py --server.address 127.0.0.1 -``` - -Connect in the V2 diagnostics section with your workspace token. Select an approved -origin and probe, queue a durable job, then select its record and inspect/refresh. -Credentials remain in that Streamlit session and Disconnect V2 clears them. Do not -share browser sessions. The administrator controls the API origin; only HTTPS or -literal-loopback HTTP is accepted. Requests have a total deadline, byte cap, no -redirects and no ambient proxies. Targets are rechecked by the existing API/worker. -This adapter supplies on-demand cloud diagnostics/history, not the full monitoring, -Agent or investigation management UI; use Next.js for those. Unset the flag to -restore the default disabled legacy interface. - -Source archives r1/r2 omitted `.streamlit/config.toml`; when using either old archive, -always pass `--server.address 127.0.0.1` explicitly. The r3 source archive includes -the loopback/security configuration and this adapter. Prefer r3 or a later snapshot. +The project source and documentation are available under the [MIT License](LICENSE). +See [NOTICE.md](NOTICE.md) for third-party and legacy asset scope. diff --git a/docs/operations/LOCAL_DEVELOPMENT.md b/docs/operations/LOCAL_DEVELOPMENT.md new file mode 100644 index 0000000..77d3d35 --- /dev/null +++ b/docs/operations/LOCAL_DEVELOPMENT.md @@ -0,0 +1,460 @@ +# Local Development and Operator Reference + +See the [project overview](../../README.md) for architecture, verification and release scope. + +## Local development setup + +Prerequisites: Python 3.11, uv 0.13.7, Node.js 24 or later, pnpm 11.25.0. +The lockfiles are `uv.lock` and `web/pnpm-lock.yaml`. + +```sh +git clone https://github.com/TYF009/NetGuardian.git +cd NetGuardian +python -m pip install uv==0.13.7 +uv sync --locked +``` + +Configure the following environment in the API, worker and migration shells: + +| Variable | Meaning | +|---|---| +| `NETGUARDIAN_TOKENS` | JSON object mapping random ASCII bearer tokens (32–512 characters) to workspace IDs; required by API/worker | +| `NETGUARDIAN_ORIGINS` | JSON object mapping workspace IDs to exact approved HTTP(S) origins; defaults to no targets | +| `NETGUARDIAN_DATABASE_URL` | SQLAlchemy URL; defaults to `sqlite:///netguardian.db` for local development | +| `NETGUARDIAN_VANTAGE_ID` | Required by the worker: stable non-nil UUID identifying its network location | +| `NETGUARDIAN_ENABLE_SYSTEM_PROBES` | Set to `true` on the worker/agent to enable fixed ICMP/traceroute tools | + +Generate a token locally with `python -c "import secrets; print(secrets.token_urlsafe(32))"`. +Keep it out of source control and shell history. A token mapping has the shape +`{"":"local"}`. An origin mapping has the shape +`{"local":["https://:443"]}`. These are placeholders, not usable +credentials or authorization to probe third-party services. Start with `{}` origins +until you have approved a target you own or are authorized to diagnose. +Configuration files named `.env` are **not loaded automatically** by the Python CLI. + +From the repository root, migrate before starting either service: + +```sh +uv run --locked alembic upgrade head +uv run --locked uvicorn service.api:app_factory --factory --host 127.0.0.1 --port 8000 +``` + +Generate a probe-location UUID once with `python -c "import uuid; print(uuid.uuid4())"` +and set `NETGUARDIAN_VANTAGE_ID` in the worker environment. Preserve it across restarts. +Workers sharing one network location may share it; distinct locations must use distinct +IDs. This is an operator assertion, not automatic location attestation. Old records +retain the legacy shared ID and cannot distinguish historical worker deployments. + +In another shell with the same configuration and repository working directory: + +```sh +uv run --locked python -m service.worker +``` + +In a third shell: + +```sh +cd web +pnpm install --frozen-lockfile +pnpm dev +``` + +Open [the local interface](http://127.0.0.1:3000) and enter the workspace token. +The Web proxy uses `http://127.0.0.1:8000` by default. Override `NETGUARDIAN_API_URL` +only with a trusted API origin. Browser users cannot select the proxy destination. +The API buffers at most 64 KiB per request before JSON parsing, with a 10-second +body-receive deadline (including chunked uploads). This does not replace deployment +connection limits or general request throttling. +Tokens stay in React memory; disconnect remounts the workspace and cancels requests. +A browser abort does not roll back an operation already committed by the API. + +For a local production build, run `pnpm build` then `pnpm start` inside `web/`. +Keep the development services on loopback. Non-loopback operation needs verified +TLS and the unfinished production controls listed in the delivery checklist. + +## Windows local launcher + +After installing the locked Python dependencies, installing Web dependencies and +running `pnpm build` in `web/`, configure the environment variables described above +(including a stable vantage ID). From the repository root: + +```powershell +uv run --locked python -m scripts.run_windows --migrate +``` + +`--migrate` explicitly upgrades the configured database before startup; back up an +existing database first. Omit it on later starts. The launcher requires an existing +production Web build and starts API, worker and Web on fixed loopback ports 8000 +and 3000. It refuses occupied ports, missing configuration or outdated schemas. +It does not install dependencies, generate credentials, approve targets, start an +Agent or configure Ollama. Browser access still requires your workspace token. +The worker uses the configured target policy; use empty origins for a no-probe trial. + +`--check` validates prerequisites without starting services or migrating. For a +bounded smoke run, use `--run-seconds 5`; the timer starts after API and Web are ready. +The worker process is supervised, but this is not a worker health/throughput check. +Ctrl+C or a child-process exit stops the process trees created by this launcher. +Shutdown is forced: in-flight work relies on existing leases and retry rules. +The launcher joins an unnamed Windows Job Object before spawning children; its +termination also terminates owned descendants, including after force-kill. It +refuses startup if the host prevents this containment. This is not a Windows +Service manager or a signed installer. + +Per-run logs remain under ignored `.netguardian-local/`; review and protect them as +local operational data. Credentials are not printed or written by the launcher; +the Web child does not inherit NetGuardian backend configuration or credentials. +Rebuild Web after source changes. This launcher has been smoke-tested on Windows; +it does not change the deferred Linux support scope. + +## Target policy and measurement semantics + +Cloud policy defaults to deny. Only administrator-configured exact origins are +accepted; mixed public/private DNS answers, special addresses, credentials in URLs, +ambiguous hosts and unsupported schemes are rejected. Connections use validated +numeric addresses while retaining the original hostname for Host/SNI and certificate +verification. HTTP uses HEAD, downloads no body, caps headers at 16 KiB and does not +follow redirects. Ambient proxies are not used. The overall probe deadline is at most +10 seconds; only the first approved address is attempted. + +| Measurement | Meaning | +|---|---| +| `dns_lookup_ms` | Resolution and address-policy planning duration | +| `tcp_connect_ms` | TCP connection establishment duration | +| `tls_handshake_ms` | TLS stream setup/handshake duration | +| `http_ttfb_ms` | Time from sending HEAD until the first response byte | +| `http_total_ms` | Total probe time through complete HTTP response headers, including setup | +| `icmp_rtt_ms` | Exact ICMP echo RTT when the OS reports one; less-than bounds remain separate samples | + +HTTP duration is not ICMP RTT. A cloud result describes the worker's network, not the +browser's. TLS evidence does not prove service ownership or certificate revocation +checking. Agent observations are self-reported. + +System probes use canonical numeric addresses and fixed executable/argument lists, +never arbitrary shell commands. ICMP sends one echo; traceroute uses at most 15 hops. +The process runner caps execution at nine seconds and output at 64 KiB. Missing tools +or recognized permission failures are explicit. No automatic privilege elevation is +performed. Locale variations can cause parse failures. Production cloud policy still +rejects loopback; integration tests use an isolated test-only policy. + +## Monitoring and comparisons + +Create a monitor with an approved target, probe kind and cloud/agent vantage. +Intervals are at least 60 seconds. Schedules run independently of browser sessions; +at most one unfinished run exists per monitor. Each workspace currently permits +20 monitors, 20 pending jobs and 60 newly created jobs per rolling 60 seconds. +Manual submissions, diagnostic pairs and schedules share the rate budget, including +completed jobs. Pairs consume two slots. API rejection returns 429/Retry-After; schedules +wait without a catch-up burst. This is not a complete HTTP request-rate limiter. + +Pause prevents new scheduled jobs; queued/running jobs may finish. Resume rechecks +authorization, resets consecutive counters and starts a current cycle without replaying +missed intervals. HTTP 4xx/5xx is unhealthy; policy denial and unsupported capability +are not network outages. Missing results break consecutive counters without recovering +open incidents. Collection freshness is distinct from target health. + +New incidents include the failures that triggered their threshold and subsequent +observations through recovery. Missing measurements are listed explicitly. Links retain +at most the latest 1000 observations; older incidents are not automatically backfilled. + +Compare can queue matching cloud/agent jobs atomically, consuming two pending slots. +Execution is asynchronous. Numeric deltas require compatible target, kind, configuration, +probe version and destination, distinct vantages, successful observations and at most +30 seconds of skew. DNS results record A/AAAA addresses, observed TTL, canonical name and resolver endpoint. +DNS timing deltas remain withheld for every probe kind: an endpoint does not +establish equivalent cache state. Other comparable timings include an explicit +reminder that HTTP total duration includes resolution and connection setup. +IP literal targets skip DNS and leave `dns_lookup_ms` absent. +Differences do not establish causality. + +Monitor **View history** retrieves the latest 100 runs in chronological order via +`GET /api/monitors/{id}/runs`. Choose one timing metric for a scatter plot and an +accessible evidence table. Missing timings are not zero and points are not joined +across gaps. The time axis is server job creation time, not claimed agent observation +time. History is an explicit snapshot; reopen it to refresh. Timing alone does not +establish target health. The initial chart uses a small SVG component rather than a +charting dependency; richer zoom/aggregation is still future work. + +## Optional local agent + +Copy `agent/config.example.json` to an ignored local configuration and set its HTTPS +control API origin. Explicitly list allowed probe origins. Private addresses require +explicit RFC1918/IPv6 ULA `private_cidrs`; loopback, link-local and metadata addresses +remain prohibited. Server jobs cannot expand local policy. The server policy must also +authorize the origin. + +Issue a ten-minute single-use enrollment token from Agents, then run: + +```sh +uv run --locked python -m agent.client --config agent/config.local.json --enroll +uv run --locked python -m agent.client --config agent/config.local.json +``` + +Enter the enrollment token at the hidden prompt. The agent credential is stored in +Windows Credential Manager or Linux Secret Service/KWallet, not the JSON file. The +agent fails closed without a supported store, uses outbound verified HTTPS, and opens +no listener. Revocation stops access, pauses its monitors and terminates pending jobs +without fabricating results. Uploads must match the job, attempt, configuration digest +and lease; identical duplicate uploads are accepted. + +Control responses have a 64 KiB limit and 20-second total deadline; compressed or +malformed responses are rejected. One result is retried in memory, or in an opt-in bounded local spool; see the runbook. +Credential rotation is available through `--rotate-credential`; see the runbook. +Signed distribution and service installers remain unfinished. +Without a configured spool, restarting the agent can lose its pending result. Do not claim offline durability. + +## Reports, AI and audit + +The Reports view reopens the latest 100 saved snapshots without regenerating them. +Readable reports show incident times, recorded findings with in-page evidence citations, +missing observations, limitations and per-observation timings. Raw JSON remains available +for inspection and download. +Reports store redacted snapshots with SHA-256 checksums. Query strings and free-form +errors are removed; paths and addresses remain operational data to review before sharing. +Reads and AI submission recompute the checksum; mismatch returns HTTP 409. The checksum +is not a signature or protection against changing both content and digest. + +Optional AI requires administrator-set `NETGUARDIAN_OLLAMA_URL` and +`NETGUARDIAN_OLLAMA_MODEL`. Remote endpoints require HTTPS; loopback HTTP is allowed. +No model is downloaded automatically. The adapter uses Ollama +[structured output](https://docs.ollama.com/capabilities/structured-outputs) via +[chat](https://docs.ollama.com/api/chat), with a 30-second deadline and 64 KiB response cap. +Only the latest 30 selected evidence records are submitted, excluding URLs, IPs and +endpoint free text. Facts must match recorded values; hypotheses require citations and +remain unverified. Model tools are prohibited. Missing/rejected model output remains +explicit; deterministic reports still work. Real inference quality is not yet evaluated. + +Investigations reopens saved output and source reports without calling the model again. +Audit shows the latest 100 covered operator events. Logs identify roles, not individual +humans, and are not tamper-proof. See the [runbook](../operations/RUNBOOK.md) for scope. + +## Checks and operations + +```sh +uv run --locked ruff check . +uv run --locked ruff format --check . +uv run --locked python -m compileall -q app.py diagnostics.py probe_core service agent migrations tests integration +uv run --locked pytest -q +uv run --locked pytest integration/test_tls.py integration/test_process_cleanup.py -q +``` + +The default unit suite blocks network and process execution. Integration tests are +separate: TLS uses loopback fixtures; process tests launch fixed local Python fixtures. +Windows system-tool tests require `NETGUARDIAN_TEST_SYSTEM_PROBES=true`. +PostgreSQL tests require a disposable `netguardian_test` database and +`NETGUARDIAN_TEST_POSTGRES_URL`; absent configuration produces skips, not verification. +GitHub Actions runs Python checks on Windows and Ubuntu, Web checks on Ubuntu, and PostgreSQL integration tests. See the [CI workflow](../../.github/workflows/ci.yml) for the test matrix. + +Back up existing databases before migration. Do not blindly stamp schemas from old +unversioned development snapshots. Docker Compose configuration is provided but remains +unverified locally. See the [operations runbook](../operations/RUNBOOK.md). + +## Legacy Streamlit and project documents + +The repaired legacy UI remains available with +`uv run --locked streamlit run app.py --server.address 127.0.0.1`. +Its probe entry points are intentionally disabled; use the V2 API/Web path for approved +probes. Streamlit keeps default CORS/XSRF protections. Historical HTTP timing must never +be relabeled as ICMP or component timings. + +- [Product requirements](../product/PRD.md) +- [System design](../architecture/SYSTEM_DESIGN.md) +- [Data model](../architecture/DATA_MODEL.md) +- [Threat model](../security/THREAT_MODEL.md) +- [Implementation plan and original audit](../product/IMPLEMENTATION_PLAN.md) +- [Current delivery gates](../product/DELIVERY_STATUS.md) +- [Browser QA scope](../product/BROWSER_QA.md) + +See [NOTICE.md](../../NOTICE.md) for licensing scope and the optional legacy portrait. + +The Web API proxy bounds POST/PATCH bodies to 8 KiB of raw UTF-8 bytes and a +10-second read deadline, including chunked requests. Encoded/compressed bodies +are rejected. Run its focused regression checks with `cd web` and `pnpm test`. + +Agent jobs have a 120-second delivery window from creation. The scheduler (or an +agent poll) marks overdue unclaimed work and exhausted retries as failed without +a measurement, records an audit event, and releases monitor queue capacity. +A live 30-second lease is allowed to finish. Missing delivery breaks consecutive +incident evidence; it never establishes target failure or recovery. + + +The opt-in local transport integration suite includes +`uv run --locked pytest integration/test_agent_workflow.py -q`. It starts an ephemeral +loopback HTTPS API and HTTP HEAD fixture, enrolls an agent, executes two real probes +(503 then 204), reloads a pending upload from disk, verifies duplicate acceptance, +and checks incident recovery and report evidence. It also executes an atomic cloud/agent +diagnostic pair through both real transports and compares their recorded measurements. Test-only DNS mapping, loopback +address authorization and a private test CA are scoped to the test; production +policies and system certificate trust are unchanged. This is not evidence of a +cross-machine agent installation, all crash boundaries, Linux keyring behavior +or PostgreSQL operation. No public target is contacted. + +Probe version 0.2.1 measures durations with Python `perf_counter`, a high-resolution +monotonic clock. This avoids the coarse Windows Python 3.11 `monotonic` timer. +Historical measurements are preserved; different probe versions are not compared. + +Diagnostic pairs now have persistent IDs and a workspace-scoped history in the +Compare page. Reloading the page does not lose pair membership. Existing jobs are +not retroactively grouped. Generic retention preserves paired evidence; automated +pair expiration is not yet implemented. Apply database migrations before startup. + +TLS certificate/hostname validation failures use `tls_verification_failed`, distinct +from generic transport errors. When available, `error.tls_verify_code` preserves the +TLS runtime verification code; its interpretation is runtime-specific. Failed +verification does not yield verified TLS certificate metadata or an HTTP status. + +Control API admission is process-local: 32 concurrent API requests, a 120-request +burst replenished at 60/second, plus a 60-mutation workspace burst replenished at +1/second. Agent poll/result traffic uses only the global budget. Health endpoints +remain accessible. These are protective defaults, not benchmarked capacity or +aggregate limits across replicas; 429 responses carry `Retry-After`. + + +Windows PostgreSQL 17.11 has now passed local schema, concurrent-worker, +concurrent-startup and tenant-constraint tests, plus the real HTTPS Agent/report/ +comparison workflow. A local dump/restore comparison matched all 12 public tables. +See `docs/operations/RUNBOOK.md` for exact scope and limitations; Docker and Linux +execution are not inferred from these results. The HTTPS integration test now runs +on SQLite and, when the explicitly named disposable PostgreSQL database is configured, +on PostgreSQL as well; otherwise its PostgreSQL case is skipped. + + +Setting `NETGUARDIAN_TEST_KEYRING=true` also opts the HTTPS workflow into a real OS +credential-store rotation check. It creates a randomly named test service, commits +a server credential rotation while retaining the old local credential and pending +rotation entry, then runs normal recovery. It verifies old-token rejection, +new-token access, revocation, and cleanup of both temporary credential entries. +This passed with Windows Credential Manager. It reproduces lost-acknowledgement +state; it does not inject an actual dropped socket or terminate an agent process. + +The model adapter requests identity encoding and rejects compressed responses +before consuming their bodies. Its 64 KiB response cap applies to raw streamed +bytes before JSON decoding. Model transport tests do not establish model quality. + + +The Agent CLI holds an OS file lock for its control origin and agent ID before +opening the keyring or processing jobs. Duplicate instances fail instead of racing +spool writes or credential rotation. Lock files live under `~/.netguardian/locks`; +they remain after exit, but ownership is released by the OS when the process dies. +Do not delete lock files while an agent is running. This coordinates processes +under the same OS user; separate users/machines must not share one enrollment. + + +### Long incident history + +Run `uv run alembic upgrade head` before starting this version. Incident links are +now stored independently of the latest-1000 summary. Authenticated control API +clients can read `/api/incidents/{id}/evidence?after=0&limit=100`, following +`next_after` until it is null. Earlier links already discarded by older versions +cannot be reconstructed. Reports remain bounded snapshots. In the Incidents tab, choose **Browse retained +history** to navigate pages of 100 links and inspect individual observations. Linked jobs are protected from generic retention; +plan storage accordingly. Downgrading populated incident history is refused. + + +### Local Ollama GPU compatibility fallback (Windows) + +The local validation machine could not load Ollama 0.40.14's CUDA runner +(`device kernel image is invalid`). CPU inference worked without driver changes. +To run a separate loopback-only CPU instance, use a PowerShell terminal: + +```powershell +$env:CUDA_VISIBLE_DEVICES = "-1" +$env:OLLAMA_VULKAN = "0" +$env:OLLAMA_HOST = "127.0.0.1:11435" +& "$env:LOCALAPPDATA/Programs/Ollama/ollama.exe" serve +``` + +In the API terminal, configure `NETGUARDIAN_OLLAMA_URL=http://127.0.0.1:11435` +and the installed model name in `NETGUARDIAN_OLLAMA_MODEL`. These are process-local +settings; the default Ollama tray service may still use its original GPU settings. +The official [hardware guide](https://docs.ollama.com/gpu) documents these GPU +selection controls. Stop the CPU server with Ctrl+C when no longer needed. + +Real-model acceptance can be explicitly enabled using an existing verified report: + +```powershell +$env:NETGUARDIAN_TEST_MODEL_REPORT = "C:/path/to/exported-report.json" +$env:NETGUARDIAN_TEST_MODEL_URL = "http://127.0.0.1:11435" +$env:NETGUARDIAN_TEST_MODEL = "qwen2.5:1.5b" +uv run pytest integration/test_model_workflow.py -q +``` + +This opt-in test calls the real model and checks persisted investigation access. +It does not certify diagnosis quality. Qwen2.5 0.5B produced unsupported causal +hypotheses in local testing and is not recommended as the default investigator. + +Qwen2.5 1.5B passed the local CPU integration check against the recorded 503/204 +HTTPS workflow: both facts were correctly cited and no hypothesis was invented. +This single scenario does not establish general diagnostic reliability. + +## License + +Project code and documentation use the [MIT License](../../LICENSE). See [NOTICE.md](../../NOTICE.md) +for third-party components and the unresolved legacy portrait asset scope. + +Current delivery target: **Windows local use**. Linux runtime support and release +validation for deployment are deferred. CI covers selected Linux test scenarios. + + +### Missing cloud-worker results + +Cloud jobs have a 120-second delivery-age limit, separate from the probe's +10-second execution deadline. Old queued jobs and expired leases become failed +without a measurement on the next job read, submission, worker claim or scheduler +tick. Active leases are not interrupted. An offline worker therefore does not +leave observed jobs queued forever, and restarting it will not execute stale work. +Expiry is evaluated when a service handles work; no clock runs while every service +is stopped. Missing measurements do not establish target failure or recovery. +The audit action is `cloud_job.delivery_expired`; each cleanup batch is bounded. + + +### Diagnostic API contract + +Task submission, history and details use generated OpenAPI types and an +`openapi-fetch` client. FastAPI validates their response models, including the +shared measurement envelope. After changing API schemas, run from the root: + +```sh +uv run python -m scripts.export_openapi +cd web +pnpm generate:api +pnpm typecheck +``` + +Commit both `web/openapi.json` and `web/lib/api-schema.d.ts` with the change. +CI checks the server export and regenerated types for drift. Schema export creates +an isolated temporary database, reads no operator environment and starts no server. +Other UI workflows still have manual TypeScript response types. Web tests use +Node.js 24's native TypeScript support; no new Python production dependency is added. + + +### Local source archive + +For a reviewed Windows source-only ZIP with a file checksum manifest, see +[packaging/README.md](../../packaging/README.md). This excludes dependencies, builds, +tests, test keys and local data. It is not a signed installer or a public release. + + +### Opt-in Streamlit V2 diagnostics + +The original direct probe tools remain disabled. To use the legacy page as a thin +client of the same V2 API/shared worker, start API/worker first, then in PowerShell: + +```powershell +$env:NETGUARDIAN_STREAMLIT_V2 = 'true' +$env:NETGUARDIAN_API_URL = 'http://127.0.0.1:8000' +uv run --locked streamlit run app.py --server.address 127.0.0.1 +``` + +Connect in the V2 diagnostics section with your workspace token. Select an approved +origin and probe, queue a durable job, then select its record and inspect/refresh. +Credentials remain in that Streamlit session and Disconnect V2 clears them. Do not +share browser sessions. The administrator controls the API origin; only HTTPS or +literal-loopback HTTP is accepted. Requests have a total deadline, byte cap, no +redirects and no ambient proxies. Targets are rechecked by the existing API/worker. +This adapter supplies on-demand cloud diagnostics/history, not the full monitoring, +Agent or investigation management UI; use Next.js for those. Unset the flag to +restore the default disabled legacy interface. + +Source archives r1/r2 omitted `.streamlit/config.toml`; when using either old archive, +always pass `--server.address 127.0.0.1` explicitly. The r3 source archive includes +the loopback/security configuration and this adapter. Prefer r3 or a later snapshot. diff --git a/packaging/source-files.txt b/packaging/source-files.txt index 520ed22..a2b7fee 100644 --- a/packaging/source-files.txt +++ b/packaging/source-files.txt @@ -18,6 +18,7 @@ compose.yaml diagnostics.py docs/architecture/DATA_MODEL.md docs/architecture/SYSTEM_DESIGN.md +docs/operations/LOCAL_DEVELOPMENT.md docs/operations/RUNBOOK.md docs/product/BROWSER_QA.md docs/product/DELIVERY_STATUS.md From 5efe9aa5efe8da12da0b59e427bd0945fc6a05f8 Mon Sep 17 00:00:00 2001 From: TYF009 Date: Tue, 10 Nov 2026 17:38:32 +0800 Subject: [PATCH 3/4] docs: reconcile verification evidence and asset licensing --- .gitignore | 3 +++ Felix.jpg | Bin 105812 -> 0 bytes NOTICE.md | 9 +++++---- docs/product/DELIVERY_STATUS.md | 22 +++++++++++++++++++--- 4 files changed, 27 insertions(+), 7 deletions(-) delete mode 100644 Felix.jpg diff --git a/.gitignore b/.gitignore index 1848d45..dd18cd2 100644 --- a/.gitignore +++ b/.gitignore @@ -45,3 +45,6 @@ out/ *.pfx *.key !tests/fixtures/tls/server.key + +# Optional local Streamlit portrait with unresolved redistribution rights +/Felix.jpg diff --git a/Felix.jpg b/Felix.jpg deleted file mode 100644 index 8c71e020e33bd1c6fd44cc7f077aafa6a6afdd0b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 105812 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

J;{`-!mv2^cQz0TL?yxsW18*-vQV|D32+2LG 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 z zMZ*2Yeh0ZuMKH#we%aZD=WXLK-GUD*;&ryGZjrH^D2bNr;h=*!>VWg*Se9r_*Ywk( z9JbI83I1&cgP#y@SonU3+iD^R+I(hK2cEX`!L+x-&(}ITaxV?-tUsKXQoC&5q`PJl zg&2M8lYH038E<7u&gGQCD|4K0WxvpUnXjd}rM=GlZU4l*IMQxAl8rdG zb??c8z3rW!sx)G2dSQzc!B+q~ha5+zAHxnPV34yEF+TA@-tWrx?)t>pn}nE@eo{w5 zxuhR5V#S4Kuk?&0jpSD}h)&5&uzv!w2&Hp5{m{!;CnQi~AY-D_;6G1VRvHP`)VbqT z20-{QYRPKA#qM*&)PW!TH96#f2~7uYRQP21i*P$8OQsxrJF6mpyw8)%cYU|DK>n5M zb|!uq{Zx*QwGk?!{vYlc_1o@Rv4E3dkufQ1H5EyZHxkfq8ZD@PZY(7m+kUD-JoNCU zJCvrxAjD{})6<#qycF3Y(6_mu^in){`NyHwt5(I?=ko=dRqqYQ9q~1ov~-Fx&i%0E z%=_EMb*&C!+SjyTbK0JWnj>5LqyE_7%G~*TLDZ2R z=E{Y|4IP^%T)+EZ?}kgOe%HHEe(v$+`n>Z2g=zKm_o&@bLy^iBnH<_TM1)0dO1UQV zazulm0zoMaJnBr*)`YK615}=Q(tqNpF&noAH-8G9(@>>B&|^Z+ln$}ihuAxI0HBYM z0}jdSTZI%oMn!Es?nc@F5R;(k;(xIy=t)2=60?aBSU$7(<8sn^&^*?3y?#0QYPROm zBOlM_PI@3)b$z~7P_A3eyBwOaeO5%KuJn~!5(ko0=;oVkCF3}^$@^&t#yh2*K`ntG z(c^9_RMFz3>WL_a1pR%S8a~Ej4!@Zwi~!9d*|=5;4M#?CXe!d~))Eg>^q?9RCxz@Y z4?Tr4G;3NIt&aXIc#&jv;jvK9FBftpf}`GP)qq^nc`wOtw8)`2cb-u1ovP=PdhbBa z-ZG&+X#Kag(}AQv-b^bhCg?5lY7kBvY)Ni)H+e-zSE=&7=N8{ Date: Tue, 10 Nov 2026 17:49:23 +0800 Subject: [PATCH 4/4] docs: add Simplified Chinese project README --- README.md | 2 + README.zh-CN.md | 127 +++++++++++++++++++++++++++++++++++++ packaging/source-files.txt | 1 + 3 files changed, 130 insertions(+) create mode 100644 README.zh-CN.md diff --git a/README.md b/README.md index 8fe6537..ea36a38 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # NetGuardian — Network Diagnostics & Evidence-Based Troubleshooting Platform +**English** · [简体中文](README.zh-CN.md) + NetGuardian helps IT teams investigate why a service is unreachable by checking each layer of the connection and keeping a record of what each check found. diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000..ca027d8 --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,127 @@ +# NetGuardian · 网络诊断与循证故障排查平台 + +[English](README.md) · **简体中文** + +NetGuardian 帮助 IT 支持人员排查服务为何无法访问。它逐层检查连接,并保留每次测量的结果,便于复盘故障和交接。 + +[快速开始](#快速开始) · [系统架构](#系统架构) · [演示证据](#演示证据) · [测试与验证](#测试与验证) + +## 项目缘起 + +当一台办公电脑能访问服务而前台设备却连不上时,工单通常无法说明问题出在 DNS、TCP 连接、TLS,还是应用本身。我开发 NetGuardian,是为了让这些排查步骤可以重复执行,也让接手的人能看到判断依据。 + +项目从一个 Python 和 Streamlit 工具发展而来,由我独立开发,设计受到 LAN/WLAN、TCP/IP、DNS、DHCP 和 Windows 终端支持工作的启发。本文演示使用受控测试环境。 + +## 核心能力 + +| 能力 | 可以查看的内容 | +| --- | --- | +| 分层诊断 | DNS 记录、TCP 连通性、TLS 握手和证书详情,以及 HTTP HEAD 状态和耗时。可按需启用 ICMP 和 traceroute。 | +| 定时监控 | 暂停和恢复检查,查看最近采集时间、故障及恢复记录。缺少测量时,界面会显示数据缺口。 | +| 双位置对比 | 将服务端检查与已注册的 Windows Agent 检查配对,结合测量端点和时间比较记录。 | +| 事件证据 | 打开脱敏报告快照,验证 SHA-256 摘要,并追溯报告引用的原始观测。 | +| 可选辅助分析 | 配置 Ollama 后可整理报告证据。界面分别展示经过证据校验的结论和待验证的假设。 | + +## 系统架构 + +```mermaid +flowchart LR + Operator["操作人员"] --> Web["Next.js 控制台"] + Web --> API["FastAPI 控制接口"] + API --> DB[("SQLite / PostgreSQL")] + Worker["后台 Worker"] --> DB + Worker --> Engine["共用探测引擎"] + Agent["仅主动出站的 Windows Agent"] -->|"通过 HTTPS 领取任务并上报结果"| API + Agent --> Engine + Engine --> Targets["已授权的目标"] +``` + +- [Web 控制台](web/)与 [FastAPI 接口](service/api.py)负责身份验证、作业提交和工作区数据查询。 +- [Worker](service/worker.py)领取有租约的后台作业并保存观测结果。[Windows Agent](agent/)通过 HTTPS 轮询任务,并独立执行本地目标策略。 +- [探测引擎](probe_core/)在规定的资源和时间范围内执行检查。[Alembic 迁移](migrations/)管理数据库结构,[报告导出](service/report_files.py)校验已保存快照的完整性。 + +[系统设计](docs/architecture/SYSTEM_DESIGN.md) · [数据模型](docs/architecture/DATA_MODEL.md) · [威胁模型](docs/security/THREAT_MODEL.md) + +## 工程实现 + +- **默认拒绝探测。** 服务端只允许预先批准的精确源地址。连接使用校验后的 IP,同时保留 HTTP 和 TLS 所需的主机名。HTTP 探测使用 HEAD,限制响应头大小,并禁止跟随重定向。 +- **分开记录各层耗时。** DNS、TCP、TLS 和 HTTP 保留各自的时间字段。ICMP 往返时延单独记录。 +- **异步执行与重试。** API 接收作业后,由 Worker 或 Agent 执行。作业使用租约与过期机制,Agent 在本地暂存结果,可重新投递已完成的观测。 +- **保留故障依据。** 报告记录当时引用的观测快照,导出后可用 [离线校验脚本](scripts/verify_report.py)核验 SHA-256 摘要。 + +[目标策略与测量说明](docs/operations/LOCAL_DEVELOPMENT.md#target-policy-and-measurement-semantics) + +## 演示证据 + +| 场景 | 验证记录 | +| --- | --- | +| 服务从 HTTP 503 恢复为 HTTP 204 | 受控的回环 HTTPS 服务真实返回两个状态码。本地浏览器验证了监控事件恢复及报告校验。[浏览器记录](docs/product/BROWSER_QA.md#populated-workflow-check-2026-11-05) | +| 下载事件报告 | 使用隔离测试工作区下载报告,并执行离线摘要校验。[导出验证记录](docs/product/BROWSER_QA.md#real-model-investigation-and-report-export-2026-11-06) | +| 查看缺少测量的历史记录 | 使用 101 条合成失败作业测试分页及缺失测量提示。[夹具验证记录](docs/product/BROWSER_QA.md#retained-history-production-web-build-2026-11-05) | + +## 技术栈 + +Python 3.11 · FastAPI · SQLAlchemy · Alembic · SQLite / PostgreSQL · Next.js · React · TypeScript · Node.js 24 · pnpm · pytest · Ruff · GitHub Actions + +## 快速开始 + +在 Windows 上安装 Python 3.11 和 Node.js 24,然后在 PowerShell 中执行: + +```powershell +git clone https://github.com/TYF009/NetGuardian.git +Set-Location NetGuardian +python -m pip install uv==0.13.7 +npm install -g pnpm@11.25.0 +uv sync --locked +pnpm --dir web install --frozen-lockfile +pnpm --dir web build + +$workspaceToken = (uv run --locked python -c "import secrets; print(secrets.token_urlsafe(32))").Trim() +$env:NETGUARDIAN_TOKENS = @{ $workspaceToken = 'local' } | ConvertTo-Json -Compress +$env:NETGUARDIAN_ORIGINS = '{}' +$env:NETGUARDIAN_VANTAGE_ID = [guid]::NewGuid().ToString() +$workspaceToken +uv run --locked python -m scripts.run_windows --migrate +``` + +打开[本地控制台](http://127.0.0.1:3000),输入 PowerShell 显示的测试工作区令牌。目标白名单为空时可以浏览界面。请使用全新检出目录,或在迁移前备份现有数据库。如果要跨会话保留观测并进行比较,请保持 Worker 位置标识稳定。 + +[本地开发与 Agent 注册指南](docs/operations/LOCAL_DEVELOPMENT.md) · [就绪检查、备份与故障排查手册](docs/operations/RUNBOOK.md) + +## 测试与验证 + +GitHub Actions 在 Windows 和 Ubuntu 上运行 Python 检查及选定的运行时测试,并验证 PostgreSQL 集成、Web 测试、TypeScript、OpenAPI 一致性和 Next.js 生产构建。本地 Windows 验证范围涵盖回环 TLS、Agent 作业、数据库及浏览器工作流。[CI 工作流](.github/workflows/ci.yml) · [Windows 交付记录](docs/product/WINDOWS_DELIVERY.md) + +可在仓库根目录复现: + +```sh +uv run --locked ruff check . +uv run --locked ruff format --check . +uv run --locked pytest -q +uv run --locked pytest integration -q -rs +pnpm --dir web test +pnpm --dir web typecheck +pnpm --dir web build +``` + +[集成测试所需环境](docs/operations/LOCAL_DEVELOPMENT.md#checks-and-operations) + +## 当前限制 + +- 当前交付范围为 Windows 本地评估。Docker Compose 部署和更完整的 Linux 运行验证仍待完成。 +- 回环测试覆盖了 Worker 和 Agent 工作流。跨主机部署、Agent 签名分发和持续多副本负载仍待验证。 +- Ollama 辅助分析为可选实验功能,目前只验证过有限的本地场景。 + +[交付状态与验证边界](docs/product/DELIVERY_STATUS.md) + +## 路线图 + +- 发布只读故障与恢复演示,注明数据来源并提供可校验报告。 +- 在干净环境中验证 Compose 启动和数据库迁移,记录支持范围。 +- 在独立测试主机之间验证 Agent 注册、重连和双位置测量。 + +## 作者与许可 + +我拥有通信工程背景和华为 HCIP Datacom 认证,并有 400G 光传送网络以及 IT 基础设施运维经验。NetGuardian 将这些排查经验与 Python 自动化和 Web 证据工作流结合起来。 + +项目代码和文档采用 [MIT 许可证](LICENSE)。第三方组件和历史素材的授权范围见 [NOTICE.md](NOTICE.md)。 diff --git a/packaging/source-files.txt b/packaging/source-files.txt index a2b7fee..4acfd67 100644 --- a/packaging/source-files.txt +++ b/packaging/source-files.txt @@ -6,6 +6,7 @@ Dockerfile LICENSE NOTICE.md README.md +README.zh-CN.md agent/__init__.py agent/client.py agent/config.example.json