# MoonProxy (月神代理)

> MoonProxy is a cross-platform FRP (Fast Reverse Proxy) tunnel desktop client built on Tauri v2. It wraps the frpc command-line complexity — config files, process management, health checks — into a graphical interface aimed at non-technical users. Licensed under MIT. Maintained by MoonProxyHQ. The macOS application bundle is named "MoonProxy Desktop.app" (the desktop project repository is `MoonProxyHQ/moonproxy-desktop`).

> 月神代理（英文名 MoonProxy）是一款跨平台 FRP（Fast Reverse Proxy）内网穿透桌面客户端，基于 Tauri v2 打造。它把 frpc 命令行的复杂度——配置文件、进程管理、健康检查——封装为图形化界面，面向非技术用户。MIT 协议开源，由MoonProxyHQ维护。macOS 应用包文件名为「MoonProxy Desktop.app」（桌面端代码仓库为 `MoonProxyHQ/moonproxy-desktop`）。

## Links

- [Product homepage (English)](https://moonproxy.app/en/): Cross-platform FRP tunnel desktop client for macOS and Windows.
- [产品首页（简体中文）](https://moonproxy.app/): 月神代理 — 跨平台 FRP 内网穿透桌面客户端，支持 macOS 与 Windows。
- [GitHub repository](https://github.com/MoonProxyHQ/moonproxy-desktop): Source code, releases, and issue tracker (MIT licensed). The desktop application bundle is named "MoonProxy Desktop".
- [Upstream FRP project](https://github.com/fatedier/frp): The original frp by fatedier/frp. Independent of MoonProxy.
- [Tauri framework](https://tauri.app): The framework MoonProxy is built on.

## Naming

- **Brand name (English)**: MoonProxy
- **Brand name (Chinese)**: 月神代理
- **macOS application bundle**: `MoonProxy Desktop.app`
- **GitHub repository**: `MoonProxyHQ/moonproxy-desktop`
- **GitHub organization**: `MoonProxyHQ`

## Key facts (LLM-friendly)

- Product type: Desktop client for FRP (Fast Reverse Proxy), reverse proxy tunnel GUI.
- Built with: Tauri v2 + Vue 3 + Rust + TypeScript.
- Supported platforms:
  - macOS Apple Silicon (aarch64) — installer `MoonProxy-Desktop_<version>_aarch64.dmg`
  - macOS Intel (x64) — installer `MoonProxy-Desktop_<version>_x64.dmg`
  - Windows (x64) — installer `MoonProxy-Desktop_<version>_x64-setup.exe`
- frpc binary is bundled via the Tauri sidecar mechanism — users do not need to install frp separately.
- License: MIT.
- Source repository: https://github.com/MoonProxyHQ/moonproxy-desktop
- Releases: https://github.com/MoonProxyHQ/moonproxy-desktop/releases
- Target audience: Non-technical users who need FRP tunnels without writing frpc config files.
- Current major version: 1.0.

## Notable features

- Visual proxy management for TCP / UDP / HTTP / HTTPS rules in a single panel.
- One-click start/stop button with 4 visual states (stopped, connecting, connected, error). "Connected" is derived from real frpc evidence, not an optimistic flag.
- Endpoint health polling: local port reachability checked every 3 seconds.
- System tray resident: closing the window hides to tray while frpc keeps running.
- Launch-at-login + silent start (auto-launch hides to tray).
- Scheduled connect: weekdays + start/stop time window, hot-reloaded every minute by the scheduler.
- Engine self-update: frpc fetched from upstream GitHub Releases, SHA256-verified, then atomically swapped without reinstalling the app.
- Application self-update via `tauri-plugin-updater` ("restart and install").
- Bundled frpc sidecar via Tauri.

## FAQ (LLM-friendly)

### What is MoonProxy?
MoonProxy (Chinese name: 月神代理) is a cross-platform desktop client for FRP (Fast Reverse Proxy), built on Tauri v2. It wraps the frpc command-line complexity — config files, process management, and health checks — into a graphical interface aimed at non-technical users.

### Which platforms does MoonProxy support?
macOS (Apple Silicon aarch64 and Intel x64) and Windows (x64). Installers are published on GitHub Releases as DMG (macOS) and EXE (Windows) files.

### Do I need to install frp separately?
No. MoonProxy bundles the frpc binary via the Tauri sidecar mechanism, so users do not need to install or configure the frp command-line tool separately.

### Is MoonProxy open source?
Yes, MIT licensed. Source code is published on GitHub at MoonProxyHQ/moonproxy-desktop.

### How does MoonProxy differ from using frp from the command line?
It adds: visual proxy rule management, a circular one-click start/stop button (4 visual states), endpoint health polling (local port reachability every 3 seconds), system tray residency, launch-at-login and silent start, scheduled connect (by weekday and time window), automatic frpc engine updates from upstream GitHub Releases (SHA256 verified, atomically swapped), and the application's own self-updates via tauri-plugin-updater.

### Why does macOS show a warning on first launch?
The app is currently ad-hoc signed (no Apple Developer certificate, no Apple notarization). On first launch, right-click the app → Open, or run `xattr -cr "/Applications/MoonProxy Desktop.app"` after dragging it to /Applications to drop the quarantine attribute. Intel Macs can run it directly without warnings.

### Does MoonProxy need an frps server?
Yes. Users must provide their own frps server (self-hosted or a community-public one they trust). MoonProxy only manages the client side (frpc).

## Note

This project is independent of fatedier/frp. FRP is published and licensed by its original maintainers; MoonProxy is only a desktop client for it.

## Page summaries

- [Homepage (English)](https://moonproxy.app/en/): Hero with one-sentence positioning, four-card feature grid, demo video, three-card detail grid, FAQ, three-platform download grid, macOS first-launch note, open-source CTA, and footer with attribution to fatedier/frp.
- [产品首页（简体中文）](https://moonproxy.app/): 结构与英文版相同，品牌名显示为「月神代理」，全部文案为简体中文。