「OpenClash インストール」で来た人へ:ゼロからルータに載せる道筋

家庭や小規模オフィスで OpenWrt をゲートウェイやサブゲートウェイ(旁路)として使い、LAN 全体を OpenClash 経由にまとめたい——そう検索して本記事に辿り着いた方は、多くの場合ポリシーグループの切り替えより先に、「OpenClash OpenWrt インストール」「OpenWrt に OpenClash を入れる 2026」といった初回導入の手順を探しています。当サイトにはすでに LuCI でポリシーを選ぶ使い方 や 旁路透明プロキシの実測記事 がありますが、プラグインが未導入の状態から購読が取れるところまでを一本化したガイドは別途必要でした。本稿はその空白を埋めるため、ファームウェア要件 → 依存 → LuCI プラグイン → 初回購読 → 疎通確認の順で進めます。

コアは多くの環境で Mihomo(旧 Clash Meta)系を採用します。PC 向けクライアントの設定感覚は 購読インポートの一般解説 と通じますが、ルータではストレージ、iptables/nft、DNS 転送が追加の関心事になります。導入後の運用フェーズでは、ポリシー操作記事と旁路構成記事をセットで読むと、端末から見えたときの挙動がつながります。

ℹ️
表記について:メニュー名は「サービス → OpenClash」「設定 → 購読管理」などビルドで揺れます。本文では機能単位(購読、コア、ログ)で説明するので、手元の LuCI で近い項目を探してください。

ステップ 0:ファームウェアとアーキテクチャを先に突き合わせる

OpenClash インストールでいちばん多い失敗は、間違った CPU アーキテクチャ向けの ipk を入れることです。LuCI の「システム → システム」、または SSH で次を実行し、表示をメモします。

cat /etc/openwrt_release
opkg print-architecture
uname -m

代表的な対応は aarch64_cortex-a53(ARM ルータ)、x86_64(仮想マシンや x86 ボックス)、mipsel_24kc(旧世代 MTK 系)などです。ベンダー公式の OpenWrt 派生(ImmortalWrt、Kwrt など)を使っている場合も、自分のビルドが opkg のアーキ名を何と呼ぶかをここで固定してから GitHub Releases の luci-app-openclash 資産を選びます。カーネルが古すぎると kmod 不足で透明プロキシが立たない例もあるため、可能ならメンテナンス中の 22.x/23.x 系へ寄せる判断も検討してください。

⚠️
ストレージ:コアバイナリと GeoIP/GeoSite 類でオーバーレイが数メガバイト以上必要になることがあります。内蔵フラッシュが 16MB 級の機種では外部 USB オーバーレイや extroot を先に整えないと、インストール途中で容量不足になります。

ステップ 1:依存パッケージと DNS まわりを整える

公式ドキュメントやインストーラスクリプトが列挙する依存は、リリースごとに増減しますが、よく見るのは bash、curl、ca-bundle、dnsmasq-full(フル機能版)、iptables または nftables、ipset、kmod-tun などです。SSH で opkg を更新してから、不足分を入れます。

opkg update
opkg install bash curl ca-bundle dnsmasq-full \
  iptables ipset kmod-tun kmod-inet-diag

すでに dnsmasq だけが入っている構成では、dnsmasq-full へ置き換えが必要になることがあります。置き換え前に DHCP 範囲や既存の /etc/dnsmasq.conf をバックアップし、OpenClash 有効化後に LAN 端末が名前解決できるかを見ます。旁路構成でメインルータの DHCP を奪わない設計は 旁路記事 を参照してください。

時刻がずれていると HTTPS 購読が一括で失敗するため、システム → 時刻 → NTP で同期を有効にしておくことも、依存と同列の「見えない前提」です。失敗時の切り分けは 購読更新・TLS の記事 が参考になります。

ステップ 2:luci-app-openclash を LuCI に入れる

OpenClash OpenWrt インストールの本体は、luci-app-openclash とそれに付随する openclash パッケージです。入手経路は次のいずれかが一般的です。

  • 開発者が公開する GitHub Releases から、自分のアーキに合った luci-app-openclash_*.ipk をダウンロードし、LuCI の「システム → ソフトウェア → アップロード」から導入
  • ビルドに同梱された カスタムフィード を /etc/opkg/customfeeds.conf に追加し、opkg install luci-app-openclash
  • コミュニティのワンライナーインストールスクリプト(実行前に中身を必ず読む)

コマンド例(ファイルを /tmp に置いた場合):

opkg install /tmp/luci-app-openclash_*.ipk
/etc/init.d/rpcd restart

成功すると LuCI 左メニューに OpenClash が現れます。表示されないときは opkg list-installed | grep -i openclash でパッケージ名を確認し、依存エラー行を logread と合わせて読みます。アーキ不一致のときは「Installed in root is up to date」系の表示の裏で実体が入っていないことがあるため、file /usr/bin/openclash の有無も見てください。

初回起動前に、設定画面でコアバージョン(Mihomo 等)のダウンロードを促すビルドもあります。ネットワークが不安定なら、有線でルータをメイン回線に直結した状態でコア取得だけ先に済ませると、後の購読テストが楽です。

ステップ 3:初回購読(サブスクリプション)の取り込み

プラグインが入ったら、購読管理または Config Subscribe に相当する画面を開き、運用側から渡された HTTPS URL を一行で登録します。ポイントは次のとおりです。

  1. URL に余計な空白や改行を含めない(貼り付け後に末尾スペースを削除)
  2. 手動更新または「今すぐ取得」でリモート YAML を pull する
  3. ログに 200 相当の成功と、ノード数が 0 でないことを確認する
  4. 必要ならデフォルト設定テンプレ(デビアン/アップル系など)を選び、ルールの骨格を先に載せる

購読がパースできても、プロキシ一覧が空のときは上流の期限切れ・帯域制限・User-Agent 制限を疑います。ルータの時刻ずれで TLS が落ちるパターンは先に NTP を直してください。インポートの考え方は 購読インポート記事、取得後のグループ操作は ポリシーグループ記事 に続きます。

ℹ️
セキュリティ:購読 URL は事実上の認証情報です。スクリーンショットやクラウドメモに載せない、LuCI のリモート管理を WAN 側に晒さない、といった運用を推奨します。

ステップ 4:サービス起動と初回疎通の確認

購読が展開できたら、メインスイッチで OpenClash を起動し、コア状態が Running になるかを見ます。続けて次を順に確認します。

  • LuCI のプロキシ一覧に国・地域ラベル付きノードが並ぶ
  • 運用モードが意図どおり(多くはルールモードから開始)
  • LAN 側テスト端末のゲートウェイと DNSが OpenWrt(または旁路ルータ)を向いている
  • ブラウザで外向き IP 確認サイトを開き、出口がプロキシ側に変わる(またはルールどおり DIRECT のまま)
  • ログに大量の connection refused や i/o timeout が出ていない

「購読は成功、でもサイトが開かない」場合は、DNS ハイジャック(端末のセキュア DNS、別ルータのキャッシュ)、iptables 競合(他の広告ブロックプラグイン)、IPv6 だけ直抜きの三つを切り分けます。旁路ではメインルータの DHCP にデフォルトゲートウェイをサブルータの LAN IP で配るか、端末ごとに静的 GW を向ける必要があります。詳細は旁路記事の DHCP 節を参照してください。

よくあるつまずき(インストール直後)

ipk は入ったが実行ファイルがない/Exec format error

ほぼ確実にアーキ違いです。opkg print-architecture の先頭行と ipk ファイル名の aarch64/mips 表記を再照合し、正しい資産で入れ直します。

インストール中に No space left on device

df -h で overlay の使用率を確認します。不要パッケージの削除、ログのローテーション、USB オーバーレイの追加を検討してください。Geo データの自動更新をオフにして容量を空ける手もあります。

OpenClash をオンにしたら LuCI に入れない

ルールミスで管理ポートまで巻き込む、DNS ループで名前解決不能になるケースがあります。シリアルコンソールやフェイルセーフで /etc/config/openclash を退避し、サービスを止めてから設定を戻します。大きな変更は設定のエクスポートを先に取る習慣をつけてください。

よくある質問

ImmortalWrt や Kwrt でも同じ手順ですか。

大枠は同じですが、フィード URL とプリインストールパッケージが異なります。ビルド付属の OpenClash インストーラがある場合は、そちらを優先し、本記事の opkg 手順は「素の OpenWrt」向けの補助として使ってください。

メインルータと旁路ルータ、どちらに入れるべきですか。

メインを触りたくない・契約回線の設定を崩したくない場合は旁路に OpenClash 専用機を置く構成が多いです。メイン一台ですべて完結させる場合は DHCP と DNS の責務が重なるため、設定変更の影響範囲が広がります。

インストール後、最初に読むべき記事はどれですか。

ノードの選び方とポリシー操作は ポリシーグループ記事、LAN 全体の向き先は 旁路透明プロキシ記事 が次のステップです。

まとめ

OpenWrt に OpenClash をインストールする流れは、アーキとストレージの確認 → 依存パッケージ → luci-app-openclash → 初回購読 → 起動と実経路の検証の五段に分けると迷いが減ります。検索で「OpenClash OpenWrt インストール」「OpenWrt OpenClash 2026」と調べる段階の多くは、まだポリシーの細部よりここまで到達できるかが関心事です。到達後は運用記事へ進み、DNS とゲートウェイの向きを外側からも一度確認してください。

ルータ向けプラグインは、ビルド差・メニュー翻訳・スクリーンショットだけの断片情報が散らばりやすく、自分の機種に当てはまらないと挫折しがちです。一方、PC 向けクライアントは画面が揃っていて、同じ Mihomo ログをその場で読み比べやすい——という対比があります。ClashSky は、公式に近い導線とドキュメントを一か所にまとめ、ルータで詰まった設定をデスクトップで再現して切り分けやすくすることを意図しています。OpenClash の導入だけで手が止まったときは、並行して無料ダウンロードのページからクライアントを入れ、購読とログの見え方を揃えてみてください。

→ 無料で Clash をダウンロードし、快適な接続体験を試す