{"id":41034630,"url":"https://github.com/mlesniak/port-scanner","last_synced_at":"2026-01-22T10:31:15.309Z","repository":{"id":57503204,"uuid":"122576942","full_name":"mlesniak/port-scanner","owner":"mlesniak","description":"Port scanner in Go","archived":false,"fork":false,"pushed_at":"2018-02-27T16:20:12.000Z","size":657,"stargazers_count":33,"open_issues_count":0,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-06-20T12:42:18.136Z","etag":null,"topics":["go","golang","port-scanner","tools","unix-command"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mlesniak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-23T05:21:45.000Z","updated_at":"2024-06-20T12:42:18.136Z","dependencies_parsed_at":"2022-08-31T08:01:49.995Z","dependency_job_id":null,"html_url":"https://github.com/mlesniak/port-scanner","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mlesniak/port-scanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlesniak%2Fport-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlesniak%2Fport-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlesniak%2Fport-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlesniak%2Fport-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlesniak","download_url":"https://codeload.github.com/mlesniak/port-scanner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlesniak%2Fport-scanner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28661874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","port-scanner","tools","unix-command"],"created_at":"2026-01-22T10:31:15.094Z","updated_at":"2026-01-22T10:31:15.301Z","avatar_url":"https://github.com/mlesniak.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/mlesniak/port-scanner.svg?branch=master)](https://travis-ci.org/mlesniak/port-scanner)\n[![Code of Conduct](https://img.shields.io/badge/%E2%9D%A4-code%20of%20conduct-orange.svg?style=flat)](CODE_OF_CONDUCT.md)\n\n# Overview\n\nImplementation of a simple port scanner in Go, mirroring the output of nmap.\n\n## Example\n\n    \u003e port-scanner -hostname mlesniak.com -parallel 20 -port 75-85 -timeout 1\n    PORT      STATUS  SERVICE\n    75/tcp    closed  \n    76/tcp    closed  deos\n    77/tcp    closed  \n    78/tcp    closed  vettcp\n    79/tcp    closed  finger\n    80/tcp    open    www-http\n    81/tcp    closed  \n    82/tcp    closed  xfer\n    83/tcp    closed  mit-ml-dev\n    84/tcp    closed  ctf\n    85/tcp    closed  mit-ml-dev\n\n## Help\n\nA list of available command line options can be obtained by executing\n\n    \u003e port-scanner -help\n    A simple port scanner in go.\n    -hostname string\n            hostname of the target system\n    -parallel int\n            Maximum number of parallel connections (default 1)\n    -port string\n            a single port (80) or a single range (80-1024)\n    -timeout float\n            Timeout in seconds. Fractional values, e.g. 0.5 are allowed (default 1)\n\n## Building\n\nTo build and install port-scanner under `$GOPATH` you have to\n\n    git clone git@github.com:mlesniak/port-scanner.git\n    go install\n\nWe use [go-bindata](https://github.com/a-urth/go-bindata) to embed files in `data/`, hence to build \n`bindata.go`, you have to\n\n    go-bindata data/\n\nIf you have not installed `go-bindata`, use\n\n    go get -u github.com/a-urth/go-bindata/...\n\nbeforehand.\n\nTo reduce the file size, use [upx](https://upx.github.io/) and\n\n    go build \u0026\u0026 strip port-scanner \u0026\u0026 upx -9 port-scanner\n\nto create a 1MB single static file, e.g. for using it in docker containers.\n\n### Build with Docker\n\nBuilding port-scanner with Docker is simple\n\n    git clone git@github.com:mlesniak/port-scanner.git\n    cd port-scanner\n    docker build -t port-scanner .\n    docker run --rm port-scanner -hostname mlesniak.com -parallel 20 -port 75-85 -timeout 1\n\nTo export the static binary simply run\n\n    docker run --rm --entrypoint=\"\" port-scanner cat /usr/local/bin/port-scanner \u003e port-scanner\n\n## Limitations\n\nWhile this application is feature complete for my usages, the following limitations apply:\n\n- Scanning of TCP ports only.\n- Service list maps only single range ports, i.e. xwindow's definition from 6000-6003 is currently not correctly mapped\n\nIf these limitations annoy you, either fix this yourself and write a pull request :-) or open an issue.\n\n## Organization\n\nA Trello Board can be found [here](https://trello.com/b/opzPa3fd/port-scanner).\n\n## License\n\nThe source code is licensed under the [Apache license](https://raw.githubusercontent.com/mlesniak/port-scanner/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlesniak%2Fport-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlesniak%2Fport-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlesniak%2Fport-scanner/lists"}