Posted inホームラボ

Bitlyはやめよう：ShlinkとDockerで自分専用のURL短縮サービスをセルフホストする方法

HomeLab tutorial - IT technology blog
HomeLab tutorial - IT technology blog

長すぎるURLという厄介な現実

私たちは皆、「URLの文字列の壁」に直面したことがあります。特定のドキュメントページやディープリンクされた製品を共有しようとすると、リンクが突然300文字にもなることがあります。それらは通常、UTMパラメータやセッションID、追跡用の意味不明な文字列で埋め尽くされており、一見するとフィッシング詐欺のようにも見えます。プロフェッショナルな現場で、これらをクライアントやチームメンバーに送るのは、洗練されておらず、乱雑な印象を与えます。

多くの人は自然と Bitly や TinyURL を利用します。それらは機能しますが、状況は変わりました。Bitly の無料プランは現在、非常に制限が厳しくなっており、最近ではリンク作成数が月にわずか10件までに削減されました。基本的なクリック分析や独自ドメインを使用したい場合、月額8ドルから29ドルを支払う必要があります。さらに重要なのは、サードパーティのサービスを利用するということは、トラフィックデータを仲介者に渡しているということです。HomeLab（ホームラボ）愛好家やプライバシーを重視する DevOps チームにとって、これは受け入れがたい問題です。

なぜサードパーティの短縮サービスは DevOps チームに向かないのか

セルフホストへの移行は、単に年間100ドルを節約することだけが目的ではありません。データ主権とプロフェッショナルなブランディングが重要です。bit.ly/xyz を使用すると、Bitly を宣伝していることになります。しかし、links.yourdomain.com/xyz を使用すれば、自分自身のブランドの権威を構築できます。

セキュリティも大きな要因です。サードパーティの短縮サービスは、フィッシング詐欺に悪用されやすいため、企業のファイアウォールや強力なメールフィルターによってブラックリストに登録されることがよくあります。クリーンなドメインで独自のインスタンスをホストすることで、メールの到達率を大幅に向上させることができます。また、完全な可視性も得られます。「プレミアム」な分析プランにお金を払うことなく、誰がリンクをクリックしたか、その発信元IP、ブラウザのバージョンなどを正確に把握できます。これは Webhook のデバッグやセキュリティ監査において非常に価値があります。

現状の比較：YOURLS 対 Shlink

以前にセルフホストについて調べたことがあるなら、おそらく YOURLS を見つけたはずです。それは定番ですが、古さも感じさせます。伝統的な PHP スタックで構築されているため、モダン化するのが面倒な場合があり、インターフェースも2010年代のような印象です。

Shlink はそのモダンな後継者です。PHPベース（Laminas）のマイクロサービスで、当初からコンテナネイティブとして設計されています。「ヘッドリス」アーキテクチャを採用しており、エンジンと Web インターフェースが分かれています。これは DevOps のワークフローにとって大きな利点です。REST API、CLI ツール、または公式の Shlink Web Client を介してすべてを管理できます。柔軟で高速、そして作業の邪魔になりません。

なぜモダンな HomeLab には Shlink が最適なのか

Shlink のキラー機能は、単一のインスタンスでのマルチドメインサポートです。内部ツール用の dev.link と公開マーケティング用の brand.link の両方を、1つの Docker コンテナに向けることができます。Shlink はこれらを個別に、滞りなく処理します。また、QR コードを自動生成し、MaxMind との連携により詳細なジオロケーション（位置情報）トラッキングも提供します。

このセットアップをマスターすることは、非常に良い練習になります。コンテナ化された環境で永続的なデータベースストレージを管理しながら、バックエンドサービスをフロントエンドから切り離す方法を学ぶことができます。

アーキテクチャ：サーバー vs クライアント

イメージをプルする前に、Shlink が2つの異なるパーツに分かれていることを理解しておきましょう。

  • Shlink Server: コアエンジン。リダイレクトを処理し、MariaDB、PostgreSQL、または SQLite にデータを保存します。
  • Shlink Web Client: React ベースのダッシュボード。API を介してサーバーと通信します。同じネットワーク上にある必要すらありませんが、簡素化のために今回は一緒に実行します。

Docker Compose による Shlink のデプロイ

バックエンドには MariaDB をお勧めします。軽量で信頼性が高く、一般的な短縮サービスの 100MB から 500MB 程度のデータベースサイズを余裕で処理できます。

プロジェクトディレクトリを作成し、以下の内容を docker-compose.yml ファイルに保存します。

version: '3.8'

services:
  shlink-db:
    image: mariadb:10.11
    container_name: shlink-db
    restart: always
    environment:
      - MARIADB_ROOT_PASSWORD=your_root_password
      - MARIADB_DATABASE=shlink
      - MARIADB_USER=shlink
      - MARIADB_PASSWORD=shlink_pass
    volumes:
      - shlink_db_data:/var/lib/mysql

  shlink-server:
    image: shlinkio/shlink:stable
    container_name: shlink-server
    restart: always
    depends_on:
      - shlink-db
    environment:
      - DB_DRIVER=mariadb
      - DB_USER=shlink
      - DB_PASSWORD=shlink_pass
      - DB_NAME=shlink
      - DB_HOST=shlink-db
      - DEFAULT_DOMAIN=ln.yourdomain.com
      - IS_HTTPS_ENABLED=true
    ports:
      - "8080:8080"

  shlink-web-client:
    image: shlinkio/shlink-web-client:stable
    container_name: shlink-web-client
    restart: always
    ports:
      - "8181:80"

volumes:
  shlink_db_data:

docker-compose up -d でスタックを起動します。エンジンは動作していますが、まだロックされた状態です。Shlink はデフォルトの管理者パスワードを使用せず、API キーを使用します。

API キーの生成

管理画面に入るには、コンテナの CLI を通じてキーを生成する必要があります。これは、ハードコードされた認証情報を避けるための安全でモダンなパターンです。次のコマンドを実行してください：

docker exec -it shlink-server shlink api-key:generate

表示された文字列を保存してください。次のステップで必要になります。

Shlink Web Client の設定

ブラウザで http://your-server-ip:8181 を開きます。「サーバーを追加（Add a server）」をクリックします。ここでよく混乱するのが「サーバーURL（Server URL）」です。Web Client はローカルのブラウザで動作するため、自分のコンピュータから実際に到達できる URL が必要です。

  • Name: My Shortener
  • URL: http://your-server-ip:8080
  • API Key: （先ほど生成した文字列）

「接続（Connect）」を押します。これでリンクを作成する準備が整いました。長い URL を短縮してみて、分析ダッシュボードがリアルタイムで更新されるのを確認してください。

リバースプロキシと HTTPS への対応

本番環境では、生の IP やポートを使用すべきではありません。Nginx Proxy Manager や Traefik などのリバースプロキシを使用してください。ln.yourdomain.com をポート 8080 の shlink-server コンテナにマッピングします。

HTTPS を使用する場合（強く推奨します）、IS_HTTPS_ENABLED 変数が true に設定されていることを確認してください。これにより、Shlink は安全でない http:// リンクの代わりに https:// リンクを生成するようになります。

高度なトラッキングとカスタムスラッグ

Shlink が真に輝くのは、分析の深さです。無料の MaxMind ライセンスキーを追加することで、Shlink は自動的に GeoLite2 データベースをダウンロードします。これにより、クリックごとに都市レベルのトラッキングが可能になります。

読みやすさも重要です。/a7G2k のようなランダムな文字列の代わりに、/portfolio や /meeting といったカスタムスラッグを作成できます。これらは、物理的な名刺や Instagram のプロフィールなど、クリーンで覚えやすい外観が求められる場所に最適です。

インフラ制御に関する最終的な考察

このセットアップは、単なる短縮リンク以上のものを提供します。それは、発信トラフィックのための中央ハブとなります。もしドメインを変更することになっても、DEFAULT_DOMAIN 変数を更新するだけです。履歴も一緒に移行できます。もはやサードパーティの価格設定の気まぐれに振り回されることはありません。

ここでの Docker の真の強みはポータビリティ（移植性）です。リンクの履歴全体は MariaDB ボリュームの中に大切に保管されています。そのデータをバックアップしている限り、短縮サービスは何年にもわたってサーバーやクラウドプロバイダー間を移行し続けることができます。これこそが、日常的なサービスをプライベートで永続的な、完全に自分のものにするという HomeLab の醍醐味です。

Share:
Tags: