Flink - A Simple and Easy-to-Use Open Source URL Shortener

a year ago

Flink is an open-source URL shortener service developed with ASP.NET. Its most significant feature is zero configuration, making it ready to use out-of-the-box. It can not only shorten long URLs but also generate QR codes, and even supports Open Telemetry monitoring metrics.

In simple terms, you give it a very long URL, and it returns a short, concise link.

https://appstore.lazycat.cloud/#/shop/detail/wcloud.gblw.app.flink

Quick Start Guide

After installing the application, open it and it's ready to use.

image.png

I input a relatively long address: https://manateelazycat.github.io/2025/07/03/work-with-designer/

Click 'Generate', and get a short link and QR code: https://flink.lanmao168.heiyu.space/mdeZ. Visiting this address directly will redirect you to Wang Zong's blog.

image.png

image.png

You might be curious, just like I was, about how it works.

Actually, a URL shortener service is like a super-smart "note-passing" system:

Step 1: Create the "Address Book"

When you input the long URL https://manateelazycat.github.io/2025/07/03/work-with-designer/, Flink records a piece of information in its "address book":

Code: mdeZ
Real Address: https://manateelazycat.github.io/2025/07/03/work-with-designer/

This mdeZ is a randomly generated "code", much like giving someone a nickname.

Step 2: Store it in the "Little Notebook"

Flink stores this mapping relationship in a database (like an electronic little notebook):

Short CodeOriginal URLCreation TimeVisit Count
mdeZhttps://manateelazycat.github.io/2025/07/03/work-with-designer/2025-07-170

Step 3: The Redirection Magic

What happens when you visit https://flink.lanmao168.heiyu.space/mdeZ?

  1. Browser: I want to visit /mdeZ
  2. Flink Server: Request received, let me check what mdeZ corresponds to...
  3. Database Query: Found it! mdeZ = https://manateelazycat.github.io/2025/07/03/work-with-designer/
  4. Server Reply: Browser buddy, don't stay here, please redirect to https://manateelazycat.github.io/2025/07/03/work-with-designer/!
  5. Browser: OK, redirecting immediately!

The Secret of HTTP Redirection

The key here is HTTP 302 Redirect. When you visit the short link:

  1. The browser sends a request to https://flink.lanmao168.heiyu.space/mdeZ
  2. The server returns a special response telling the browser: "This page isn't here, please go to this new address"
  3. Upon receiving this instruction, the browser automatically jumps to the new address

It's like asking for directions, and a passerby says: "The place you're looking for isn't here, it's over there," and you automatically walk to the correct location.

Why Use Codes Like mdeZ?

You might wonder why it's mdeZ and not something else? How is this code generated?

  1. Base62 Encoding: Typically uses the 62 characters a-z, A-Z, 0-9
  2. Uniqueness: Each long URL gets a unique short code
  3. Randomness: It looks random but is actually generated by an algorithm

A URL shortener is essentially a "transfer station". It doesn't store the webpage content, it just remembers "who corresponds to whom," and then tells the browser where to find the real content when needed.

It's like a super-memorably efficient operator: you say you want "mdeZ," and it immediately knows which phone number to connect you to!

Summary

Flink is a pretty good open-source URL shortener solution, especially suitable for:

  • Individuals and teams wanting to self-host a URL shortener service
  • Scenarios with data privacy requirements
  • Projects needing customized features

While its features might not be as extensive as commercial services, it wins by being open-source, free, and having good code quality.

If you happen to need a URL shortener, why not give this project a try.

Author
天天