gg
A lightweight Linux command-line proxy tool that redirects traffic of any command via a proxy without installing V2Ray.
What is gg?
gg (go-graft) is a Linux command-line proxy tool that lets users redirect the network traffic of any command through a proxy server. It solves the problem of poor network conditions on development servers by providing a lightweight, one-click proxy solution without requiring heavy installations like V2Ray.
Linux developers, researchers, and system administrators who need to proxy command-line tools (e.g., git, curl, docker) on servers with restricted or slow network access.
Developers choose gg for its simplicity, portability, and compatibility with Go applications and UDP traffic, offering a more integrated and lightweight alternative to tools like proxychains or graftcp.
Overview
一个支持节点与订阅链接的 Linux 命令行代理工具 | A command-line tool for one-click proxy in your research and development without installing v2ray or anything else (only for linux)
Use Cases
Best For
- Proxying command-line tools like git, curl, or wget on Linux servers
- Downloading software dependencies behind restrictive firewalls
- Running Go applications through a proxy without modification
- Managing multiple proxy nodes via subscription links
- Redirecting UDP traffic for command-line utilities
- Quickly testing proxy nodes with latency and speed checks
Not Ideal For
- Windows or macOS users needing a cross-platform proxy solution
- Applications requiring GUI-based proxy configuration or deep system integration
- Environments where support for all proxy subscription formats (e.g., Surge, Quantumult) is critical
- Use cases demanding built-in proxy servers or advanced traffic monitoring features
Pros & Cons
Pros
Runs as a single binary without requiring heavy dependencies like V2Ray, making it easy to deploy on servers with minimal overhead.
Handles UDP traffic and works with Go applications, addressing limitations in tools like proxychains that struggle with Go programs and UDP.
Allows prepending 'gg' to any command (e.g., 'gg pip install') for instant proxy routing, simplifying developer workflows on Linux servers.
Supports multiple proxy protocols and subscription links with interactive node selection, latency testing, and caching for efficient use.
Cons
Designed exclusively for Linux (amd64, arm, arm64) with no support for Windows, macOS, or Linux/386, restricting cross-platform adoption.
Lacks support for some proxy subscription formats like Surge and Quantumult, and features like v2ray-plugin, which may be needed in certain setups.
Using sudo with gg requires specific commands like 'sudo -E gg' due to environment variable issues and setuid conflicts, adding operational complexity.
Frequently Asked Questions
Related Projects
sshuttleTransparent proxy server that works as a poor man's VPN. Forwards over ssh. Doesn't require admin. Works with Linux and MacOS. Supports DNS tunneling.
rustnetPer-process network monitoring for your terminal with deep packet inspection. Cross-platform, sandboxed.
acmetool:lock: acmetool, an automatic certificate acquisition tool for ACME (Let's Encrypt)
Certificate Ripper🔐 A CLI tool to extract server certificates
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.