{"id":4206,"date":"2023-05-16T14:55:02","date_gmt":"2023-05-16T12:55:02","guid":{"rendered":"https:\/\/tech.lobobrothers.com\/shortlinks-why-shlink\/"},"modified":"2025-02-06T13:19:29","modified_gmt":"2025-02-06T12:19:29","slug":"shortlinks-why-shlink","status":"publish","type":"post","link":"https:\/\/tech.lobobrothers.com\/en\/shortlinks-why-shlink\/","title":{"rendered":"Shortlinks With Shlink"},"content":{"rendered":"\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

YOUR SHORTLINKS SERVER<\/strong><\/h2>\n

Let’s see how to set up your own shortlink server on Debian 11 using shlink<\/a> , which has many features, multi domain, QR codes, emojis, REST API, Bot detection,….<\/p>\n

The first thing is to install php 8.1 or 8.2 with the necessary modules, as indicated in the official documentation<\/a>.<\/p>\n

INSTALLING PHP 8.1 ON DEBIAN 11<\/strong><\/h2>\n

We execute:<\/p>\n

apt install -y lsb-release ca-certificates apt-transport-https software-properties-common gnupg2<\/p>\n

echo “deb https:\/\/packages.sury.org\/php\/ $(lsb_release -sc) main” | tee \/etc\/apt\/sources.list.d\/sury-php.list<\/p>\n

curl -fsSL https:\/\/packages.sury.org\/php\/apt.gpg| gpg –dearmor -o \/etc\/apt\/trusted.gpg.d\/sury-keyring.gpg<\/p>\n

apt-get update<\/p>\n

We have added the repositories and then installed the necessary modules.<\/p>\n

apt-get install php-apcu php8.1 php8.1-fpm php8.1-mysql php8.1-gd php8.1-common php8.1-curl php8.1-intl php8.1-gmp php8.1-xml php-dev php-pear<\/p>\n

We can check with:<\/p>\n

php –modules<\/p>\n

That they are loaded correctly.<\/p>\n

SHLINK INSTALLATION AND CONFIGURATION<\/strong><\/h2>\n

We start by installing the necessary packages.<\/p>\n

apt-get install nginx mariadb-server unzip sudo<\/p>\n

We created the database.<\/p>\n

mysql<\/p>\n

Once inside we write.<\/p>\n

CREATE DATABASE shlink;
\nGRANT ALL ON shlink.* TO ‘shlink’@’localhost’ IDENTIFIED BY ‘password’;
\nFLUSH PRIVILEGES;
\nEXIT;<\/p>\n

You can call the database whatever you like, just like the user.<\/p>\n

Once we have the database, we proceed with the download and installation of the latest shlink version.<\/p>\n

wget https:\/\/github.com\/shlinkio\/shlink\/releases\/download\/v3.5.4\/shlink3.5.4_php8.1_dist.zip<\/p>\n

unzip shlink3.5.4_php8.1_dist.zip<\/p>\n

mv shlink3.5.4_php8.1_dist \/var\/www\/html\/shlink<\/p>\n

chown -R www-data:www-data \/var\/www\/html\/shlink\/<\/p>\n

chmod -R 755 \/var\/www\/html\/shlink\/<\/p>\n

cd \/var\/www\/html\/shlink<\/p>\n

(If you do not go to this directory, the following command will not be able to write the configuration file if we execute it with the full path \/var\/www\/htmtl…., since the path in the script is config\/params to save the configuration file)<\/p>\n

sudo -u www-data php8.1 vendor\/bin\/shlink-installer install<\/p>\n

And we will get an interactive menu<\/p>\n

DATABASE <\/strong>(the data of the connection to our database)<\/p>\n

\"shlink<\/p>\n

We choose 1 in our case and it will ask us for the following data<\/p>\n

\"shlink<\/p>\n

URL SHORTENER<\/strong><\/p>\n

\"shlink<\/p>\n

1. The default domain to generate the short URLs<\/p>\n

2. With or without SSL<\/p>\n

3. How many characters<\/p>\n

4. If you want it to resolve based on the long URL<\/p>\n

5. If you want it to resolve the URL as soon as possible and add the rest of the long URL<\/p>\n

6. If you want it to support multilevel<\/p>\n

7. If you want it to consider the same URL with or without a trailing slash<\/p>\n

8. How you want them to match<\/p>\n

9. GeoLite2 License.<\/p>\n

Here we stop a bit to explain. Shlink uses GeoLite2 to geolocate the visits, if it is not entered it simply will not geolocate them. Obtaining this license is free, you just have to:<\/p>\n

Create an account in MAXMIND https:\/\/www.maxmind.com\/en\/geolite2\/signup<\/p>\n

And then generate the key<\/p>\n

\"maxmind<\/p>\n

After that, it asks us what type of redirection we want, choose the best one for your case.<\/p>\n

And how long we want them to be cached in seconds, by default 30<\/p>\n

TRACKING<\/strong><\/p>\n

To keep the post short, I’ll simply answer the questions about what you want to track and if you want to exclude something like an IP range, a browser, etc.<\/p>\n

\"shlink<\/p>\n

REDIRECTS<\/strong><\/p>\n

Where you want to redirect according to what they ask you, it has to be in http:\/\/ or https:\/\/ format<\/p>\n

\"shlink<\/p>\n

QR CODES<\/strong><\/p>\n

How do you want the QR codes to be?<\/p>\n

\"shlink<\/p>\n

APPLICATION<\/strong><\/p>\n

There is no mystery, except perhaps the first one which means if that link will be indefinite or you can say 1, then it will be deleted after the first opening.<\/p>\n

\"shlink<\/p>\n

INTEGRATIONS<\/strong><\/p>\n

Since we are not setting up a cluster we will say no.<\/p>\n

\"shlink<\/p>\n

Once completed we will find our configuration file in \/var\/www\/html\/shlink\/config\/params with the name generated_config.php, which we can modify if we change our mind about the options selected during the installation.<\/p>\n

WE CONTINUE WITH NGINX<\/strong><\/p>\n

We deleted the default site<\/p>\n

rm \/etc\/nginx\/sites-enabled\/default<\/p>\n

And now we create our site<\/p>\n

nano \/etc\/nginx\/sites-available\/tudominio.conf<\/p>\n

Adding the following<\/p>\n

server {
\nlisten 80;
\nlisten [::]:80;
\nserver_name tudominio.com;<\/p>\n

root \/var\/www\/html\/shlink\/public;
\nerror_log \/var\/log\/nginx\/shlink.error;
\naccess_log \/var\/log\/nginx\/shlink.access;<\/p>\n

index index.php index.html index.htm index.nginx-debian.html;<\/p>\n

location \/ {
\n# try to serve file directly, fallback to app.php
\ntry_files $uri \/index.php$is_args$args;
\n}<\/p>\n

# redirect some entire folders
\nrewrite ^\/(vendor|translations|build)\/.* \/index.php break;<\/p>\n

location ~ \\.php$ {
\nfastcgi_split_path_info ^(.+\\.php)(\/.+)$;
\nfastcgi_pass unix:\/var\/run\/php\/php8.1-fpm.sock;
\nfastcgi_index index.php;
\nfastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
\ninclude fastcgi_params;
\n}<\/p>\n

}<\/p>\n

We create the symbolic link to activate it<\/p>\n

ln -s \/etc\/nginx\/sites-available\/tudominio.conf \/etc\/nginx\/sites-enabled\/<\/p>\n

We check that there are no errors in the configuration<\/p>\n

nginx -t<\/p>\n

And we recharge it<\/p>\n

systemctl reload nginx<\/p>\n

Now we will enable SSL since in our config we have said SSL<\/p>\n

apt-get install certbot python3-certbot-nginx<\/p>\n

certbot –nginx –agree-tos –redirect –hsts –staple-ocsp –email tumail@example.com -d tudominio.com<\/p>\n

Once all this is done, we only need to generate our API key<\/p>\n

sudo -u www-data php8.1 \/var\/www\/html\/shlink\/bin\/cli api-key:generate<\/p>\n

And we go to https:\/\/app.shlink.io\/ to add our server if we want the graphical interface<\/p>\n

\"shlink<\/p>\n

\"shlink<\/p>\n

Or from the server itself using<\/p>\n

sudo -u www-data php8.1 \/var\/www\/html\/shlink\/bin\/cli short-url:create<\/p>\n

NOTE!!! Always provide the https:\/\/<\/p>\n

\"shlink<\/p>\n

We can see the options with:<\/p>\n

sudo -u www-data php8.1 \/var\/www\/html\/shlink\/bin\/cli<\/p>\n

\"shlink<\/p>\n

You can find the API documentation at https:\/\/shlink.io\/documentation\/api-docs\/<\/p>\n

And finally, to get the QR code, you just have to add \/qr-code to the short URL.<\/p>\n

TL.<\/p>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

FAQS<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/path><\/svg><\/span>\n\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tWhat is Shlink and what are its main features?<\/a>\n\t\t\t\t\t<\/div>\n\n\t\t\t\t\t

Shlink is an open source application that allows you to create your own URL shortening service. Its features include:<\/p>\n