A dynamic web terminal service built with Babashka that provides on-demand terminal sessions through a web interface. This service integrates ttyd (web-based terminal) with Traefik for dynamic routing and automatic session management.
- Dynamic Session Management: Creates isolated terminal sessions with unique URLs
- Traefik Integration: Automatic reverse proxy configuration for each session
- Auto-cleanup: Sessions automatically terminate after specified timeout
- RESTful API: Simple HTTP API for session management
- Process Isolation: Each session runs in its own process with configurable timeouts
Start a new terminal session with a specified command.
Request Body:
{ "command": "htop", "timeout": 300 }Response:
{ "url": "/session/550e8400-e29b-41d4-a716-446655440000", "session-id": "550e8400-e29b-41d4-a716-446655440000", "timeout": 300, "expires-at": 1691234567890 }List all active sessions and their status.
Response:
{ "active-sessions": 2, "sessions": [ { "session-id": "550e8400-e29b-41d4-a716-446655440000", "command": "htop", "port": 9123, "uptime": 45000 } ] }Manually cleanup a specific session.
Response:
{ "message": "Session cleaned up" }- Start a new session:
curl -X POST http://localhost/api/execute \ -H "Content-Type: application/json" \ -d '{"command": "htop", "timeout": 300}'
- Access the terminal: Open the returned URL in your browser to access the web-based terminal.
- Check active sessions:
curl http://localhost/api/status
- Session Creation: When a new session is requested, the service:
- Generates a unique session ID and port
- Starts a ttyd process with the specified command
- Creates a Traefik configuration file for routing
- Sets up automatic cleanup after timeout
- Routing: Traefik dynamically routes requests to
/session/{session-id}to the appropriate ttyd instance - Cleanup: Sessions are automatically cleaned up after the specified timeout plus a 10-second buffer, removing:
- The running process
- Traefik configuration file
- Session from active sessions registry