Skip to content
Prizrak-Box Prizrak-Box Prizrak-Box

About App

Overview

Section titled “Overview”

Prizrak-Box is an open-source, cross-platform proxy client built on top of Mihomo (formerly Clash.Meta). It provides a user-friendly graphical interface for managing proxy subscriptions, monitoring traffic, and applying routing rules.

Prizrak-Box main screen

Key Features

Section titled “Key Features”

Remote Subscriptions

Add and manage remote proxy subscriptions with automatic periodic updates. Supports Clash YAML format.

Proxy Keys

Supports direct proxy keys (vless://, hy2://, and others) — built-in configurable templates are available for profiles without a Mihomo configuration.

AGE Encryption

Supports age-encrypted subscription files. Decrypt with your private key stored securely in the profile.

Traffic Monitoring

View and manage active proxy connections in real-time via the Connections section in app settings.

Routing Rules

Built-in templates with routing rules for Russia and China — routing based on geo-IP and domain lists.

TUN Mode

System-level traffic capture via TUN interface — routes all device traffic through the proxy without per-app configuration.

Supported Platforms

Section titled “Supported Platforms”
PlatformStatus
Windows (arm64, x64)✅ Supported
macOS (arm64, x64)✅ Supported
Linux (arm64, x64)✅ Supported
Android (arm64, armv7, x86_64)✅ Supported

Subscription Management

Section titled “Subscription Management”

Managing profiles

Prizrak-Box supports three types of profiles:

  1. Remote Subscription — fetched from a URL with optional auto-update interval
  2. Local Configuration — a local Clash YAML file
  3. Crawl & Merge — aggregated from multiple sources
  4. Proxy Keys — direct connection keys (vless://, hy2://, and others) with built-in configurable templates

When a remote subscription is fetched, the server can return HTTP response headers to control the client behavior — see Supported Headers for the full reference.

Architecture

Section titled “Architecture”

The app is structured as:

  • Wails v3 (Windows, macOS) — native desktop shell rendering the Vue 3 UI
  • Electron (Linux) — desktop shell rendering the Vue 3 UI
  • Android — Jetpack Compose UI
  • Go backend (px) — HTTP API, subscription management, BoltDB persistence
  • Go service (px-service) — elevated system service for TUN mode (Windows, Linux, macOS)
  • Mihomo core — proxy routing engine (custom fork) embedded in the Go binary