Skip to content

ShortlinkerMinimalist URL Shortening Service

Supports HTTP 307 redirects, built with Rust, easy deployment and fast response

Shortlinker

Design Philosophy ​

Minimalism ​

Focus on the core functionality of short link redirection with simple configuration and fast deployment

High Performance ​

Native Rust performance guarantee, SQLite provides production-grade database performance, asynchronous concurrent processing

Easy to Use ​

Command line tool management, TOML startup config + DB runtime config, one-click Docker deployment

Core Features ​

  • Multiple Storage Backends: SQLite database (default), PostgreSQL, MySQL, MariaDB for production-grade performance
  • Admin API: HTTP API management interface with authentication and custom route prefix support
  • Health Monitoring: Complete health check API with storage status and runtime monitoring
  • Smart Expiration: Supports flexible time format settings, automatic expiration and cleanup
  • Cross-platform Support: Windows, Linux, macOS, smart process locking to prevent duplicate startup
  • Container Optimization: Docker image deployment with container restart detection support
  • TOML Configuration: Startup config (server/database/cache/logging/analytics/ipc) + DB runtime config (auth/routes/features, etc.)

Quick Experience ​

bash
# Docker quick startup (mount config.toml; ensure container-side server.host=0.0.0.0)
docker run -d \
  -p 8080:8080 \
  -v $(pwd)/config.toml:/config.toml:ro \
  -v $(pwd)/data:/data \
  e1saps/shortlinker

# Add short link
./shortlinker add github https://github.com

# Access short link
curl -L http://localhost:8080/github

Use Cases ​

  • Marketing Promotion: Event links, social media sharing
  • Internal Tools: Document redirection, system integration
  • Temporary Links: Time-limited sharing, test environment
  • API Services: Link management between microservices

Get Started ​

Ready to go? Check out the Quick Start Guide to begin with Shortlinker More modules: Web Admin Panel.

Released under the MIT License