Repository navigation
Releases
Releases · Ziqi/starhub-kit
StarHub Kit v1.3.0 — AI Sandbox Firewalls, Multi-Target Compiler & Native MCP Server
StarHub Kit v1.3.0 — AI Agent Sandbox Firewalls, Multi-Target Compiler (nftables/pf/Tailscale ACL/Sing-box), Auditor & Native MCP Server
Highlights
- Autonomous AI Coding Agent Sandbox Profile (
--profile ai-sandbox): Turnkey clean-room topology isolating autonomous coding sandboxes — blocks cloud metadata SSRF (169.254.169.254,fd00:ec2::254), inbound SSH (TCP/22), and lateral movement into private LAN/Tailscale peers. - Multi-Target Policy Compiler (
--target): Compile one topology JSON into Linuxnftables(inet),macOS pfanchors,Tailscale ACLHuJSON,Sing-box(v1.11+), Mihomo, andiptables/ip6tables(./bin/starhub render --profile ai-sandbox --target all --dry-run). - Static Topology Security Auditor (
starhub audit) & Native MCP Server (starhub mcp): Exposescompile_ai_sandbox_policy,render_quic_mesh_guardrails, andaudit_topology_securityover zero-dependency JSON-RPC 2.0stdio(98.00%statement coverage, 2,000 fuzz iterations). - Bit-for-Bit Reproducible PAX Archive:
./bin/starhub archive --prefix starhub-kit-v1.3.0 --verify-file starhub-kit-v1.3.0.tar.gz(sha256=f457c55abba087f2fd9ef66dbc5c685e62db6e4396a1d7f23de06ef0a9f6d3a7).
StarHub Kit v1.2.0 — Modular Dry-Run, Reproducible Builds, Nix Flake & OSPS L3
StarHub Kit v1.2.0 — Modular Non-Root Preview, Reproducible Builds, Nix Flake & OSPS Baseline L3
Highlights
- 10-Second Modular
--dry-runPreview: Run./bin/starhub render --profile minimal --only mihomo --dry-runor--only ai-sandbox --dry-runto inspect deterministic outputs onstdoutwithout root privileges or disk writes. - Bit-for-Bit Reproducible Release Archives:
./bin/starhub archive --verifynormalizes PAX headers (mtime=0,uid/gid=0, sorted paths) so any auditor can verifystarhub-kit-v1.2.0.tar.gzbyte-for-byte from tagv1.2.0(sha256=2e14ca825474ebea21b677705ccdcd151539700406bab6e3e0154ae9bcefd7ba). - Zero-Dependency Nix Flake: Run directly via
nix run github:Ziqi/starhub-kit -- render --profile minimal --only mihomo --dry-run. - First-Screen Funnel & OpenSSF OSPS Baseline (Level 3): De-jargonized bilingual READMEs with embedded 15-second vector terminal walkthrough (
assets/terminal-demo.svg) and full OSPS Baseline L3 control matrix inSECURITY.md.
StarHub Kit v1.1.0 — 3-Tier Lightweight Adoption & English Playbook
StarHub Kit v1.1.0 — 3-Tier Progressive Adoption (Tier 0 Drop-In + StarHub Lite) & English Playbook
You no longer need a multi-VM homelab to adopt StarHub Kit's protocol governance and zero-trust guardrails:
Highlights
- Tier 0 · Zero-Python Standalone Mihomo × Tailscale Pack (
scripts/profiles/standalone-mihomo-tailscale-guardrails.yaml)- Copy-paste
dns:andrules:directly into OpenWrt (OpenClash/Nikki), Clash Verge Rev, Mihomo Party, or Stash in 30 seconds. - Prevents
198.18.0.0/16Fake-IP × Tailscale loops, eliminates blindfallback:DNS racing, enforcesSection 9asurgicalUDP/443 REJECTfor Apple Media & Mobile Gmail attachments, and preserves native HTTP/3 QUIC for YouTube 4K Cronet (googlevideo.com).
- Copy-paste
- Tier 1 ·
StarHub LiteSingle-Gateway Template (profiles/topology.minimal.json)- Designed for users with 1 Gateway (
gw) + 1 Laptop (laptop) + 1 Egress (vps1) (no Proxmox VE, no custom DERP, no secondary relays). - Run
./bin/starhub render --profile minimal --out-dir ./dist-minimalto compile a clean 5-file deployment bundle.
- Designed for users with 1 Gateway (
- English Architecture & Protocol Playbook (
docs/ARCHITECTURE-AND-PLAYBOOK-EN.md)- Full English deep-dive into packet-level root causes, rule ordering invariants, and Cloud AI Sandbox
B2zero-SSH isolation (STARHUB-TS-NOSSH/STARHUB-TS6-NOSSH).
- Full English deep-dive into packet-level root causes, rule ordering invariants, and Cloud AI Sandbox
Supply-Chain Verification Assets
starhub-kit-v1.1.0.tar.gz— Deterministic source archivestarhub-kit-v1.1.0.tar.gz.sha256— SHA-256 checksumstarhub-kit-v1.1.0.tar.gz.sig— Detached Ed25519 signature (keys/release-signing-pub.pem)starhub-kit-v1.1.0.tar.gz.intoto.jsonl— DSSE-signed SLSA v1.0 / in-toto provenance attestationstarhub-kit-v1.1.0.spdx.json— SPDX 2.3 Software Bill of Materials (SBOM)
StarHub Kit v1.0.3 — OpenSSF Best Practices Silver (#16658) & Mobile QUIC Guardrails
StarHub Kit v1.0.3 — OpenSSF Best Practices Silver (#16658) & Mobile QUIC Ordering Guardrail
Highlights
- OpenSSF Best Practices
SilverCertified (Project #16658): Achieved100%across both Passing (67/67) and Silver (55/55) criteria (tiered_percentage: 200) on bestpractices.dev/projects/16658. - Section 9a Mobile Gmail / Image-Proxy QUIC Fallback Guardrail: Added explicit
AND,((NETWORK,UDP),(DST-PORT,443),...),REJECTordering rules andDIM3-QUIC-FALLBACK-DOMAINScontinuous verification for 21 Gmail, attachment (mail-attachment.googleusercontent.com), and inline image-proxy (ci3~6.googleusercontent.com,lh3~6.googleusercontent.com,robinfrontend-pa.googleapis.com) endpoints, while preserving native QUIC (HTTP/3) for YouTube (googlevideo.com). - Vendor-Neutral Role-Based Reference Topology & OPSEC History Gate: Standardized role-based node, IoT, and egress identifiers across
topology.example.jsonandSTARHUB_GROUND_TRUTH.json, backed by dynamic working-tree +git log -p --allverification instarhub-doctor.py --verify-public-export.
Supply-Chain Verification Assets
Every v1.0.3 release includes:
starhub-kit-v1.0.3.tar.gz— deterministic source archivestarhub-kit-v1.0.3.tar.gz.sha256— SHA-256 checksum manifeststarhub-kit-v1.0.3.tar.gz.sig— offline Ed25519 detached signature (security/release-signing-pubkey.pem)starhub-kit-v1.0.3.tar.gz.intoto.jsonl— DSSE-signed SLSA v1.0 / in-toto provenance bundlestarhub-kit-v1.0.3.spdx.json— SPDX 2.3 Software Bill of Materials (SBOM)- GitHub OIDC Sigstore Fulcio X.509 build provenance & SBOM attestations (
gh attestation verify starhub-kit-v1.0.3.tar.gz --repo Ziqi/starhub-kit)
StarHub Kit v1.0.2 — Clean-Room Declarative Baseline
StarHub Kit v1.0.2 — Clean-Room Role-Based Declarative Baseline
Summary
- Clean-room vendor-neutral role-based declarative baseline for StarHub Kit (
STARHUB_GROUND_TRUTH.json+topology.example.json), 7 deterministic zero-dependency stdlib-compiled gateway/workstation/sandbox artifacts, 30-checkstarhub-doctor.pyEGM verification harness, REUSE 3.3 / SPDX compliance,>98%statement coverage gate, and 2,000-iteration fuzzing suite. - Superseded immediately by
v1.0.3with OpenSSF Best PracticesSilver(#16658) badge integration and Section 9a mobile Gmail QUIC ordering guardrails.