TailPass

Tailpass is a Tailscale powered TCP port forwarding tool that bridges your VLANs, containers, and hosts simply and securely. You can easily connect web servers, SSH sessions, databases, or any TCP service across your network without worrying about complex configurations. Add your local and remote services, start the tunnel, and your traffic flows seamlessly through Tailscale. Tailpass gives you a lightweight dashboard, an efficient backend, and the freedom to access your services from anywhere.

TailPass consists of:

• Backend (Go) – Handles API requests and port forwarding
• Frontend (Vue.js) – Web interface for configuration and monitoring
• PostgreSQL Database – Stores tunnel and service data

All components are containerized and managed with Docker Compose.

TailPass allows you to forward TCP ports from your local machine, container, or VLAN network through your Tailscale interface — enabling secure remote access to any TCP service such as web servers, SSH, or databases.

You can bind the service to any local IP address, including:

• 127.0.0.1 → to expose only on localhost
• 100.x.x.x (Tailscale IP) → to expose over your Tailscale network
• 0.0.0.0 → to listen on all available interfaces

• GUI Improvements

  • Refine layout and responsiveness

• Health Checks

  • Implement port-based health monitoring for each service
  • Periodic background checks with automatic status updates

• Authentication

  • Add Login Page with JWT-based authentication
  • Secure routes for authenticated users only
  • Token refresh and logout feature

• Input Validation & Sanitization

  • Validate user inputs before database operations
  • Show clear error messages for invalid fields

• ORM Integration

  • Migrate raw SQL queries to ORM-based model handling
  • Simplify database migrations and schema updates
  • Improve maintainability and data consistency across services

• Container & Deployment Enhancements

  • Optimize Docker image size
  • Add health checks for backend and frontend containers
  • Support production-ready environment configurations

• Service Restart & Stop Controls
  Manage running services directly from the GUI (start, stop, restart).

• Container Health Metrics Dashboard
  Display container CPU, memory, and uptime statistics in real-time.

• Configurable Alerts
  Receive alerts via webhook when a service fails or becomes unreachable.