{"id":23009205,"url":"https://github.com/matveynator/chicha-http-proxy","last_synced_at":"2025-04-02T16:13:01.228Z","repository":{"id":266125405,"uuid":"897451182","full_name":"matveynator/chicha-http-proxy","owner":"matveynator","description":"The easiest and fastest way to mirror websites with minimal setup. Automatic SSL certificates.","archived":false,"fork":false,"pushed_at":"2024-12-15T22:53:36.000Z","size":769,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T06:43:24.296Z","etag":null,"topics":["golang","https","letsencrypt","mirror","netcat","ninjaproxy","proxy","reverse-proxy","socat","ssl","tls","website-mirror","xinetd"],"latest_commit_sha":null,"homepage":"https://files.zabiyaka.net/chicha-http-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-02T16:47:07.000Z","updated_at":"2024-12-15T22:22:54.000Z","dependencies_parsed_at":"2024-12-02T20:31:00.577Z","dependency_job_id":null,"html_url":"https://github.com/matveynator/chicha-http-proxy","commit_stats":null,"previous_names":["matveynator/chicha-zendesk","matveynator/chicha-proxy","matveynator/chicha-http-proxy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-http-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-http-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-http-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matveynator%2Fchicha-http-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matveynator","download_url":"https://codeload.github.com/matveynator/chicha-http-proxy/tar.gz/refs/heads/main","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":["golang","https","letsencrypt","mirror","netcat","ninjaproxy","proxy","reverse-proxy","socat","ssl","tls","website-mirror","xinetd"],"created_at":"2024-12-15T09:13:04.987Z","updated_at":"2025-04-02T16:13:01.208Z","avatar_url":"https://github.com/matveynator.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://github.com/matveynator/chicha-http-proxy/blob/main/chicha-http-proxy.png?raw=true\" alt=\"chicha-http-proxy\" width=\"100%\" align=\"right\" /\u003e\n\n# **chicha-http-proxy: The Easiest Way to Mirror Websites**\n\nChicha HTTP Proxy is a simple yet powerful tool for creating mirrors of websites or services. It forwards traffic to a target URL, supports both HTTP and HTTPS, and can automatically manage SSL certificates from Let's Encrypt. Built with Go, it’s lightweight, fast, and incredibly easy to use.\n\n---\n\n### **Why Choose chicha-http-proxy?**\n- **Create Mirrors in Minutes**: Quickly mirror websites with minimal configuration.  \n- **Blazing Fast**: Powered by Go, mirrors handle high traffic effortlessly.  \n- **Automatic SSL**: Easily enable HTTPS with Let's Encrypt certificates.  \n- **Beginner-Friendly**: Simple setup—just point to the target URL.  \n- **Cross-Platform**: Works on Linux, Windows, macOS, and more.\n\n---\n\n### **Important Notes on Ports and Privileges**\n\n- **Ports for SSL Certificates**:  \n  When using the `--domain` option (for HTTPS with Let's Encrypt):  \n  - HTTP is **always forced to port 80** for certificate validation (cannot be changed).  \n  - HTTPS defaults to port 443, but you can set a custom HTTPS port.  \n\n  If you use port 80 on Linux, you’ll need `sudo` because it’s a privileged port.\n\n- **Custom Ports Without SSL**:  \n  If you don't specify a domain (no SSL), you can use any HTTP port (e.g., 8080) without needing `sudo`.\n\n---\n\n### **Downloads**\n\n- **Linux**: [AMD64](https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui/linux/amd64/chicha-http-proxy), [ARM64](https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui/linux/arm64/chicha-http-proxy)  \n- **Windows**: [AMD64](https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui/windows/amd64/chicha-http-proxy.exe), [ARM64](https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui/windows/arm64/chicha-http-proxy.exe)  \n- **macOS**: [Intel](https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui/mac/amd64/chicha-http-proxy), [M1/M2](https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui/mac/arm64/chicha-http-proxy)\n\n[More platforms here](https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui).\n\n---\n\n### **Installation on Linux/macOS**\n\n```bash\nsudo curl https://files.zabiyaka.net/chicha-http-proxy/latest/no-gui/linux/amd64/chicha-http-proxy -o /usr/local/bin/chicha-http-proxy\nsudo chmod +x /usr/local/bin/chicha-http-proxy\n```\n\nFor Windows, download the `.exe` and add it to your `PATH`.\n\n---\n\n### **Usage Examples**\n\n#### **1. Create a Simple HTTP Mirror (No SSL)**:\nThis creates an HTTP mirror of `twochicks.ru` on port 8080. No admin privileges are required:\n```bash\nchicha-http-proxy --http-port=8080 --target-url=https://twochicks.ru\n```\n\n#### **2. Create a Secure HTTPS Mirror with Automatic SSL**:\nWhen you specify `--domain`, the tool automatically gets an SSL certificate from Let's Encrypt.  \nHTTP is forced to port 80 for validation, and HTTPS defaults to port 443:\n```bash\nsudo chicha-http-proxy --domain=your-domain.com --target-url=https://twochicks.ru\n```\n\n#### **3. Use a Custom HTTPS Port**:\nKeep HTTP on port 80 for validation, but serve HTTPS on a custom port (e.g., 8443):\n```bash\nsudo chicha-http-proxy --domain=your-domain.com --https-port=8443 --target-url=https://twochicks.ru\n```\n\n---\n\n### **Systemd Setup for Autostart**\n\n1. **Create a Service File**:\n   ```bash\n   sudo mcedit /etc/systemd/system/chicha-http-proxy.service\n   ```\n\n2. **Add the Following Configuration**:\n   ```ini\n   [Unit]\n   Description=Chicha HTTP Proxy\n   After=network.target\n\n   [Service]\n   ExecStart=/usr/local/bin/chicha-http-proxy --domain=your-domain.com --target-url=https://twochicks.ru\n   Restart=on-failure\n\n   [Install]\n   WantedBy=multi-user.target\n   ```\n\n3. **Enable and Start the Service**:\n   ```bash\n   sudo systemctl daemon-reload\n   sudo systemctl enable chicha-http-proxy\n   sudo systemctl start chicha-http-proxy\n   sudo systemctl status chicha-http-proxy\n   ```\n\n---\n\n### **Key Features**\n- **Effortless Website Mirroring**: Create fast, functional mirrors in minutes.  \n- **Blazing Fast Performance**: Optimized for high traffic with minimal overhead.  \n- **Automatic HTTPS**: Free SSL certificates with Let's Encrypt.  \n- **Flexible Ports**:  \n  - With `--domain`: HTTP fixed at 80, HTTPS customizable.  \n  - Without `--domain`: Any HTTP port can be used.  \n- **Cross-Platform Support**: Works on Linux, Windows, macOS, and more.\n\n---\n\nChicha HTTP Proxy is the easiest and fastest way to mirror websites with minimal setup. Download it now and start building secure, high-performance mirrors today!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatveynator%2Fchicha-http-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatveynator%2Fchicha-http-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatveynator%2Fchicha-http-proxy/lists"}