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 を使用すると、ソフトウェアソースを迅速に構成でき、以下の煩雑な設定は不要です。

前に使用する場合は、リストを更新するために opkg update を実行し、まずターミナルで 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

Xiaomi/Redmi 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 x86_64 の例を示します。

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