{"id":13538078,"url":"https://github.com/redteamoperations/pivotsuite","last_synced_at":"2025-12-13T16:20:14.672Z","repository":{"id":55134578,"uuid":"184387928","full_name":"RedTeamOperations/PivotSuite","owner":"RedTeamOperations","description":"Network Pivoting Toolkit","archived":false,"fork":false,"pushed_at":"2023-08-26T10:26:13.000Z","size":581,"stargazers_count":439,"open_issues_count":8,"forks_count":91,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-03-03T23:53:46.493Z","etag":null,"topics":["enterprise","hacking","pentest-tool","pivoting","post-exploitation","redteam","redteam-infrastructure"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RedTeamOperations.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-05-01T08:19:54.000Z","updated_at":"2025-03-03T18:54:12.000Z","dependencies_parsed_at":"2023-10-21T00:00:35.396Z","dependency_job_id":null,"html_url":"https://github.com/RedTeamOperations/PivotSuite","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":0.3157894736842105,"last_synced_commit":"9078d1ede1f076d30b6d72ca14e05ddf991f51f4"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedTeamOperations%2FPivotSuite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedTeamOperations%2FPivotSuite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedTeamOperations%2FPivotSuite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedTeamOperations%2FPivotSuite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RedTeamOperations","download_url":"https://codeload.github.com/RedTeamOperations/PivotSuite/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246763787,"owners_count":20829794,"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":["enterprise","hacking","pentest-tool","pivoting","post-exploitation","redteam","redteam-infrastructure"],"created_at":"2024-08-01T09:01:06.350Z","updated_at":"2025-12-13T16:20:09.632Z","avatar_url":"https://github.com/RedTeamOperations.png","language":"Python","funding_links":[],"categories":["\u003ca id=\"9eee96404f868f372a6cbc6769ccb7f8\"\u003e\u003c/a\u003e新添加的"],"sub_categories":["\u003ca id=\"31185b925d5152c7469b963809ceb22d\"\u003e\u003c/a\u003e新添加的"],"readme":"#### DISCLAIMER: This software is for educational purposes only. This software should not be used for illegal activity. The author is not responsible for its use.\n\n# PivotSuite\n#### PivotSuite: Hack The Hidden Network -  A Network Pivoting Toolkit\n\n#### Description \nPivotSuite is a portable, platform independent and powerful network pivoting toolkit, \nWhich helps Red Teamers / Penetration Testers to use a compromised system to move around inside a network. \nIt is a Standalone Utility, Which can use as a Server or as a Client.\n\n##### PivotSuite as a Server : \nIf the compromised host is directly accessable (Forward Connection) from Our pentest machine,\nThen we can run pivotsuite as a server on compromised machine and access the different subnet hosts from our pentest machine, \nWhich was only accessable from compromised machine. \n\n##### PivotSuite as a Client : \nIf the compromised host is behind a Firewall / NAT and isn't directly accessable from our \npentest machine, Then we can run pivotsuite as a server on pentest machine and pivotsuite as a client on compromised machine\nfor creating a reverse tunnel (Reverse Connection). Using this we can reach different subnet hosts from our pentest machine,\nwhich was only accessable from compromised machine. \n\n\n#### Key Features: \n1. Supported Forward \u0026 Reverse TCP Tunneling\n2. Supported Forward \u0026 Reverse socks5 Proxy Server\n3. UDP over TCP and TCP over TCP Protocol Supported\n4. Corporate Proxy Authentication (NTLM) Supported\n5. Inbuilt Network Enumeration Functionality, Eg. Host Discovery, Port Scanning, OS Command Execution \n6. PivotSuite allows to get access to different Compromised host and their network, simultaneously (Act as C\u0026C Server) \n7. Single Pivoting, Double Pivoting and Multi-level pivoting can  perform with help of PivotSuite. \n8. PivotSuite also works as SSH Dynamic Port Forwarding but in the Reverse Direction.   \n\n\n#### Advantage Over Other tools:\n\n1. Doesn't required admin/root access on Compromised host\n2. PivotSuite also works when Compromised host is behind a Firewall / NAT, When Only Reverse Connection is allowed. \n3. No dependency other than python standard libraries.\n4. No Installation Required \n5. UDP Port is accessable over TCP\n\n#### Installation\n1. You can download the latest version of pivotsuite by cloning the Git repository or PyPI Package.\n\n       git clone https://github.com/RedTeamOperations/PivotSuite.git\n            \n                  OR\n                  \n        pip install PivotSuite\n     \n     PivotSuite works out of the box with Python version 2.7.x and 3.6.x on any platform.\n     \n2. PivotSuite Standalone Executable Download from Github Release Section \n\n       https://github.com/RedTeamOperations/PivotSuite/releases\n       \n      No installation require, No python interpreter require \n----------------------------------------------------------------------------------------------------------------------------\n\n #### Requirements:\n \n    a. Only Python Standard Libraries are Required\n    b. Compatible for both Python 2.7.x \u0026 Python 3.6.x\n    c. Tested on Windows and Linux. \n\n #### Usages :\n  \n  $ pivotsuite.py [options] SERVER-IP SERVER-PORT\n\n\nOptions:\n\n     --version             show program's version number and exit\n  \n    -h, --help            show this help message and exit\n  \n    -S, --server          Run PivotSuite as a Server\n  \n    -C, --client          Run PivotSuite as a Client\n  \n     - -server-ip=SERVER_IP\n  \n                        Server Listen/Connect IP address, Default  0.0.0.0\n                        \n     --server-port=SERVER_PORT\n  \n                        Server Listen/Connect Port, Default 7777\n                        \n\n  PivotSuite Server Options:\n  \n    -F, --forward-connection\n    \n                        Forward Network Traffic\n                        \n    --server-option=SP/PF\n    \n                        Use Server as Socks_Proxy(SP)/Port_Forward(PF),\n                        Default SP\n                        \n    --network-protocol=T/U\n    \n                        Select Protocol For Port Forwarding TCP(T)/ UDP(U),\n                        Default T\n                        \n    --forward-ip=Remote-Host-IP\n    \n                        Remote Host IP for Port Forwarding\n                        \n    --forward-port=Remote-Host-Port\n    \n                        Remote Host Port for Port Forwarding\n                        \n    -W, --reverse-connection\n    \n                        Reverse Network Traffic\n\n\n  PivotSuite Client Options:\n  \n    -O SP/PF/NE, --option=SP/PF/NE\n                        Use Client as Socks_Proxy(SP)/ Port_Forwarding(PF)/\n                        Network_Enumeration(NE), Default SP\n                        \n    -L, --local-forward\n    \n                        Use Local Port Forwarding\n                        \n    -R, --remote-forward\n    \n                        Use Remote Port Forwarding\n                        \n    -P T/U, --protocol=T/U\n    \n                        Select Protocol For Port Forwarding TCP(T)/ UDP(U),\n                        Default T\n                        \n    --local-ip=LOCAL_IP\n    \n                        Local IP For Port Forwarding\n                        \n    --local-port=LOCAL_PORT\n    \n                        Local Port For Port Forwarding\n                        \n    --remote-ip=REMOTE_IP\n    \n                        Remote IP For Port Forwarding\n                        \n    --remote-port=REMOTE_PORT\n    \n                        Remote Port For Port Forwarding\n                        \n\n  NTLM Proxy Authentication Options:\n  \n    --ntlm-proxy-ip=NTLM_PROXY_IP\n    \n                        IP address of NTLM proxy\n                        \n    --ntlm-proxy-port=NTLM_PROXY_PORT\n    \n                        Port of NTLM proxy\n                        \n    --username=USERNAME\n    \n                        Username to authenticate with NTLM proxy\n                        \n    --domain=DOMAIN     Domain to authenticate with NTLM proxy\n    \n    --password=PASSWORD\n    \n                        Password to authenticate with NTLM proxy\n                        \n    --hashes=HASHES     Hashes to authenticate with instead of password.\n                        Format - LMHASH:NTHASH\n  \n  \n  #### Documentation \n  \n##### Case 1 : (Forward TCP Tunneling)\n\nIF the Compromised host is directly accessible from our pentest machine.\n\n\n    Then run PivotSuite as a server on the compromised machine as per our requirements:\n\n        a. Dynamic Port Forwarding (Socks5 Proxy Server) On Compromised machine:\n\n             $  python pivotsuite.py -S -F --server-option SP --server-ip IP --server-port PORT\n\n\n        b. Single Port Forwarding (TCP/UDP Relay) On Compromised machine :\n\n            $ python pivotsuite.py -S -F --server-option PF --network-protocol T/U --remote-ip IP --remote-port PORT \n              --server-ip IP (local-ip) --server-port PORT (local-port)\n\n\n##### Case 2 : (Reverse TCP Tunneling)\n\nIF the Compromised host is behind a Firewall / NAT and directly not accessible from our pentest machine.\n\n\n    Then run PivotSuite as a Server on pentest machine and PivotSuite as a Client on compromised machine.\n\n\n      i. Run PivotSuite as a Sever On Pentest Machine :\n\n          $ python pivotsute.py -S -W \n\n\n      ii. Run PivotSuite as a Client on Compromise Machine as per our requirements:\n\n          a. Dynamic Port Forwarding (Socks5 Proxy Server) On Pentest Machine:\n\n              $ python pivotsuite.py -C -O SP --server-ip IP --server-port PORT\n\n          b. Local / Remote Port Forwarding On Pentest Machine:\n\n               $ python pivotsuite.py -C -O PF  - L / -R (local or remote port forwarding) -P T/U  --local-ip IP \n                  --local-port PORT --remote-ip IP --remote-port PORT  --server-ip IP --server-port PORT\n\n          c. Network Enumeration of Compromised Machine:\n\n                $ python pivotsuite.py -C -O NE --server-ip IP --server-port PORT\n\n\nIF Corportate Proxy Authentication (NTLM) required for reverse connection on Compromised Host :\n\n      $ python pivotsuite.py -C -O SP --ntlm-proxy-ip IP --ntlm-proxy-port PORT --username USERNAME --password PASSWORD \n        --server-ip IP --server-port PORT\n        \n#### Contact Information :\n \nI would greatly appreciate it if you kindly give me some feedback or suggestion on PivotSuite Toolkit. \n\nEmail:    manish.gupta@cyberwarfare.live \n\nLinkedIn: https://www.linkedin.com/in/0hack/ \n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredteamoperations%2Fpivotsuite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredteamoperations%2Fpivotsuite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredteamoperations%2Fpivotsuite/lists"}