MCPcopy Index your code
hub / github.com/daeuniverse/dae

github.com/daeuniverse/dae @v1.1.0 sqlite

repository ↗ · DeepWiki ↗ · release v1.1.0 ↗
1,029 symbols 2,832 edges 142 files 116 documented · 11%
README

dae

<img src="https://github.com/daeuniverse/dae/actions/workflows/build.yml/badge.svg" alt="Build"/>
<img src="https://custom-icon-badges.herokuapp.com/github/license/daeuniverse/dae?logo=law&color=orange" alt="License"/>
<img src="https://custom-icon-badges.herokuapp.com/github/v/release/daeuniverse/dae?logo=rocket" alt="version">
<img src="https://custom-icon-badges.herokuapp.com/github/issues-pr-closed/daeuniverse/dae?color=purple&logo=git-pull-request&logoColor=white"/>
<img src="https://custom-icon-badges.herokuapp.com/github/last-commit/daeuniverse/dae?logo=history&logoColor=white" alt="lastcommit"/>

dae, means goose, is a high-performance transparent proxy solution.

To enhance traffic split performance as much as possible, dae employs the transparent proxy and traffic split suite within the Linux kernel using eBPF. As a result, dae can enable direct traffic to bypass the proxy application's forwarding, facilitating genuine direct traffic passage. Through this remarkable feat, there is minimal performance loss and negligible additional resource consumption for direct traffic.

As a successor of v2rayA, dae abandoned v2ray-core to meet the needs of users more freely.

Features

  • [x] Implement Real Direct traffic split (need ipforward on) to achieve high performance.
  • [x] Support to split traffic by process name in local host.
  • [x] Support to split traffic by MAC address in LAN.
  • [x] Support to split traffic with invert match rules.
  • [x] Support to automatically switch nodes according to policy. That is to say, support to automatically test independent TCP/UDP/IPv4/IPv6 latencies, and then use the best nodes for corresponding traffic according to user-defined policy.
  • [x] Support advanced DNS resolution process.
  • [x] Support full-cone NAT for shadowsocks, trojan(-go) and socks5 (no test).
  • [x] Support various trending proxy protocols, seen in proxy-protocols.md.

Getting Started

Please refer to Quick Start Guide to start using dae right away!

Notes

  1. If you setup dae and also a shadowsocks server (or any UDP servers) on the same machine in public network, such as a VPS, don't forget to add l4proto(udp) && sport(your server ports) -> must_direct rule for your UDP server port. Because states of UDP are hard to maintain, all outgoing UDP packets will potentially be proxied (depends on your routing), including traffic to your client. This behaviour is not what we want to see. must_direct makes all traffic from this port including DNS traffic direct.
  2. If users in mainland China find that the first screen time is very long when they visit some domestic websites for the first time, please check whether you use foreign DNS to handle some domestic domain in DNS routing. Sometimes this is hard to spot. For example, ocsp.digicert.cn is included in geosite:geolocation-!cn unexpectedly, which will cause some tls handshakes to take a long time. Be careful to use such domain sets in DNS routing.

How it works

See How it works.

TODO

  • [ ] Automatically check dns upstream and source loop (whether upstream is also a client of us) and remind the user to add sip rule.
  • [ ] MACv2 extension extraction.
  • [ ] Log to userspace.
  • [ ] Protocol-oriented node features detecting (or filter), such as full-cone (especially VMess and VLESS).
  • [ ] Add quick-start guide
  • [ ] ...

Contributors

Special thanks goes to all contributors. If you would like to contribute, please see the instructions. Also, it is recommended following the commit-msg-guide.

License

AGPL-3.0 (C) daeuniverse

Stargazers over time

Stargazers over time

Extension points exported contracts — how you extend this code

DnsForwarder (Interface)
(no doc) [5 implementers]
control/dns.go
RulesOptimizer (Interface)
(no doc) [4 implementers]
component/routing/optimizer.go
Locator (Interface)
(no doc) [1 implementers]
component/sniffing/internal/quicutils/relocation.go
UdpHandler (FuncType)
(no doc)
control/udp_endpoint_pool.go
WriteCloser (Interface)
(no doc)
control/tcp.go
FunctionOrString (Interface)
(no doc)
config/config.go
DomainMatcher (Interface)
(no doc) [3 implementers]
component/routing/domain_matcher.go
FunctionListOrString (Interface)
(no doc)
config/config.go

Core symbols most depended-on inside this repo

String
called by 96
control/dns_utils.go
Close
called by 59
control/dns.go
Addr
called by 45
control/dns_listener.go
Len
called by 41
component/sniffing/internal/quicutils/relocation.go
Set
called by 33
control/sysctl.go
String
called by 28
component/outbound/dialer/connectivity_check.go
Get
called by 25
control/sysctl.go
HasPrefix
called by 24
pkg/trie/trie.go

Shape

Method 441
Function 384
Struct 163
TypeAlias 27
Interface 8
FuncType 6

Languages

Go100%
Python1%

Modules by API surface

pkg/geodata/common.pb.go82 symbols
pkg/ebpf_internal/internal/unix/types_other.go34 symbols
common/utils.go31 symbols
component/outbound/dialer/connectivity_check.go29 symbols
pkg/geodata/protoext/extensions.pb.go26 symbols
control/dns_control.go26 symbols
pkg/ebpf_internal/internal/unix/types_linux.go25 symbols
control/dns.go25 symbols
control/control_plane.go24 symbols
pkg/config_parser/walker.go23 symbols
component/sniffing/internal/quicutils/relocation.go23 symbols
control/anyfrom_pool.go21 symbols

Dependencies from manifests, versioned

github.com/adrg/xdgv0.5.0 · 1×
github.com/andybalholm/brotliv1.1.0 · 1×
github.com/awnumar/fastrandv0.0.0-2021031521501 · 1×
github.com/awnumar/memcallv0.3.0 · 1×
github.com/bits-and-blooms/bitsetv1.13.0 · 1×
github.com/daeuniverse/dae-config-dist/go/dae_configv0.0.0-2023060412080 · 1×
github.com/daeuniverse/outboundv0.0.0-2025072206425 · 1×
github.com/daeuniverse/quic-gov0.0.0-2025021014562 · 1×

For agents

$ claude mcp add dae \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact