# p1neapplexpress/openflux

> openflux is a network stack research tool that tunnels IPv4 TCP and UDP traffic between a client and an exit node. It carries that traffic over pluggable transports such as Yandex.Docs, Yandex Volga and Yandex Board, and the exit node forwards it to the Internet. The project is written mainly in Go.

Source: https://github.com/p1neapplexpress/openflux
Indexed: commit 74cac6d on 2026-10-09 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Go
- Stars: 2,407 at index time
- License: GPL-3.0
- Code health: 6.7/10, Fair
- Last commit: 2026-10-07
- Contributors: 16

## Install

From the README: https://github.com/p1neapplexpress/openflux#quickstart

Clone the openflux repository.
    git clone https://github.com/p1neapplexpress/openflux.git

Move into the openflux folder.
    cd openflux

Download the module dependencies.
    go mod tidy

Build the openflux binary.
    go build -o openflux .

Run an exit node with the L4 backend, which works on any OS without root.
    ./openflux --role=exit --mode=l4 --transport=yandex --url="YOUR_YANDEX_DOC_URL"

Run a client with a SOCKS5 proxy on 127.0.0.1:1080.
    ./openflux --role=client --inbound=socks5 --transport=yandex --url="YOUR_YANDEX_DOC_URL"

## How it works

main.go is the program entry point, and its --role flag selects whether the binary runs as a client or an exit node. On the client, the tunnel/ directory provides the virtual network interface that captures traffic, and --inbound selects a SOCKS5 proxy or a tun interface. The transport/ directory implements each native and scripted transport together with the session manager, which can run several transports at once and fail over between them. The exit node uses one of the two backends in tunnel/, selected with --mode: l3 forwards raw TCP and UDP with SNAT and DNAT on Linux as root, while l4 terminates connections in a gVisor userspace stack and re-dials the real server. The share/ directory turns shareable links that carry a full client configuration into JSON-ready results, and deploy/ holds the VDS installer script and the sources of the PHP exit.

- cmd/sharewasm/main.go: entry point
- deploy/phpbox/cmd/phpboxfetch/main.go: entry point
- ios-app/OpenFlux/OpenFluxApp.swift: entry point
- main.go: entry point
- mobile/ios/bridge.go: entry point
Modules: transport, root, tunnel, mobile, deploy, provision, ios-app, share. 349 files, 50,783 lines, 3,429 symbols.

## Code health

- Score: 6.7/10 (Fair)
- Rank: #171 of 4,000+ indexed repos
- Hotspots: main.go, transport/session.go, transport/yandex/yandex.go, transport/yandex/boards.go, transport/yandex/vyandex.go
- Lowest file: transport/yandex/yandex.go
- Dead code: 69 findings

## Maintenance

- Last commit 2026-10-07, first commit 2026-06-18, 225 commits
- 16 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/p1neapplexpress/openflux/security

## More

- Page: https://repowise.dev/repo/p1neapplexpress/openflux
- Ask this codebase: https://repowise.dev/repo/p1neapplexpress/openflux/chat
- Docs: https://repowise.dev/repo/p1neapplexpress/openflux/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/p1neapplexpress/openflux
