{"id":20486209,"url":"https://github.com/ivopetiz/network-scanner","last_synced_at":"2025-04-13T15:20:49.103Z","repository":{"id":144314025,"uuid":"107899203","full_name":"ivopetiz/network-scanner","owner":"ivopetiz","description":"TCP Network Port Scanner written in Go, nmap style. ","archived":false,"fork":false,"pushed_at":"2020-03-07T09:24:56.000Z","size":1107,"stargazers_count":16,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2023-03-21T20:46:50.037Z","etag":null,"topics":["go","golang","ip-scanner","network","network-analysis","network-machine","network-monitoring","network-security","network-visualization","nmap","nmap-style","port-scanner","portscanner","tcp-port","tcp-ports"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivopetiz.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-22T20:13:23.000Z","updated_at":"2024-06-19T10:24:41.371Z","dependencies_parsed_at":null,"dependency_job_id":"d3686559-3494-4f7b-885d-b8b07d068dd4","html_url":"https://github.com/ivopetiz/network-scanner","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivopetiz%2Fnetwork-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivopetiz%2Fnetwork-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivopetiz%2Fnetwork-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivopetiz%2Fnetwork-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivopetiz","download_url":"https://codeload.github.com/ivopetiz/network-scanner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248733082,"owners_count":21152954,"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":["go","golang","ip-scanner","network","network-analysis","network-machine","network-monitoring","network-security","network-visualization","nmap","nmap-style","port-scanner","portscanner","tcp-port","tcp-ports"],"created_at":"2024-11-15T16:35:44.961Z","updated_at":"2025-04-13T15:20:49.081Z","avatar_url":"https://github.com/ivopetiz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Codacy Badge](https://api.codacy.com/project/badge/Grade/5cc2fb7bdfb240eabe772b8bcbcbc461)](https://app.codacy.com/app/ivopetiz/portscanner?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=ivopetiz/portscanner\u0026utm_campaign=Badge_Grade_Dashboard)\n[![Build Status](https://travis-ci.com/ivopetiz/portscanner.svg?branch=master)](https://travis-ci.com/ivopetiz/network-scanner)\n[![Coverage Status](https://coveralls.io/repos/github/ivopetiz/portscanner/badge.svg?branch=master)](https://coveralls.io/github/ivopetiz/portscanner?branch=master)\n# Go-Portscanner\n\nTCP Network Port Scanner written in Go, nmap style.\n\n## Lib\n\n### Usage examples\n\n#### Scan specific ports from an IP address\n\n```go\npackage main\n\n// imports fmt lib and portscanner lib.\nimport \"fmt\"\nimport \"github.com/ivopetiz/portscanner\"\n\n// Main function.\nfunc main() {\n\n\t// ports is an slice of strings corresponding to ports we want\n\t// to scan.\n\tports := []string{\"21\", \"22\", \"80\"}\n\n\t// ip_t is a slice of strings containing an IP address.\n\tip_t := []string{\"192.168.1.100\"}\n\n\t// open_ports has the results from PortScanner.\n\topen_ports := portscanner.PortScanner(ip, ports)\n\n\tfmt.Println(open_ports)\n}\n```\n\n#### Scan port 80 in a range of IP addresses\n\n```go\npackage main\n\n// imports fmt lib and portscanner lib.\nimport \"github.com/ivopetiz/portscanner\"\n\n// Main function.\nfunc main() {\n\t\n\t// ports is a slice of ports to test.\n\tports := []string{\"80\"}\n\n\t// IP sequence is defined by a '-' between first and last IP address .\n\tips_sequence := []string{\"192.168.1.1-254\"}\n\n\t// results returns a map with open ports for each IP address.\n\tresults := portscanner.IPScanner(ips_list, ports, true)\n\t// Once IPScanner has true for print_results, lib will present\n\t// results in CL with a nice presentation.\n}\n```\n\n## App\n\n### Installation\n\n```sh\n go install https://github.com/ivopetiz/portscanner\n git clone https://github.com/ivopetiz/portscanner.git portscanner\n cd portscanner\n go build cmd/portscanner/portscanner.go\n```\n\n## Usage examples\n\nDifferent ways to use Go-Portscanner.\n\n### Get help\n\n```sh\n portscanner -h\n Usage of portscanner:\n   -A   Scans all ports from port 1 to 1024\n   -p   Port or ports to scan (default \"80\")\n```\n\nShows the output above, presenting the available options.\n\n### Localhost Portscanner\n\n```sh\n$ portscanner\n```\n\nScans all local machine ports, from 1 to 1024.\n\n### Network Machine Full Port Scan\n\n```sh\n$ portscanner -p 1-65535 210.67.210.76\n```\n\nScan all TCP ports from a network machine.\n\n### Network Discovery\n\n```sh\n$ portscanner -p 21,80 192.168.0.1-192.168.0.254\n```\n\nLooks for HTTP and FTP servers on 192.168.0.0/24.\n\n### Ping Servers\n\n```sh\n$ portscanner -p 22 113.213.200.101 4.0.75.4 84.188.238.94 11.2.224.214 153.194.246.247\n```\n\nChecks if SSH servers are up.\n\n## TODO\n\n-   [ ] Improve performance.\n-   [ ] Improve presentation.\n-   [ ] Read IP:Port pair from file.\n-   [x] Tests\n-   [ ] Docker \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivopetiz%2Fnetwork-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivopetiz%2Fnetwork-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivopetiz%2Fnetwork-scanner/lists"}