Shlink؛ کوتاه‌کنندهٔ لینک با دامنهٔ خودتان

کارهایی که Shlink در عمل برایشان استفاده می‌شود:

Shlink در فهرست اپلیکیشن‌های سفارش سرور است و نصبش کاملاً خودکار انجام می‌شود. پس از بالا آمدن سرور، اسکریپت نصب بسته‌های docker.io و docker-compose-v2 را روی Ubuntu نصب می‌کند، پوشهٔ /opt/shlink را می‌سازد و یک رمز تصادفی ۲۴ کاراکتری برای دیتابیس تولید می‌کند که در فایلی با دسترسی فقط برای root ذخیره می‌شود. سرویس اول MariaDB 10.11 است که دیتابیس shlink و کاربری به همین نام دارد و داده‌اش را در پوشهٔ db-data نگه می‌دارد. اگر دریافت ایمیج‌ها یک بار با خطا روبه‌رو شود، اسکریپت چند بار دوباره تلاش می‌کند.

سرویس دوم ایمیج shlinkio/shlink شاخهٔ stable است که پورت ۸۰۸۰ را منتشر می‌کند. پنل IP واقعی سرور شما را به اسکریپت می‌دهد و DEFAULT_DOMAIN برابر همین IP و پورت ۸۰۸۰ تنظیم می‌شود، IS_HTTPS_ENABLED خاموش است و اتصال دیتابیس با درایور maria برقرار می‌شود. سرویس سوم shlink-web-client است که روی پورت ۸۸۸۸ رابط وب را ارائه می‌دهد و آدرس سرور Shlink را از پیش می‌شناسد.

در پایان، اسکریپت با دستور shlink api-key:generate یک کلید API می‌سازد. کلید، رمز دیتابیس، آدرس لینک‌ها و آدرس رابط وب در تب «اپلیکیشن» صفحهٔ سرور نمایش داده می‌شوند و قوانین فایروال پورت‌های ۸۰۸۰ و ۸۸۸۸ خودکار اعمال می‌شوند. رابط وب را باز کنید، سرور را با آدرس پورت ۸۰۸۰ و همین کلید اضافه کنید و اولین لینک را بسازید. اگر روزی خواستید دستی بررسی یا از نو نصب کنید، فایل docker-compose.yml در /opt/shlink همهٔ تنظیمات را دارد و با docker compose up -d دوباره بالا می‌آید.

Shlink سبک است و هر هدایت لینک فقط یک پرس‌وجوی کوچک دیتابیس و یک پاسخ کوتاه است. برای بیشتر کسب‌وکارها، پلن mini با یک گیگابایت حافظه هر سه سرویس را بدون مشکل اجرا می‌کند. هزینه ساعتی از کیف پول کسر می‌شود، هزینهٔ نصب یا لایسنس ندارد و با حذف سرور محاسبه متوقف می‌شود.

اگر کمپین پیامکی بزرگ دارید که در چند دقیقه ده‌ها هزار کلیک می‌گیرد، standard حافظه و پردازندهٔ بیشتری برای دیتابیس می‌دهد. ترافیک هدایت لینک ناچیز است، چون پاسخ فقط یک هدایت کوتاه است؛ ۵۰ گیگابایت ترافیک ماهانهٔ هر سرور برای میلیون‌ها کلیک کافی است. برای مقایسهٔ هزینه از ماشین‌حساب هزینه استفاده کنید.

هر سه راه لینک کوتاه می‌سازند، اما برای نیازهای متفاوت:

ارزش اصلی Shlink وقتی آشکار می‌شود که روی یک دامنهٔ کوتاه برند اجرا شود. یک دامنهٔ کوتاه از ثبت دامنه بگیرید یا زیردامنه‌ای مثل go.example.com بسازید و در مدیریت DNS آن را به IP سرور اشاره دهید. پروکسی لبهٔ ایران‌کلاد فقط به پورت ۸۰ سرور وصل می‌شود، پس یک nginx روی سرور نصب کنید که پورت ۸۰ را به 127.0.0.1:8080 برساند و دامنه را پشت پروکسی لبه قرار دهید تا گواهی SSL خودکار صادر شود.

پس از آن، در فایل compose مقدار DEFAULT_DOMAIN را دامنهٔ کوتاه و IS_HTTPS_ENABLED را true بگذارید و سرویس را دوباره بالا بیاورید تا لینک‌های تازه با آدرس درست ساخته شوند. در تنظیمات دامنه مشخص کنید بازدید از صفحهٔ اصلی دامنهٔ کوتاه و کدهای نامعتبر به کجا هدایت شوند، مثلاً به سایت اصلی‌تان؛ این از نمایش صفحهٔ خطای خام جلوگیری می‌کند.

بعد از فعال‌شدن HTTPS، قانون فایروال پورت ۸۰۸۰ را حذف یا به IP دفتر محدود کنید تا همهٔ بازدیدها از مسیر دامنه بیایند.

کلید API در Shlink دسترسی کامل به لینک‌ها دارد؛ هر کسی آن را داشته باشد می‌تواند مقصد لینک‌های منتشرشده را به صفحهٔ فیشینگ تغییر دهد. برای هر ابزار یک کلید جدا بسازید تا در صورت لو رفتن فقط همان را باطل کنید و کلیدها را در مخزن کد ذخیره نکنید. Shlink امکان ساخت کلید محدود به یک دامنه، یا کلیدی که فقط لینک‌های ساختهٔ خودش را مدیریت می‌کند، هم دارد.

رابط وب Shlink یک برنامهٔ مرورگری است که کلید API را در حافظهٔ مرورگر نگه می‌دارد، نه روی سرور. پس روی رایانهٔ مشترک از آن استفاده نکنید و پورت ۸۸۸۸ را در فایروال به IP دفتر محدود کنید. اگر رابط وب را عمومی نیاز ندارید، اصلاً آن را اجرا نکنید و لینک‌ها را با API یا خط فرمان بسازید.

نصب خودکار رمز دیتابیس را در فایل /etc/shlink-db-pw با دسترسی فقط برای root نگه می‌دارد و پورت دیتابیس را بیرون منتشر نمی‌کند. ایمیج‌ها را دوره‌ای با docker compose pull در /opt/shlink به‌روز کنید.

همهٔ دادهٔ Shlink در دیتابیس MariaDB است: لینک‌ها، برچسب‌ها، دامنه‌ها، کلیدهای API و تاریخچهٔ بازدیدها. بکاپ یعنی خروجی منظم mysqldump از دیتابیس shlink و نگه‌داری آن بیرون از سرور. اگر لینک‌هایتان روی محصول چاپ شده‌اند، از دست دادن دیتابیس یعنی شکستن همهٔ آن لینک‌ها؛ پس بکاپ را جدی بگیرید.

بکاپ کامل سرور را هم هر وقت خواستید از تب بکاپ پنل بسازید؛ بکاپ دستی است و فضای آن ساعتی ۲ تومان به ازای هر گیگابایت حساب می‌شود. جزئیات در صفحهٔ پشتیبان‌گیری. برای انتقال Shlink به سرور دیگر، دیتابیس را بازگردانید، همان فایل compose را اجرا کنید و رکورد DNS دامنهٔ کوتاه را به سرور جدید ببرید.

از سمت ما: نصب خودکار Shlink را آماده تحویل می‌دهد، اما دامنهٔ کوتاه و HTTPS را راه نمی‌اندازد. در نصب پایه لینک‌ها روی IP و پورت ۸۰۸۰ با http ساخته می‌شوند و برای دامنهٔ کوتاه و HTTPS به وب‌سرور جلوی آن نیاز دارید. سرور تک‌نودی است و اگر خاموش شود، همهٔ لینک‌ها تا روشن‌شدن دوباره کار نمی‌کنند.

از سمت Shlink: لینک رمزدار ندارد، موقعیت جغرافیایی بازدیدها بدون کلید GeoLite2 ثبت نمی‌شود و رابط وب برای مدیریت کاربران متعدد با سطح دسترسی متفاوت طراحی نشده است؛ کنترل دسترسی از طریق کلیدهای API انجام می‌شود. اسکریپت نصب کلید GeoLite2 را خالی می‌گذارد، پس آمار کشور و شهر تا وقتی خودتان کلید را اضافه نکنید خالی می‌ماند. ارسال انبوه پیامک یا ایمیل حاوی لینک باید با قوانین سیاست استفادهٔ مجاز سازگار باشد.