# YTwsy/OpenSurge-for-Mac

Surge-style whole-home gateway and control plane for macOS with IPv4/IPv6 support— mihomo TUN, dnsmasq-powered DHCP/DNS, per-device routing, and an agent-friendly validation workspace.

Repository: https://github.com/YTwsy/OpenSurge-for-Mac
Canonical: https://ross.abutalabs.com/products/opensurge-for-mac
Homepage: https://opensurge.pages.dev
Language: Go
License: GPL-3.0
License Family: copyleft
Topics: dhcp, dns, gateway, harness-engineering, loop-engineering, macos, mihomo, transparent-proxy, tun, surge, proxy, dnsmasq, bypass-router, home-network, macos-app, policy-routing
Last push: 2026-08-25T16:30:57+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 99, longevity 4
- inputs: {"age_days": 65, "days_push": 8, "days_rel": 11, "gap_med": 1.0, "n_releases_24m": 13}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2281, forks 155 (observed 2026-08-28T04:06:33.747665+00:00)

## What it is
OpenSurge for Mac is an open-source, Surge-style macOS gateway and control plane that turns a Mac into a whole-home transparent proxy gateway powered by mihomo, with dnsmasq-based DHCP/DNS and TUN networking. It supports bypass-router, LAN DHCP takeover, and downstream LAN modes with per-device routing policies and an agent-friendly validation workspace.

## Use cases
- turn my mac into a whole-home proxy gateway
- route game console and tv traffic through a proxy without installing apps on them
- set up a bypass router on macos with per-device rules
- take over lan dhcp and dns from a mac
- give each device in my house a different proxy exit policy
- run a surge-style transparent proxy on apple silicon
- manage household network routing from one control plane

## When to choose
- you want Surge-style whole-home transparent proxying on a Mac you already own
- devices like consoles, TVs, or VR headsets can't run proxy clients and need gateway-level routing
- you want per-device routing policies with DHCP/DNS takeover and a web GUI
- you prefer an open-source, self-hosted gateway with mihomo compatibility

## When to avoid
- you need a production router for a large or business network rather than a home setup
- you require stable IPv6 takeover, which is still experimental
- you want a dedicated hardware router solution instead of dedicating a Mac as the gateway
- you need non-macOS platforms

## Facets
- artifact type: application
- maturity: active
- function: proxy, networking, routing, caching, gui, monitoring
- domain: networking, self-hosted, privacy, developer-tools, censorship-circumvention
- platform: self-hosted, go
- tags: transparent-proxy, tun, mihomo, dnsmasq, dhcp-server, bypass-router, whole-home-gateway, per-device-routing, surge-style, policy-routing, ipv6, web-gui, menubar-app, macos, desktop

## Member repositories
- YTwsy/OpenSurge-for-Mac (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:33.747665+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:41:20.545725+00:00, confidence not recorded.
  - readme: https://github.com/YTwsy/OpenSurge-for-Mac (fetched 2026-08-28T04:06:33.747665+00:00, sha 754bc6a479ea)
  - homepage: https://opensurge.pages.dev (fetched 2026-08-29T10:21:32.325199+00:00, sha a6d66efe2411)
- Data as of 2026-08-30T08:39:29.467469+00:00.