{"id":13628195,"url":"https://github.com/my-network/ipvpn","last_synced_at":"2026-01-17T02:12:00.603Z","repository":{"id":57485207,"uuid":"193345252","full_name":"my-network/ipvpn","owner":"my-network","description":"[WIP] Easy-to-use decentralized secure overlay private network (for any device)","archived":false,"fork":false,"pushed_at":"2022-12-08T21:51:30.000Z","size":619,"stargazers_count":35,"open_issues_count":12,"forks_count":11,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-11-17T14:42:00.695Z","etag":null,"topics":["android","autodiscovery","automation","decentralized","dht","easy-to-use","golang","ipfs","kademlia","linux","macos","mesh","nat","p2p","secure","vpn","windows","wireguard"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/my-network.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}},"created_at":"2019-06-23T12:27:07.000Z","updated_at":"2024-05-30T10:36:24.000Z","dependencies_parsed_at":"2023-01-25T18:01:38.560Z","dependency_job_id":null,"html_url":"https://github.com/my-network/ipvpn","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/my-network/ipvpn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/my-network%2Fipvpn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/my-network%2Fipvpn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/my-network%2Fipvpn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/my-network%2Fipvpn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/my-network","download_url":"https://codeload.github.com/my-network/ipvpn/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/my-network%2Fipvpn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28492058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T00:50:05.742Z","status":"online","status_checked_at":"2026-01-17T02:00:07.808Z","response_time":85,"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":["android","autodiscovery","automation","decentralized","dht","easy-to-use","golang","ipfs","kademlia","linux","macos","mesh","nat","p2p","secure","vpn","windows","wireguard"],"created_at":"2024-08-01T22:00:48.119Z","updated_at":"2026-01-17T02:12:00.565Z","avatar_url":"https://github.com/my-network.png","language":"Go","funding_links":[],"categories":["Before using VPN, please modify **[DNS](https://www.dnsperf.com/#!dns-resolvers)** to ensure that the vpn server is correct resolve. [How to Change Your DNS](https://www.wikihow.com/wikiHowTo?search=dns) **[Change sim Mobile data APN](https://apkpure.com/apn-settings/net.thenatureweb.apnsettings)**"],"sub_categories":[],"readme":"# Intro\n\nThe parent project is [mynet](https://github.com/my-network/mynet). This module is responsible for creating a VPN\nthrough all required devices. It could be used as a separate solution (on a server, for example), but it was\nsupposed to use [mynet](https://github.com/my-network/mynet) on desktops\n\n# Architecture\n\nWe use:\n* [IPFS](https://ipfs.io/). It's used as:\n  - Node discovery (using their DHT).\n  - Fallback connector (when it's impossible to connect nodes directly).\n  - STUN-replacement (tools to pass-trough a NAT).\n  - Messenger (to send notification among nodes). \n* [WireGuard](https://www.wireguard.com/). It's used as the VPN implementation. If OS doesn't support WireGuard then we\n  detect it and use an userspace implementation.\n\nAn `ipvpn` node is also a full `ipfs` node, so it consumes some traffic background.\n\n# NAT traversal\n\nUsed techniques:\n * [UDP hole punching](https://en.wikipedia.org/wiki/UDP_hole_punching)\n * Planned: [UPnP IGD](https://en.wikipedia.org/wiki/Internet_Gateway_Device_Protocol)\n * Planned: Relaying\n\n# Requirements\n\n## Run:\n\n* Linux or MacOS only, yet\n\n## Build:\n* Linux or MacOS only, yet\n* Go\u003e=1.13\n\n# Quick start\n\nJust run on *all* your nodes (the sample commands):\n```sh\n# install\nGO111MODULE=on go get github.com/my-network/ipvpn/cmd/ipvpnd\nsudo mkdir /var/run/wireguard\nsudo chown $UID /var/run/wireguard\nsudo setcap cap_net_raw,cap_net_admin+ep `go env GOPATH`/bin/ipvpnd\n\n# configure\nmkdir -p \"$HOME/.ipvpn\"\necho \"my_unique_network_name_here\" \u003e \"$HOME/.ipvpn/network_id.txt\"\necho \"my_password_here\" \u003e \"$HOME/.ipvpn/password_new.txt\"\n\n# run\n`go env GOPATH`/bin/ipvpnd\n\n# in other terminal, check:\nip a show dev ipvpn_direct\nip a show dev ipvpn_tunnel\nping -c 5 10.197.202.1\nping -c 5 10.197.203.1\n```\n\n* `my_unique_network_here` should be replaced by a name of you virtual private network\n* `my_password_here` should be replaced by some secret string\n\nThat's it. If `my_unique_network_here` and `my_password_here` will match through all of your nodes then they will build an overlay\nnetwork automatically. \n\n# Similar projects\n* [https://github.com/Gawen/WireHub](https://github.com/Gawen/WireHub)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmy-network%2Fipvpn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmy-network%2Fipvpn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmy-network%2Fipvpn/lists"}