KUROKOTO LAB
SplitLane ガイド — 第1章 / 全6章

はじめに

SplitLane のインストールからヘルパー承認、最初のルール適用まで。

動作要件

SplitLane の動作には macOS 13(Ventura)以降 が必要です。SplitLane はVPN接続自体を確立するアプリではありません。すでにお使いのVPN接続(社内VPN、L2TP、IKEv2、WireGuardなど)を前提に、経路(ルーティング)だけを管理します。

SplitLane はMac App Storeでは配信していません。App Storeのサンドボックス環境では、このアプリが必要とするルーティングテーブルの変更が許可されていないためです。代わりに、Apple Developer IDによる署名とNotarization(悪意コード検査)を経た状態で直接配布しています。詳しくはFAQをご覧ください。

インストール

  1. SplitLaneのリリースページからDMGをダウンロードします。
  2. DMGを開き、SplitLane.app を Applications フォルダへドラッグします。

アプリを /Applications へ配置することは必須です。SplitLaneのPrivileged Helperはアプリバンドルのパスに紐づけて登録されるため、アプリが /Applications 以外の場所(ダウンロードフォルダ、マウント中のDMG、外部ボリュームなど)から実行されると、ヘルパーが起動できなくなります。インストール後にSplitLane.appを移動した場合は、ヘルパーの不具合を報告する前に /Applications へ戻してください。

初回起動

初めてSplitLaneを開くと、短いセットアップが以下の内容を案内します。

  1. このアプリの役割 — 指定した宛先だけをVPN経由にし、それ以外は直通にします。
  2. ヘルパーが必要な理由 — macOSでルーティングテーブルを変更するには管理者権限が必要です。本体アプリは管理者権限を持たず、決まった経路操作だけを代行する署名済みの専用ヘルパーが処理します。
  3. 対応VPNの種類 — SplitLaneは ppp* / utun* / ipsec* 系のネットワークインターフェースを作るVPN(L2TP、IKEv2、多くのWireGuard/IKEv2系クライアント)に対応します。VPNクライアント自身が独自に経路を再アサートする製品では、完全には制御できない場合があります。詳しくはTroubleshootingをご覧ください。
  4. ヘルパーのインストールと承認 — 下記で詳しく説明します。
  5. VPN interfaceの選択 — 下記で詳しく説明します。
  6. 最初のルール作成 — このステップはスキップ可能です。後からRules画面で追加できます。

ヘルパーの承認

「ヘルパーをインストール」をクリックすると、バックグラウンド項目の実行許可を求めるmacOSのシステムプロンプトが表示されます。これは正常な動作で、承認を待っている間、SplitLaneはエラーではなく「承認を待っています…」という状態を表示します。承認待ちは正常な状態であり、故障ではありません。

承認手順は次のとおりです。

  1. System Settings > Login Items & Extensions を開きます。
  2. リストからSplitLaneを見つけて許可します。
  3. SplitLane.appが Applications フォルダにあることを確認してください。ヘルパーのインストールはそこからのみ機能します。

SplitLaneはバックグラウンドで承認状況をポーリングしており、許可されると自動的に次へ進みます。アプリの再起動は不要です。

VPN interfaceの選択

SplitLaneは、どのネットワークインターフェースが自分のVPNなのかを認識して初めて経路を操作できます。検出したインターフェース候補(ppp* / utun* / ipsec*)を一覧表示し、以下の方法で対象を選べます。

  • ppp系すべて — ppp[0-9]+ に一致するすべてのインターフェース。PPP系VPNの既定の選択肢です。
  • utun固定 — 特定の utun インターフェース名を1つ固定指定します。これは上級者向けオプションです。VPNクライアントによっては接続のたびに utun の番号が変わるため、同じ名前が維持されない場合があります。インターフェース名が安定していると確認できているVPNでの利用をおすすめします。
  • 自動候補 — 起動のたびにその時点の候補を提示し、都度あなたに確認を求めます。自動では確定しません。

候補が表示されない場合は、先にVPNへ接続してから再度確認してください。この設定は後から Settings でいつでも変更できます。

最初のルールとApply

Rules 画面から、VPN経由にしたい宛先のルールを追加します。IP/CIDRブロック(例: 10.0.1.0/24)またはドメイン名(例: wiki.example.com)を指定できます。domainルールはバックグラウンドで自動的にIPアドレスへ解決されます。

ルールの追加・編集・有効無効の切替を行うと、ルールセットに未適用の変更がある状態(dirty)になります。Dashboardまたは Rules画面で Apply を押すまで、実際のネットワーク上の経路は変更されません。

適用が完了すると、Dashboardに現在のTraffic Mode、有効なルール数、最終適用時刻が表示されます。以降は、split routingの仕組みについてはCore Conceptsを、日々のルール管理についてはRulesをご覧ください。