{"id":19865803,"url":"https://github.com/Snawoot/hola-proxy","last_synced_at":"2025-05-02T05:32:03.100Z","repository":{"id":37762844,"uuid":"249785519","full_name":"Snawoot/hola-proxy","owner":"Snawoot","description":"Standalone Hola proxy client","archived":false,"fork":false,"pushed_at":"2025-04-24T20:12:46.000Z","size":4995,"stargazers_count":560,"open_issues_count":1,"forks_count":54,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-24T21:20:01.926Z","etag":null,"topics":["hola","http-proxy","https-proxy","proxy","secure-communication","standalone-client"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Snawoot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2020-03-24T18:22:56.000Z","updated_at":"2025-04-24T20:11:28.000Z","dependencies_parsed_at":"2023-01-19T13:16:53.483Z","dependency_job_id":"82a85f6c-ca30-4592-b790-792d0abc8bc0","html_url":"https://github.com/Snawoot/hola-proxy","commit_stats":null,"previous_names":[],"tags_count":51,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snawoot%2Fhola-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snawoot%2Fhola-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snawoot%2Fhola-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Snawoot%2Fhola-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Snawoot","download_url":"https://codeload.github.com/Snawoot/hola-proxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251992993,"owners_count":21677022,"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":["hola","http-proxy","https-proxy","proxy","secure-communication","standalone-client"],"created_at":"2024-11-12T15:24:14.454Z","updated_at":"2025-05-02T05:32:03.092Z","avatar_url":"https://github.com/Snawoot.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# hola-proxy\n\n[![hola-proxy](https://snapcraft.io//hola-proxy/badge.svg)](https://snapcraft.io/hola-proxy)\n\nStandalone Hola proxy client. Just run it and it'll start a plain HTTP proxy server forwarding traffic through Hola proxies of your choice.\nBy default the application listens on 127.0.0.1:8080.\n\nApplication is capable to forward traffic via proxies in datacenters (flag `-proxy-type direct`, default) or via peer proxies on residental IPs (consumer ISP) in that country (flag `-proxy-type lum`).\n\n---\n\n:heart: :heart: :heart:\n\nYou can say thanks to the author by donations to these wallets:\n\n- ETH: `0xB71250010e8beC90C5f9ddF408251eBA9dD7320e`\n- BTC:\n  - Legacy: `1N89PRvG1CSsUk9sxKwBwudN6TjTPQ1N8a`\n  - Segwit: `bc1qc0hcyxc000qf0ketv4r44ld7dlgmmu73rtlntw`\n\n---\n\n## Mirrors\n\nIPFS git mirror:\n\n```\ngit clone https://ipfs.io/ipns/k51qzi5uqu5dkrgx0hozpy1tlggw5o0whtquyrjlc6pprhvbmczr6qtj4ocrv0 hola-proxy\n```\n\n## Features\n\n* Cross-platform (Windows/Mac OS/Linux/Android (via shell)/\\*BSD)\n* Uses TLS for secure communication with upstream proxies\n* Zero configuration\n* Simple and straight forward\n\n## Installation\n\n#### Binaries\n\nPre-built binaries are available [here](https://github.com/Snawoot/hola-proxy/releases/latest).\n\nDon't forget to make file executable on Unix-like systems (Linux, MacOS, \\*BSD, Android). For your convenience rename downloaded file to `hola-proxy` and run within directory where you placed it:\n\n```sh\nchmod +x hola-proxy\n```\n\n#### Build from source\n\nAlternatively, you may install hola-proxy from source. Run the following within the source directory:\n\n```\nmake install\n```\n\n#### Docker\n\nA docker image is available as well. Here is an example of running hola-proxy via DE as a background service:\n\n```sh\ndocker run -d \\\n    --security-opt no-new-privileges \\\n    -p 127.0.0.1:8080:8080 \\\n    --restart unless-stopped \\\n    --name hola-proxy \\\n    yarmak/hola-proxy -country de\n```\n\n#### Snap Store\n\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/hola-proxy)\n\n```bash\nsudo snap install hola-proxy\n```\n\n## Usage\n\nList available countries:\n\n```\n$ ./hola-proxy -list-countries\nar - Argentina\nat - Austria\nau - Australia\nbe - Belgium\nbg - Bulgaria\nbr - Brazil\nca - Canada\nch - Switzerland\ncl - Chile\nco - Colombia\ncz - Czech Republic\nde - Germany\ndk - Denmark\nes - Spain\nfi - Finland\nfr - France\ngb - United Kingdom (Great Britain)\ngr - Greece\nhk - Hong Kong\nhr - Croatia\nhu - Hungary\nid - Indonesia\nie - Ireland\nil - Israel\nin - India\nis - Iceland\nit - Italy\njp - Japan\nkr - Korea, Republic of\nmx - Mexico\nnl - Netherlands\nno - Norway\nnz - New Zealand\npl - Poland\nro - Romania\nru - Russian Federation\nse - Sweden\nsg - Singapore\nsk - Slovakia\ntr - Turkey\nuk - United Kingdom\nus - United States of America\n```\n\nRun proxy via country of your choice:\n\n```\n$ ./hola-proxy -country de\n```\n\nOr run proxy on residential IP:\n\n```\n$ ./hola-proxy -proxy-type lum\n```\n\nAlso it is possible to export proxy addresses and credentials:\n\n```\n$ ./hola-proxy -country de -list-proxies -limit 3\nLogin: user-uuid-0a67c797b3214cbdb432b089c4b801cd\nPassword: cd123c465901\nProxy-Authorization: basic dXNlci11dWlkLTBhNjdjNzk3YjMyMTRjYmRiNDMyYjA4OWM0YjgwMWNkOmNkMTIzYzQ2NTkwMQ==\n\nhost,ip_address,direct,peer,hola,trial,trial_peer,vendor\nzagent783.hola.org,165.22.22.6,22222,22223,22224,22225,22226,digitalocean\nzagent830.hola.org,104.248.24.64,22222,22223,22224,22225,22226,digitalocean\nzagent248.hola.org,165.22.65.3,22222,22223,22224,22225,22226,digitalocean\n```\n\n## List of arguments\n\n| Argument | Type | Description |\n| -------- | ---- | ----------- |\n| backoff-deadline | Duration | total duration of zgettunnels method attempts (default 5m0s) |\n| backoff-initial | Duration | initial average backoff delay for zgettunnels (randomized by +/-50%) (default 3s) |\n| bind-address | String | HTTP proxy address to listen to (default \"127.0.0.1:8080\") |\n| cafile | String | use custom CA certificate bundle file |\n| country | String | desired proxy location (default \"us\") |\n| dont-use-trial | - | use regular ports instead of trial ports |\n| ext-ver | String | extension version to mimic in requests. Can be obtained from https://chrome.google.com/webstore/detail/hola-vpn-the-website-unbl/gkojfkhlekighikafcpjkiklfbnlmeio (default \"999.999.999\") |\n| force-port-field | Number | force specific port field/num (example 24232 or lum) |\n| hide-SNI | Boolean | hide SNI in TLS sessions with proxy server (default true) |\n| init-retries | Number | number of attempts for initialization steps, zero for unlimited retry |\n| init-retry-interval | Duration | delay between initialization retries (default 5s) |\n| limit | Unsigned Integer (Number) | amount of proxies in retrieved list (default 3) |\n| list-countries | String | list available countries and exit |\n| list-proxies | - | output proxy list and exit |\n| proxy | String | sets base proxy to use for all dial-outs. Format: `\u003chttp\\|https\\|socks5\\|socks5h\u003e://[login:password@]host[:port]` Examples: `http://user:password@192.168.1.1:3128`, `socks5://10.0.0.1:1080` |\n| proxy-type | String | proxy type (Datacenter: direct) (Residential: lum) (default \"direct\") |\n| resolver | String | DNS/DoH/DoT resolver to workaround Hola blocked hosts. See https://github.com/ameshkov/dnslookup/ for upstream DNS URL format. (default \"https://cloudflare-dns.com/dns-query\") |\n| rotate | Duration | rotate user ID once per given period (default 48h0m0s) |\n| timeout | Duration | timeout for network operations (default 35s) |\n| user-agent | String | value of User-Agent header in requests. Default: User-Agent of latest stable Chrome for Windows |\n| verbosity | Number | logging verbosity (10 - debug, 20 - info, 30 - warning, 40 - error, 50 - critical) (default 20) |\n\n## See also\n\n* [Project wiki](https://github.com/Snawoot/hola-proxy/wiki)\n* [Community in Telegram](https://t.me/alternative_proxy)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSnawoot%2Fhola-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSnawoot%2Fhola-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSnawoot%2Fhola-proxy/lists"}