URShort

A blazingly fast and amazingly simple URL shortener designed for self-hosters.

Support regular vanity URI mappings as well as (Perl style) regex based mapping!

It uses environmental variables to configure all matches and loads them into an in-memory model for near instant access! Designed for hosting with containers and for individual use.

Build

Use the standard Rust tools. There is also a Dev Container if you would prefer to run it that way.

```bash cargo build

Also recommended for linting suggestions

cargo clippy

And for consistent formatting

cargo fmt ```

For creating the Docker container. Use the included Dockerfile and this:

bash docker build -t urshort:latest .

Installation

It is recommended to use Docker to use URShort:

bash docker pull mirdaki/urshort

If you have prefer, you can also install it via cargo:

bash cargo install urshort

Or download directly from the releases.

Configuration

As all configuration is stored in environmental variables, it is recommenced to store them in an .env file for ease of tracking and updating. For example:

```.env URSHORTSTANDARDURItest=https://example.com/ URSHORTSTANDARDURItest2=https://example.com/2

URSHORTPATTERNREGEX0='^i(?P\d+)$' URSHORTPATTERNURI0='https://example.com/$index' URSHORTPATTERNREGEX1='^(\d+)$' URSHORTPATTERNURI1='https://example.com/$1' ```

Standard Mapping

A standard vanity mapping would do something like: hello -> example.com/hello

Using this config: - Path: hello - Redirect: https://example.com/hello

This is stored in a single environmental variable:

```bash

<> is used to indicate the values to be changes

URSHORTSTANDARDURI_=

Actual example

URSHORTSTANDARDURI_test=https://example.com/ ```

Standard mappings will override any regex mapping.

Regex Mapping

A single regex pattern mapping could do something like: i1 -> example.com/1 i42 -> example.com/42 i9001 -> example.com/9001 ...

Using this config: - Regex pattern: '^i(?P<index>\d+)$' - Pattern redirect 'https://example.com/$index'

This is stored in two single environmental variables. The first contains ```bash

<> is used to indicate the values to be changes

The first environmental variable determines the place in which the pattern is evaluated and the regex for that pattern

URSHORTPATTERNREGEX_=''

The second environmental variable must match the place of the first and contains the pattern redirect

URSHORTPATTERNURI_=''

Actual example

URSHORTPATTERNREGEX0='^i(?P\d+)$' URSHORTPATTERNURI0='https://example.com/$index' ```

Be sure to quote the values. Be careful with the order you have the mappings.

Port

You can specify a port the service will use. If not give, the default of 54027 will be used.

This is useful when running the service directly. If you use Docker, it is recommended to use the built in port mapping features instead of this.

Example environmental variable: URSHORT_PORT=7777

Usage

Please use a web server, such as Nginx or Traefik in front of URShort.

Docker compose is the recommended way to run URShort. An example file is here. Load that file with your .env file and run:

bash docker-compose up

You can also use the Docker run command directly:

bash docker run -d \ --name=urshort \ -p 54027:54027 \ -e URSHORT_STANDARD_URI_test=https://example.com/ \ -e URSHORT_PATTERN_REGEX_0='^i(?P<index>\d+)$' \ -e URSHORT_PATTERN_URI_0='https://example.com/$index' \ --restart unless-stopped \ mirdaki/urshort:latest

Or if you have the bare executable, run urshort at the location of you .env file (or after your configuration is loaded directly into the environment).

Built With

Thank you to all the projects that helped make this possible!

• Rust for being an awesome language to build with
• Axum for doing the whole URL redirect thing

Contributing

Please read CONTRIBUTING.md for how to contribute to the project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.