{"id":16985417,"url":"https://github.com/fengb/hostcamo","last_synced_at":"2026-04-15T06:35:17.837Z","repository":{"id":145215349,"uuid":"114926330","full_name":"fengb/hostcamo","owner":"fengb","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-13T08:43:06.000Z","size":28600,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-13T10:33:05.373Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/fengb.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-12-20T20:03:22.000Z","updated_at":"2025-03-18T04:20:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"a1065aa7-d6e4-42e1-b78e-78fe93185db6","html_url":"https://github.com/fengb/hostcamo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fengb/hostcamo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengb%2Fhostcamo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengb%2Fhostcamo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengb%2Fhostcamo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengb%2Fhostcamo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fengb","download_url":"https://codeload.github.com/fengb/hostcamo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengb%2Fhostcamo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31830150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-10-14T02:43:25.020Z","updated_at":"2026-04-15T06:35:17.802Z","avatar_url":"https://github.com/fengb.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hostcamo\n\nThis is [my hostfile](https://gitlab.com/fengb/hostcamo/-/jobs/artifacts/master/raw/dist/hosts?job=hosts). There are many like it, but this one is mine.\n\n## Major features\n\n* Uses `255.255.255.255` instead of more error prone `127.0.0.1` or `0.0.0.0` — [more details](docs/ip-address.md)\n* Tiny script — less code is easier to audit\n* Leverages git history — easier to track changes\n* [Pi-Hole adlist](https://raw.githubusercontent.com/pi-hole/pi-hole/557372b3122c6ba27c63e6908ea34f3a64829fb8/adlists.default) — good enough for me\n\n## How to use\n\n#### Sample OpenVPN server — test only, insecure\n\n_Do not trust random VPN servers (including this one); they can easily MITM any network request you make._\n\n1. Download the [OpenVPN profile](https://gitlab.com/fengb/hostcamo/uploads/0c3d0ce1865282788fb0a30a96f9222f/hostcamo-example.ovpn) — SHA256 4748fc7513e5175b71f49f5bbbbe0292242da3e2ab59c5afa4c5f277593547df\n2. Connect using your favorite OpenVPN client — I use [Tunnelblick for macOS](https://tunnelblick.net/) and [OpenVPN Connect for iOS](https://itunes.apple.com/us/app/openvpn-connect/id590379981)\n3. Verify it's working: `nslookup doubleclick.net`\n4. Disconnect, because why are you connecting to a random VPN?\n\n#### OpenVPN using Docker\n\n```bash\n# Use a volume to persist the VPN config\n$ docker volume create openvpn\n\n# Start the server -- first boot is slow because it generates an OpenVPN config\n$ docker run --volume openvpn:/etc/openvpn --env OVPN_SERVER_NAME=[your-hostname] --name hostcamo --detach --publish-all registry.gitlab.com/fengb/hostcamo\n\n# Get the client profile\n$ docker exec hostcamo ovpn_getclient hostcamo \u003e hostcamo.ovpn\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffengb%2Fhostcamo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffengb%2Fhostcamo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffengb%2Fhostcamo/lists"}