{"id":13721086,"url":"https://github.com/nishitm/wotop","last_synced_at":"2025-05-07T13:31:39.112Z","repository":{"id":106890270,"uuid":"238398859","full_name":"nishitm/wotop","owner":"nishitm","description":"Web on top of any protocol","archived":false,"fork":false,"pushed_at":"2020-04-29T16:09:55.000Z","size":106,"stargazers_count":115,"open_issues_count":2,"forks_count":9,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-04T01:14:24.151Z","etag":null,"topics":["http-tunnel","protocol","proxy","remote-machine","ssh","traffic"],"latest_commit_sha":null,"homepage":null,"language":"C++","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/nishitm.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}},"created_at":"2020-02-05T08:09:56.000Z","updated_at":"2024-07-16T02:28:10.000Z","dependencies_parsed_at":"2023-03-13T14:38:52.531Z","dependency_job_id":null,"html_url":"https://github.com/nishitm/wotop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nishitm%2Fwotop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nishitm%2Fwotop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nishitm%2Fwotop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nishitm%2Fwotop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nishitm","download_url":"https://codeload.github.com/nishitm/wotop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224604750,"owners_count":17339195,"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":["http-tunnel","protocol","proxy","remote-machine","ssh","traffic"],"created_at":"2024-08-03T01:01:12.320Z","updated_at":"2024-11-14T10:31:03.256Z","avatar_url":"https://github.com/nishitm.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"Web-On-Top-Of-Protocol (WOTOP)\n========================\n\n```\n██╗    ██╗ ██████╗ ████████╗ ██████╗ ██████╗\n██║    ██║██╔═══██╗╚══██╔══╝██╔═══██╗██╔══██╗\n██║ █╗ ██║██║   ██║   ██║   ██║   ██║██████╔╝\n██║███╗██║██║   ██║   ██║   ██║   ██║██╔═══╝\n╚███╔███╔╝╚██████╔╝   ██║   ╚██████╔╝██║\n ╚══╝╚══╝  ╚═════╝    ╚═╝    ╚═════╝ ╚═╝  \n```\n\n# Introduction\n**WOTOP** is a tool meant to tunnel any sort of traffic over a standard HTTP channel.\n\nUseful for scenarios where there's a proxy filtering all traffic except standard HTTP(S) traffic. Unlike other tools which either require you to be behind a proxy which let's you pass arbitrary traffic (possibly after an initial CONNECT request), or tools which work only for SSH, this imposes no such restrictions.\n\n# Working\nAssuming you want to use SSH to connect to a remote machine where you don't have root privileges.\n\nThere will be 7 entities:\n\n1. Client (Your computer, behind the proxy)\n2. Proxy (Evil)\n3. Target Server (The remote machine you want to SSH to, from Client)\n4. Client WOTOP process\n5. Target WOTOP process\n6. Client SSH process\n7. Target SSH process\n\nIf there was no proxy, the communication would be something like:\n```\nClient -\u003e Client SSH process -\u003e Target Server -\u003e Target SSH process\n```\n\nIn this scenario, here's the proposed method:\n```\nClient -\u003e Client SSH process -\u003e Client WOTOP process -\u003e Proxy -\u003e Target WOTOP process -\u003e Target SSH process -\u003e Target Server\n```\n\n**WOTOP** simply wraps all the data in HTTP packets, and buffers them accordingly.\n\nAnother even more complicated scenario would be if you have an external utility server, and need to access another server's resources from behind a proxy. In this case, *wotop* will still run on your external server, but instead of using `localhost` in the second command (Usage section), use the hostname of the target machine which has the host.\n\n# Usage\nOn the client machine:\n```\n./wotop \u003cclient-hop-port\u003e \u003cserver-host-name\u003e \u003cserver-hop-port\u003e\n```\n\nOn the target machine:\n```\n./wotop \u003cserver-hop-port\u003e localhost \u003ctarget-port\u003e SERVER\n```\n(Note the keyword SERVER at the end)\n\nIn case of SSH, the target-port would be 22.\nNow once these 2 are running, to SSH you would run the following:\n\n```\nssh \u003ctarget-machine-username\u003e@localhost -p \u003cclient-hop-port\u003e\n```\n\n*Note*: The keyword server tells *wotop* which side of the connection has to be over HTTP.\n\n# Contributing\nPull Requests are more than welcome! :smile:\n\n# Planned features\n* Better and adaptive buffering\n* Better CLI flags interface\n* Optional encrypting of data\n* Parsing of .ssh/config file for hosts\n* Web interface for remote server admin\n* Web interface for local host\n* Daemon mode for certain configs\n\n# Bugs\n* Currently uses a 100ms sleep after every send/receive cycle to bypass some memory error (not yet eliminated).\n* HTTP Responses may come before HTTP Requests. Let me know if you know of some proxy which blocks such responses.\n* Logger seems to be non-thread-safe, despite locking. Leads to memory errors, and thus disabled for now.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnishitm%2Fwotop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnishitm%2Fwotop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnishitm%2Fwotop/lists"}