CatWrt 拡張アプリのためのプラグインインストールガイド全系エコシステム共通

開始#

CatWrt-v22.11 ファームウェアでは、以前に提案されたソフトウェアソースの設計を実装し、CatWrt の過度な肥大化の問題を緩和しました。この文章を読み終えると、opkg ソフトウェアパッケージマネージャについて明確な理解が得られると思います。また、次のブログと合わせて、初心者でも簡単にアプリケーションのデプロイができるようになります。

このチュートリアルは他の OpenWrt/LEDE/QWRT には適用できないかもしれませんので、参考程度にしてください。私たちのソフトウェアソースを使用したい場合は、CatWrt を検討してみてください。

このチュートリアルの実装をより便利にする方法は、システム内の Cattools に統合された アプリケーションソース です。

賢い頭を準備する必要があります。一部の地域ではネットワークの加速が必要かもしれません！

CatWrt リポジトリ

::: warning
完全に読み終えることをお勧めします。その後、記事の下部で第二篇を見て問題を確認してください。
:::

opkg#

opkg ツールは、ローカルソフトウェアリポジトリまたはインターネットソフトウェアリポジトリから OpenWrt ソフトウェアパッケージをダウンロードしてインストールするための軽量なパッケージマネージャです。

GNU/Linux ユーザーは apt-get、pacman、yum などのパッケージマネージャに慣れているかもしれませんし、その類似点に気づくでしょう。CatWrt も例外ではありません。
私たちのファームウェアは多くのパッケージを含んでいますが、無料リソースの乱用を防ぐために、デフォルトでは CatWrt リポジトリにソフトウェアソースが設定されていません。このブログを読んでソースの変更について理解し、デフォルトで提供される Tencent Cloud のパッケージリポジトリを使用してください。

プラグイン#

プラグインをインストールする前に、これらを理解しておく必要があります。インストール中に問題が発生しないようにするためです。

LuCI は通常、プラグインアプリケーションのフロントエンド管理パネルを指します。OpenWrt では、アプリケーションはプラグイン (luci-app) + 言語 (luci-i18n) + ソフトウェア + 依存関係に分かれています。プラグインは保存して適用する際に、LuCI フロントエンドから uci に渡され、プラグイン設定を適用します。たとえば、ソフトウェアを有効にするために設定項目を開いたり変更したりします。

簡単に言うと、オフラインインストールは推奨しません。たとえば、luci-app-xxx.ipk パッケージをダウンロードした場合、ソフトウェア本体 + 実行依存の ipk ファイルが必要です。何が依存しているのかを注意深く確認する必要があります。この依存関係は多岐にわたる場合があり、iStore ストアや oc 猫猫のように依存関係が非常に多いプラグインもあります。また、本体をダウンロードしたのに中国語パッケージ i18n がないという問題もあります。

したがって、ソフトウェアソースを使用することは必須です。これは GNU/Linux を使用するための基本的なスキルでもあります。ソフトウェアソースの各 opkg update は、指定されたソースから各インデックスファイルを取得するものであり、すべてのプラグインをダウンロードするわけではなく、ファームウェアの更新を意味するものでもありません！

次に、自分の CatWrt アーキテクチャのソフトウェアソースを選択します。読み終えた後、さまざまな拡張アプリケーションをインストールできるようになると信じています。

プラグインが多すぎるとソフトルーターが不安定になる可能性があります！インストールできることは保証しますが、全体のファームウェアの安定性は保証しません。

アーキテクチャの選択#

x86 と ARM#

x86 と ARM (rockchip) ソフトルーターは、通常、ソフトウェアルーターの方式であり、ハードウェアアクセラレーションや無線 Wi-Fi 機能を持ちません。

CatWrt の拡張作業を完了する必要があります。overlay パーティションと Docker パーティションを拡張する必要があります。将来のアップグレードのために、200M の空きハードディスクスペースを確保することをお勧めします。他のパーティションはできるだけ大きくすることができます。

v23.8 以降は十分な空きスペースが確保されているため、拡張は必要ありません。アプリケーションが非常に多くのインストールを必要としない限り。

拡張チュートリアル：overlay の拡張 / ルートディレクトリの拡張

Wireless#

CatWrt Wireless シリーズのハードルーターにインストールされるプラグインは、通常、無線 Wi-Fi 機能を持つ家庭用ルーターを示します。

MT798x は v23.8 バージョン以降、軽量ファームウェアであり、十分な空きスペースがあり、いくつかの基本的なアプリケーションをインストールできます。
MT7621 は軽量ファームウェアであり、多くのプラグインをインストールすることは推奨しません。このプロセッサを放っておいてください。

ソフトウェアソース#

😍 Cattools を使用すると、ソフトウェアソースを迅速に構成でき、以下の煩雑な設定は不要です。

前に使用する前にリストを更新した場合は、まずターミナルで rm -f /var/lock/opkg.lock を実行して、デフォルトの Tencent ソースのインデックスファイルをクリアし、次にソースインデックスを CatWrt のリリース版ソフトウェアソースに入力してから更新してください。

使用できない場合や接続できない場合は、下部で分流ソースの使用方法の例を探してください。もちろん、使用する前に各利用可能なソースをテストすることもできます。

アリババクラウド: https://repo.miaoer.xyz
Vercel: https://vercel.catwrt.eu.org
Netlify: https://netlify.catwrt.eu.org
Vercel (Cloudflare プロキシ): https://cfvercel.catwrt.eu.org
Netlify (Cloudflare プロキシ): https://cfnetlify.catwrt.eu.org

x86-64

従来の x86 ソフトルーター（x86_64/AMD64/64 ビットのみサポート；x86_32/386/32 ビットはサポートされていません）

リリース版：v24.9

src/gz openwrt_core https://vercel.catwrt.eu.org/targets/x86/64/packages
src/gz openwrt_base https://vercel.catwrt.eu.org/x86_64/base
src/gz openwrt_luci https://vercel.catwrt.eu.org/x86_64/luci
src/gz openwrt_packages https://vercel.catwrt.eu.org/x86_64/packages
src/gz openwrt_routing https://vercel.catwrt.eu.org/x86_64/routing
src/gz openwrt_telephony https://vercel.catwrt.eu.org/x86_64/telephony

mt798x

TP-link TL-XDR 4288/6086/6088、Xiaomi Redmi AX6000、Xiaomi WR30U、jcg q30、GL.inet mt3000、H3C nx30Pro をサポート

リリース版：v23.8

src/gz openwrt_core https://vercel.catwrt.eu.org/targets/mt798x/filogic/packages
src/gz openwrt_base https://vercel.catwrt.eu.org/mt798x/base
src/gz openwrt_luci https://vercel.catwrt.eu.org/mt798x/luci
src/gz openwrt_packages https://vercel.catwrt.eu.org/mt798x/packages
src/gz openwrt_routing https://vercel.catwrt.eu.org/mt798x/routing
src/gz openwrt_telephony https://vercel.catwrt.eu.org/mt798x/telephony

aarch64_generic

電犀牛 r66s、友善 r5s （適合問題は機種のみ使用可能）

リリース版：v22.12

src/gz openwrt_core https://vercel.catwrt.eu.org/targets/rockchip/armv8/packages
src/gz openwrt_base https://vercel.catwrt.eu.org/aarch64_generic/base
src/gz openwrt_luci https://vercel.catwrt.eu.org/aarch64_generic/luci
src/gz openwrt_packages https://vercel.catwrt.eu.org/aarch64_generic/packages
src/gz openwrt_routing https://vercel.catwrt.eu.org/aarch64_generic/routing
src/gz openwrt_telephony https://vercel.catwrt.eu.org/aarch64_generic/telephony

mt7621

小米 / 紅米 AC2100、新ルーター 3（Newifi_d2）など...

リリース版：v24.9

src/gz openwrt_core https://vercel.catwrt.eu.org/targets/mt7621/packages
src/gz openwrt_base https://vercel.catwrt.eu.org/mt7621/base
src/gz openwrt_luci https://vercel.catwrt.eu.org/mt7621/luci
src/gz openwrt_packages https://vercel.catwrt.eu.org/mt7621/packages
src/gz openwrt_routing https://vercel.catwrt.eu.org/mt7621/routing
src/gz openwrt_telephony https://vercel.catwrt.eu.org/mt7621/telephony

ソースの変更#

利用可能なソースの変更#

他のミラーソフトウェアソースにアクセスできない場合は、Cloudflare を使用してドメインを置き換えることができます。

たとえば、vercel のドメインの前に cf を追加するだけで CDN ソースを使用できます。

src/gz openwrt_core https://cfvercel.catwrt.eu.org/targets/mt798x/filogic/packages
src/gz openwrt_base https://cfvercel.catwrt.eu.org/mt798x/base
src/gz openwrt_luci https://cfvercel.catwrt.eu.org/mt798x/luci
src/gz openwrt_packages https://cfvercel.catwrt.eu.org/mt798x/packages
src/gz openwrt_routing https://cfvercel.catwrt.eu.org/mt798x/routing
src/gz openwrt_telephony https://cfvercel.catwrt.eu.org/mt798x/telephony

歴史的（LTS）ソースの使用#

ブログに掲載されているのはすべて長期サポートバージョン (LTS) の歴史的バージョンで、/history フォルダ内に追加されています。

CatWrt.v22.2 の例を挙げると

src/gz openwrt_core https://vercel.catwrt.eu.org/history/v22.2/targets/x86/64/packages
src/gz openwrt_base https://vercel.catwrt.eu.org/history/v22.2/x86_64/base
src/gz openwrt_luci https://vercel.catwrt.eu.org/history/v22.2/x86_64/luci
src/gz openwrt_oui https://vercel.catwrt.eu.org/history/v22.2/x86_64/oui
src/gz openwrt_packages https://vercel.catwrt.eu.org/history/v22.2/x86_64/packages
src/gz openwrt_routing https://vercel.catwrt.eu.org/history/v22.2/x86_64/routing
src/gz openwrt_telephony https://vercel.catwrt.eu.org/history/v22.2/x86_64/telephony

ソフトウェアソースのデプロイ#

このリポジトリを自分のサーバーにデプロイして、自分のソフトウェアソースを構築できます。デプロイ後は、上記の機種のソフトウェアソース構成ファイルを修正して、ドメインを自分のコンテナアドレスに変更してください。

docker-compose を使用してデプロイし、オーケストレーションファイルをローカルに取得して起動します。

$ wget https://fastly.jsdelivr.net/gh/miaoermua/CatWrt@main/docker-compose.yml

$ docker compose up -d  
# docker-compose up -d

または、コマンドを使用して直接デプロイします。

$ docker run -d -p 1480:80 miaoer/catwrt-repo:latest

Linux パネルを使用してデプロイ

このリポジトリを git clone https://github.com/miaoermua/CatWrt.git を使用してサーバーのウェブサイトディレクトリに取得し、パネルのウェブサイトディレクトリを CatWrt に変更します；

Windows でのデプロイ

⁴

インストール方法#

LuCI でのインストール#

操作する前に、ソフトウェアソースを更新してください。

システム - ソフトウェアパッケージ - アクション - リストを更新

プラグインリストをカスタムソフトウェアソースに追加し、更新後にシステム - ソフトウェアソース - 動的 - 利用可能なソフトウェアパッケージ L を確認します。

そして、CTRL + F で luci-app を検索してみてください。

更新を行ってからプラグインをインストールします。もちろん、ここでは luci-i18n-xxxxx-zh-cn のようなパッケージを先にインストールすることができます。これは中国語パッケージであり、中国語パッケージをインストールすることはプラグインをインストールすることを意味しますが、一部のソフトウェアは別々にインストールする必要がある場合がありますので、状況に応じて判断してください。

ターミナルでのインストール#

ここでは、ある程度の経験がある人に操作をお勧めします。ターミナルで実行します。ここでは動的 DNS のインストールを例に挙げます。

⁵

opkg update  ## ソフトウェアソースを更新

opkg install luci-app-ddns  ## プラグイン

opkg install luci-i18n-ddns-zh-cn  ## プラグイン中国語パッケージ

以下は CatWrt で iStore ストアをインストールする例です。

ここでは CatWrt ソフトウェアソースを使用し、リリース版ソフトウェアソースに上書きされています。opkg update を実行してソフトウェアソースのインデックスファイルを取得し、opkg install luci-app-store を実行します。

BusyBox v1.36.0 (2023-07-05 11:34:20 UTC) built-in shell (ash)


     _____     _             _
    |     |___| |_ _ _ _ ___| |_
    |   --| .'|  _| | | |  _|  _|
    |_____|__,|_| |_____|_| |_|
   W I R E L E S S   F R E E D O M

======================================
         CatWrt.v23.8.x86_64
           Blog: miaoer.xyz
 OpenWrt: Lean source r6134-961ee0e81
======================================
root@CatWrt:~# opkg update
Downloading https://netlify.catwrt.eu.org/targets/x86/64/packages/Packages.gz
Updated list of available packages in /var/opkg-lists/openwrt_core
Downloading https://netlify.catwrt.eu.org/targets/x86/64/packages/Packages.sig
Signature check passed.
Downloading https://netlify.catwrt.eu.org/x86_64/base/Packages.gz
Updated list of available packages in /var/opkg-lists/openwrt_base
Downloading https://netlify.catwrt.eu.org/x86_64/base/Packages.sig
Signature check passed.
Downloading https://netlify.catwrt.eu.org/x86_64/luci/Packages.gz
Updated list of available packages in /var/opkg-lists/openwrt_luci
Downloading https://netlify.catwrt.eu.org/x86_64/luci/Packages.sig
Signature check passed.
Downloading https://netlify.catwrt.eu.org/x86_64/packages/Packages.gz
Updated list of available packages in /var/opkg-lists/openwrt_packages
Downloading https://netlify.catwrt.eu.org/x86_64/packages/Packages.sig
Signature check passed.
Downloading https://netlify.catwrt.eu.org/x86_64/routing/Packages.gz
Updated list of available packages in /var/opkg-lists/openwrt_routing
Downloading https://netlify.catwrt.eu.org/x86_64/routing/Packages.sig
Signature check passed.
Downloading https://netlify.catwrt.eu.org/x86_64/telephony/Packages.gz
Updated list of available packages in /var/opkg-lists/openwrt_telephony
Downloading https://netlify.catwrt.eu.org/x86_64/telephony/Packages.sig
Signature check passed.
root@CatWrt:~# opkg install luci-app-store
Installing luci-app-store (0.1.14-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/base/luci-app-store_0.1.14-1_all.ipk
Installing xz-utils (5.4.1-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/packages/xz-utils_5.4.1-1_x86_64.ipk
Installing liblzma (5.4.1-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/packages/liblzma_5.4.1-1_x86_64.ipk
Installing xz (5.4.1-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/packages/xz_5.4.1-1_x86_64.ipk
Installing libbz2-1.0 (1.0.8-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/base/libbz2-1.0_1.0.8-1_x86_64.ipk
Installing bzip2 (1.0.8-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/base/bzip2_1.0.8-1_x86_64.ipk
Installing tar (1.34-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/packages/tar_1.34-1_x86_64.ipk
Installing coreutils-stat (9.1-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/packages/coreutils-stat_9.1-1_x86_64.ipk
Installing luci-lib-xterm (4.18.0) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/base/luci-lib-xterm_4.18.0_all.ipk
Installing script-utils (2.38.1-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/base/script-utils_2.38.1-1_x86_64.ipk
Installing coreutils-stty (9.1-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/packages/coreutils-stty_9.1-1_x86_64.ipk
Installing taskd (1.0.3-1) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/base/taskd_1.0.3-1_all.ipk
Installing luci-lib-taskd (1.0.17) to root...
Downloading https://netlify.catwrt.eu.org/x86_64/base/luci-lib-taskd_1.0.17_all.ipk
Configuring libbz2-1.0.
Configuring liblzma.
Configuring luci-lib-xterm.
Configuring coreutils-stat.
Configuring bzip2.
Configuring xz-utils.
Configuring xz.
Configuring tar.
Configuring script-utils.
Configuring coreutils-stty.
Configuring taskd.
Configuring luci-lib-taskd.
Configuring luci-app-store.
root@CatWrt:~#

次回

⁶

この記事は Mix Space によって xLog に同期更新されました
元のリンクは https://www.miaoer.net/posts/network/catwrt-install-application