proverbes12x/open-finder-port repository overview

⁠⚡ Open Finder Port

⁠Overview

Open Finder Port is a self-hosted web service that helps you manage and monitor ports on your server. It provides a clean dark-themed interface to:

• List all ports currently in use on the server
• Check port availability in real time
• Suggest the next available port when a port is already taken
• Identify which service and PID is using a port

Built with Go for minimal resource usage and fast response times. No external dependencies - just a single binary.

⁠Features

• ✅ Real-time port scanning via ss
• ✅ Identifies process name and PID for each port
• ✅ Suggests next available port automatically
• ✅ REST API for programmatic access
• ✅ Multi-arch support (linux/amd64, linux/arm64)
• ✅ Tiny image size (~11 MB)

⁠Quick Start

docker run -d \
  --name open-finder-port \
  --network host \
  -p 56789:56789 \
  proverbes12x/open-finder-port:latest

Then open http://localhost:56789 in your browser.

⁠Docker Compose

services:
  open-finder-port:
    image: proverbes12x/open-finder-port:latest
    container_name: open-finder-port
    network_mode: host
    restart: unless-stopped

⁠API Reference

⁠List all ports in use

GET /api/ports

Response:

{
  "success": true,
  "data": [
    {
      "port": 80,
      "protocol": "TCP",
      "state": "LISTEN",
      "process": "caddy",
      "pid": "1234"
    }
  ]
}

⁠Check port availability

GET /api/check?port=9010

Response (available):

{
  "success": true,
  "data": {
    "port": 9010,
    "available": true,
    "status": "available"
  }
}

Response (in use):

{
  "success": true,
  "data": {
    "port": 9001,
    "available": false,
    "status": "in use",
    "used_by": "caddy",
    "pid": "1234",
    "next_available": 9010
  }
}

⁠Versioning

⁠Built With

• Go⁠ — Backend
• Alpine Linux⁠ — Base image
• iproute2⁠ — Port scanning via ss

⁠Part of Stackriv

Open Finder Port is part of the Stackriv homelab infrastructure suite — a collection of self-hosted tools for managing personal and professional servers.

Made with ❤️ by Stackriv⁠