{"id":23009207,"url":"https://github.com/matveynator/chicha-tcp-proxy","last_synced_at":"2025-04-02T16:13:06.107Z","repository":{"id":268104454,"uuid":"903318895","full_name":"matveynator/chicha-tcp-proxy","owner":"matveynator","description":"The fastest and simplest solution for port forwarding. Blazing fast.","archived":false,"fork":false,"pushed_at":"2024-12-15T23:38:14.000Z","size":1136,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-08T06:43:24.673Z","etag":null,"topics":["go","golang","high-performance","layer2","nc","netcat","portforward","portforwarding","proxy","socat","tcp","tcp-forwarder","xinetd"],"latest_commit_sha":null,"homepage":"https://files.zabiyaka.net/chicha-tcp-proxy/latest/no-gui/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matveynator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-14T09:46:08.000Z","updated_at":"2024-12-15T23:38:17.000Z","dependencies_parsed_at":"2024-12-14T11:20:23.767Z","dependency_job_id":"e3146c72-f774-4d67-a3b5-15c492857045","html_url":"https://github.com/matveynator/chicha-tcp-proxy","commit_stats":null,"previous_names":["matveynator/chicha-tcp-proxy"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-tcp-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-tcp-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-tcp-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-tcp-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matveynator","download_url":"https://codeload.github.com/matveynator/chicha-tcp-proxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246847138,"owners_count":20843444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","high-performance","layer2","nc","netcat","portforward","portforwarding","proxy","socat","tcp","tcp-forwarder","xinetd"],"created_at":"2024-12-15T09:13:05.385Z","updated_at":"2025-04-02T16:13:06.083Z","avatar_url":"https://github.com/matveynator.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://github.com/matveynator/chicha-tcp-proxy/blob/master/chicha-tcp-proxy.png?raw=true\" width=\"100%\" align=\"right\"\u003e\u003c/img\u003e\n\n\n# Chicha TCP Proxy is the fastest and simplest solution for port forwarding.\n\nChicha TCP Proxy is a lightweight **Layer 2 (L2) proxy** written in **Go**, designed for efficient port forwarding. It’s faster and simpler than traditional tools like `xinetd`, making it ideal for handling high traffic with minimal setup.\n\n---\n\n### **Why Choose Chicha TCP Proxy?**\n- **Blazing Fast**: Written in Go, it fully utilizes all CPU cores for optimal performance.\n- **Simple to Use**: One command to forward traffic—no complex configurations.\n- **Log Rotation**: Automatically compresses logs into `.gz` format daily.\n- **Cross-Platform**: Compatible with all major operating systems and architectures.\n- **Efficient**: Low resource usage even under heavy load.\n\n---\n\n### **Download and Install**\n1. **Download the Binary**:  \n   Choose your platform and architecture from the links below:\n   - [Linux (x86_64)](http://files.zabiyaka.net/chicha-tcp-proxy/latest/no-gui/linux/amd64/chicha-tcp-proxy)\n   - [All Platforms](http://files.zabiyaka.net/chicha-tcp-proxy/latest/no-gui/)\n\n2. **Install the Binary**:  \n   For Linux (x86_64), download and install with:\n   ```bash\n   sudo curl -o /usr/local/bin/chicha-tcp-proxy http://files.zabiyaka.net/chicha-tcp-proxy/latest/no-gui/linux/amd64/chicha-tcp-proxy \u0026\u0026 sudo chmod +x /usr/local/bin/chicha-tcp-proxy\n   ```\n\n---\n\n### **Quick Start Examples**\n\n#### **Single Port Example**\nForward traffic from local port `80` to remote `192.168.0.1:80`:\n```bash\nsudo chicha-tcp-proxy -routes \"80:192.168.0.1:80\" -log /var/log/chicha-tcp-proxy.log\n```\n\n#### **Multiple Ports Example**\nForward multiple ports simultaneously:\n```bash\nsudo chicha-tcp-proxy -routes \"80:192.168.0.1:80,443:192.168.0.1:443,22:192.168.0.2:22\" -log /var/log/chicha-tcp-proxy.log\n```\n\nIn this example:\n- Port `80` on the local machine forwards to `192.168.0.1:80`.\n- Port `443` forwards to `192.168.0.1:443`.\n- Port `22` forwards to `192.168.0.2:22`.\n\n---\n\n### **Systemd Autostart Setup**\n\n1. **Create a Service File**:\n   ```bash\n   sudo mcedit /etc/systemd/system/chicha-tcp-proxy.service\n   ```\n\n2. **Add the Following Content**:\n   ```ini\n   [Unit]\n   Description=Chicha TCP Proxy\n   After=network.target\n\n   [Service]\n   ExecStart=/usr/local/bin/chicha-tcp-proxy -routes \"80:192.168.0.1:80,443:192.168.0.1:443\" -log /var/log/chicha-tcp-proxy.log\n   Restart=on-failure\n\n   [Install]\n   WantedBy=multi-user.target\n   ```\n\n3. Save and exit `mcedit`.\n\n4. **Enable and Start the Service**:\n   ```bash\n   sudo systemctl daemon-reload\n   sudo systemctl enable chicha-tcp-proxy\n   sudo systemctl start chicha-tcp-proxy\n   ```\n\n---\n\n### **Why Chicha TCP Proxy?**\n- **Go-Powered Performance**: Written in Go, ensuring speed and reliability.\n- **Multi-Port Support**: Easily forward traffic for one or multiple ports.\n- **No Complexity**: Simple commands, no bloated configs.\n- **Ready for Production**: Log rotation, compression, and systemd integration make it production-ready.\n\n---\n### **Benchmarks**\n\n#### **chicha-tcp-proxy:**\n\n```\nsiege http://localhost:8081 -t 15s -c 100\n** SIEGE 4.0.4\n** Preparing 100 concurrent users for battle.\nThe server is now under siege...\nLifting the server siege...\nTransactions:\t\t       15728 hits\nAvailability:\t\t      100.00 %\nElapsed time:\t\t       14.65 secs\nData transferred:\t      124.07 MB\nResponse time:\t\t        0.03 secs\nTransaction rate:\t     1073.58 trans/sec\nThroughput:\t\t        8.47 MB/sec\nConcurrency:\t\t       33.37\nSuccessful transactions:       11824\nFailed transactions:\t           0\nLongest transaction:\t        0.25\nShortest transaction:\t        0.00\n```\n\n#### **xinetd:**\n```\nsiege http://localhost:8082 -t 15s -c 100\n** SIEGE 4.0.4\n** Preparing 100 concurrent users for battle.\nThe server is now under siege...\nLifting the server siege...\nTransactions:\t\t       14863 hits\nAvailability:\t\t      100.00 %\nElapsed time:\t\t       14.57 secs\nData transferred:\t      117.20 MB\nResponse time:\t\t        0.04 secs\nTransaction rate:\t     1020.11 trans/sec\nThroughput:\t\t        8.04 MB/sec\nConcurrency:\t\t       36.99\nSuccessful transactions:       11178\nFailed transactions:\t           0\nLongest transaction:\t        0.55\nShortest transaction:\t        0.00\n \n```\n\n#### **direct requests:**\n```\nsiege http://files.zabiyaka.net:80 -t 15s -c 100\n** SIEGE 4.0.4\n** Preparing 100 concurrent users for battle.\nThe server is now under siege...\nLifting the server siege...\nTransactions:\t\t       14778 hits\nAvailability:\t\t      100.00 %\nElapsed time:\t\t       14.14 secs\nData transferred:\t      116.52 MB\nResponse time:\t\t        0.03 secs\nTransaction rate:\t     1045.12 trans/sec\nThroughput:\t\t        8.24 MB/sec\nConcurrency:\t\t       35.07\nSuccessful transactions:       11112\nFailed transactions:\t           0\nLongest transaction:\t        0.19\nShortest transaction:\t        0.00\n```\n\n---\n\n\nChicha TCP Proxy is the **fastest and simplest solution** for port forwarding. Whether forwarding one port or dozens, it's the ideal tool for sysadmins looking for performance and ease of use!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatveynator%2Fchicha-tcp-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatveynator%2Fchicha-tcp-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatveynator%2Fchicha-tcp-proxy/lists"}