{"id":24811097,"url":"https://github.com/lukks/hyperforward","last_synced_at":"2025-10-29T15:36:31.147Z","repository":{"id":44798924,"uuid":"415075953","full_name":"LuKks/hyperforward","owner":"LuKks","description":"Forward peer-to-peer end-to-end encrypted connections","archived":false,"fork":false,"pushed_at":"2022-12-27T01:28:21.000Z","size":430,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-19T06:39:45.842Z","etag":null,"topics":["e2e","encrypted","forward","hyper","noise","p2p"],"latest_commit_sha":null,"homepage":"https://npmjs.com/hyperforward","language":"JavaScript","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/LuKks.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":"2021-10-08T17:38:00.000Z","updated_at":"2024-04-06T15:25:30.000Z","dependencies_parsed_at":"2023-01-31T02:16:00.589Z","dependency_job_id":null,"html_url":"https://github.com/LuKks/hyperforward","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/LuKks/hyperforward","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuKks%2Fhyperforward","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuKks%2Fhyperforward/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuKks%2Fhyperforward/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuKks%2Fhyperforward/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LuKks","download_url":"https://codeload.github.com/LuKks/hyperforward/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuKks%2Fhyperforward/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281647884,"owners_count":26537561,"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","status":"online","status_checked_at":"2025-10-29T02:00:06.901Z","response_time":59,"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":["e2e","encrypted","forward","hyper","noise","p2p"],"created_at":"2025-01-30T12:19:18.306Z","updated_at":"2025-10-29T15:36:31.129Z","avatar_url":"https://github.com/LuKks.png","language":"JavaScript","readme":"# hyperforward\n\nCLI and library to forward peer-to-peer end-to-end encrypted connections.\n\n![](https://img.shields.io/npm/v/hyperforward.svg) ![](https://img.shields.io/npm/dt/hyperforward.svg) ![](https://img.shields.io/github/license/LuKks/hyperforward.svg)\n\n## Install\n```\nnpm i -g hyperforward\n```\n\n## Usage\n```shell\nUsage: hyperforward [options] [command]\n\nCLI to forward P2P E2E encrypted connections\n\nOptions:\n  -v, --version                Output the current version\n  -h, --help                   display help for command\n\nCommands:\n  remote [options] \u003chostname\u003e  Create a P2P server that forwards to a remote hostname\n  local [options] \u003chostname\u003e   Create a local server that forwards to a P2P server\n  keygen \u003cname\u003e                Create a seed key by name\n  add \u003cname\u003e \u003cpublic key\u003e      Add a known public key by name\n  rm \u003cname\u003e                    Remove a key by name\n  print \u003cname\u003e                 Print the public key by name\n  ls                           List my own keys and known peers\n  migrate [options]            Migrate old keys to the new directory and format\n  help [command]               display help for command\n```\n\n### Examples\n#### Public connection\nAlready having a server (TCP, HTTP, SOCKS, VNC, etc) running in your computer o remotely:\n```bash\nhyperforward remote 127.0.0.1:3000\n# Use this temporal public key to connect:\n# 6e7c244099bf7c14314b0e...0fed9c5e22d52a0c0e927c\n```\n\nOther peers can connect to you using the public key:\n```bash\nhyperforward local 127.0.0.1:8080 --connect 6e7c244099bf7c14314b0e...0fed9c5e22d52a0c0e927c\n# Ready to use, listening on: 127.0.0.1:8080\n```\n\nNow you can use the **local 127.0.0.1:8080** as it will be forwarded **to remote 127.0.0.1:3000**\n\n#### Authorization\nCreate named key pair:\n```bash\nhyperforward keygen lukks\n\n# Ask a friend to create their key pair:\nhyperforward keygen cristian\n```\n\n#### Private connection\nSame as the first example but with specific authorization.\n\n1) **lukks** shares the remote server **127.0.0.1:3000** allowing only **cristian**\n```bash\nhyperforward remote 127.0.0.1:3000 --key lukks --firewall cristian\n```\n\n2) **cristian** creates a local server **127.0.0.1:8080** to receive from **lukks**\n```bash\nhyperforward local 127.0.0.1:8080 --key cristian --connect lukks\n```\n\n`--firewall` is a list of names or public keys comma separated.\\\n`--connect` can be a name or public key.\n\n#### Sharing multiple services\nThere is a security limitation: you can only use **one key per forward**.\\\nYou still reuse a single key (ie. lukks, cristian, etc) to easily set firewalls.\n\nLet's say you have multiple things going on:\n\n- **HTTP server** on: **127.0.0.1:3000**\n- **VNC/NoMachine** on: **127.0.0.1:4001**\n- **SOCKS5 proxy** on: **127.0.0.1:1090**\n\n1) **Each service should have their own key pair:**\n\n```bash\nhyperforward keygen http1\nhyperforward keygen vnc1\nhyperforward keygen proxy1\n```\n\n2) **Remote forward each one:**\n\n_In this case, only certain people should be able to use the private VNC service._\n```bash\nhyperforward remote 127.0.0.1:3000 --key http1\nhyperforward remote 127.0.0.1:4001 --key vnc1 --firewall cristian,lukks\nhyperforward remote 127.0.0.1:1090 --key proxy1\n```\n\n3) **Other peers can connect to your services:**\n\nLet's say \"lukks\" would like to use the VNC (as he's authorized):\n```bash\nhyperforward local 127.0.0.1:4001 --key lukks --connect vnc1\n```\n\nLater, anyone would like to use your proxy:\n```bash\nhyperforward local 127.0.0.1:1090 --connect proxy1\n```\n\n## License\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flukks%2Fhyperforward","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flukks%2Fhyperforward","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flukks%2Fhyperforward/lists"}