{"id":20230410,"url":"https://github.com/amir-shiati/portscanner","last_synced_at":"2025-04-10T18:05:15.116Z","repository":{"id":47583954,"uuid":"250545864","full_name":"amir-shiati/portscanner","owner":"amir-shiati","description":"A fast port scanner made using golang.","archived":false,"fork":false,"pushed_at":"2021-08-23T09:28:10.000Z","size":4696,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T15:47:27.015Z","etag":null,"topics":["cli","go","golang","portscan","portscanner"],"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/amir-shiati.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":"2020-03-27T13:46:58.000Z","updated_at":"2023-08-19T06:49:36.000Z","dependencies_parsed_at":"2022-09-22T21:40:46.865Z","dependency_job_id":null,"html_url":"https://github.com/amir-shiati/portscanner","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/amir-shiati%2Fportscanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir-shiati%2Fportscanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir-shiati%2Fportscanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir-shiati%2Fportscanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amir-shiati","download_url":"https://codeload.github.com/amir-shiati/portscanner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248265785,"owners_count":21075040,"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":["cli","go","golang","portscan","portscanner"],"created_at":"2024-11-14T07:42:26.330Z","updated_at":"2025-04-10T18:05:15.092Z","avatar_url":"https://github.com/amir-shiati.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Portscanner\nA fast and simple port scanner created in golang. for times when you are not able to use nmap!\n\n# Usage\n` Port scanner [-h|--help] -i|--ip \"\u003cvalue\u003e\" [-p|--port \"\u003cvalue\u003e\"]\n                    [-l|--protocol \"\u003cvalue\u003e\"] [-c|--common \"\u003cvalue\u003e\"]\n                    [-r|--range \"\u003cvalue\u003e\"] [-d|--duration \"\u003cvalue\u003e\"]\n`\n### clone the repo.\n`$ git clone https://github.com/amir-shiati/portscanner.git`\n### Change directory.\n`$ cd portscanner/`\n### Give the binary file permission to execute ***if needed***.\n`$ chmod -R 775 ./port_scanner`\n### Simply run the binary file\n`$ ./port_scanner -i 127.0.0.1 -p 80`\n#### \tOputput\n```bash\nScanning port...\nResults:\nPort:80   State:Open   Protocol:tcp\n\n```\n\n# Arguments\n##### You can do much more here is a list of arguments that you can use:\n| Short form of argument (-)  | Long form of argument (- -)   |  Description|\n| ------------ | ------------ | ------------ |\n| i   |  ip |***Required*** specifies an ip that you like to scan. must be a valid ip\n| p  | port  | specifies a port that you like to scan. must be a number between '0' and '65535'\n| l  | protocol  |specifies the protocol. must be either 'tcp' or 'udp'  ***default value is 'tcp'***\n| c  | common  | if 'true' scans common ports: '0' to '1024'  ***default value is 'false'***\n| r  | range  | if 'true' asks for ranges ***default value is 'false'***\n| d  | duration  | duration of connection. must be a value between '7' and '300'  ***default value is '10' ***\n\n# Examples\n#### Command\n`$ ./port_scanner -i 127.0.0.1 -c true`\n#### Output\n```bash\nScanning ports...\nPort:80   State:Open   Protocol:tcp\nPort:443   State:Open   Protocol:tcp\nPort:444   State:Open   Protocol:tcp\nPort:631   State:Open   Protocol:tcp\nPort:902   State:Open   Protocol:tcp\n\n```\n#### Command\n`$ ./port_scanner -i 127.0.0.1 -r true`\n#### Output\n```bash\nEnter the firts port number: 0\nEnter the seconde port number: 1024\nScanning ports...\nPort:80   State:Open   Protocol:tcp\nPort:443   State:Open   Protocol:tcp\nPort:444   State:Open   Protocol:tcp\nPort:631   State:Open   Protocol:tcp\nPort:902   State:Open   Protocol:tcp\n\n```\n#### Command\n`$ ./port_scanner -i 127.0.0.1 -c true -d 15 -l udp\n`\n##### runs the first example with a 15 seconde connection duration and using udp protocol.\n\n### Notice\n##### I'm fairly new to the golang world so the code is probably not so well written or efficient!!!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famir-shiati%2Fportscanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famir-shiati%2Fportscanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famir-shiati%2Fportscanner/lists"}