Cattools 工具箱，功能介紹及使用說明

來龍去脈#

Cattools 是基於 BASH 編寫的 CatWrt 強大工具箱，幫助用戶輕鬆實現各種實用功能。用於解決部分修改不便利所衍生品，深度適配 CatWrt 配置且兼容舊版本，部分功能可能存在 BUG 如遇到問題請尋找我解決！

操作指南#

[Step 1] 指步驟 / 進度
([Enter] 確認 / [0] 退出) 指操作按鍵 *
INFO 指內容
UPDATE 指更新
Warning 指警告

* 注：如數字鍵 [1] 操作輸入後需要 [Enter] 回車確認

安裝 Cattools#

在 v24.9（mt7621 & amd64）版本我們預裝了 Cattools 不需要再次安裝！

我們對於舊版本一樣歡迎但是軟體包可能有點舊，像是增強配置裡面的幾個會配置不了。

curl https://service.miaoer.xyz/cattools/install.sh | bash

安裝後輸入 cattools 即可使用並顯示以下內容

root@CatWrt:~# cattools 
Please wait for the script to be updated.
cattools update downloaded from the second URL.
cattools updated successfully.


----------------------------------------------------------
                         CatTools                         
           https://github.com/miaoermua/cattools          
----------------------------------------------------------
1. SetIP                                  -  設置 IP
2. Network_Wizard                         -  網路向導
3. Apply_repo                             -  軟體源配置
4. Diagnostics                            -  網路診斷
5. Debug                                  -  抓取日誌
6. Catwrt_update                          -  檢查更新
7. Sysupgrade                             -  系統更新
8. Restore                                -  恢復軟體包
9. Utilities(more)                        -  實用工具
0. Exit                                   -  退出
----------------------------------------------------------
請輸入數字並回車(Please enter your choice): _

使用方法#

如果不會使用 SSH，具體參考這個博客 👇

虛擬機 / 實體機#

在跑碼的話需要等到 [40.xxx] 或者更多才能回車輸入 cattools 進行使用，使用過程中無法讀取中文所以顯示方塊字，如果提示沒安裝並且命令無誤就是沒安裝，不能在這種方法上安裝，除非你真的可以完整無誤的輸入安裝命令

SSH#

Windows 10 及以上使用系統默認 OpenSSH 執行 [email protected] 輸入密碼 (在輸入密碼時密碼不可見)

輸入 cattools 進行使用沒安裝的使用下面方法進行安裝

::: gallery

:::

如果你是 Windows 10 及以上版本提示沒有 SSH 請按照微軟官方文檔進行安裝適用於 Windows 的 OpenSSH 入門

或者使用第三方 SSH 進行連接，例如 Putty（簡陋，英文，易理解），Termius（功能多，英文，更易用），Finalshell （中文，易用，不建議使用）

TTYD#

打開 CatWrt 後台輸入密碼後回車，找到系統 - TTYD 終端，輸入帳戶 root 密碼默認 password (在輸入密碼時密碼不可見) 輸入 cattools 進行使用沒安裝的使用下面方法進行安裝

SetIP - 設置 IP#

數字項 1

可以在虛擬機創建時手動配置 IP 地址到你期望的子網網段，不需要花里胡哨的設置，更適合牢玩家配置大神，是下面網路向導的折中方案

操作方法輸入一個你需要的 IP 地址，執行後會重啟網路部分不需要重啟 CatWrt 即可進後台進行配置

該方法適用於傳統操作玩家，手動配置完成網路後需要重啟 CatWrt 以獲得正常的網路。

Please enter the IP Addr and press Enter /// 请输入 IP (默认为 192.168.1.4): 10.0.0.4

Network_Wizard - 網路向導 (旁路網關)#

數字項 2

網路向導是一個基礎配置，無需用戶過多干預即可獲得推薦配置，省心又省力，包括以下內容

[Step2] 旁路網關 (旁路由)
[Step3] 設置 IP
[Step4] IPv6
[Step5] 撥號上網 (PPPoE) / 自動獲取 (DHCP)
[Step6] DNS
[Step7] IP 網段
[Step8] 強制 DHCP
[Step9] UPNP
[Step10] 網口綁定

注：旁路網關設置目前僅支持單網口，腳本將識別單網口設備為，旁路網關才彈出該設置，如果你是多網口見不到

網口綁定是讓 eth0 當 wan 口，eth1 當 lan 口，和默認的情況是相反的。

建議超過 3 個網口主機的進行此操作

Bypass_gateway - 旁路網關#

包含在 network_wizard - 網路向導中，無法被數字鍵直接調用

設計邏輯是讓用戶輸入指定主路由 IP，自動將 IP 改為該子段的 .4，並且開啟或禁用以下功能

[Step3] 獲取主路由 IP
[Step4] 設置旁路網關 IP
[Step5] 設置 DNS

如：用戶輸入主路由 IP 192.168.31.1 腳本自動生成 IP 192.168.31.4 給本機作為旁路網關使用

注：設備被更改後不能通過網路向導還原為路由模式；不建議使用主路由當 DNS 伺服器，雖然能用但是不規範

Apply_repo - 軟體源配置#

數字項 3

使用戶無需選擇版本號自動檢測版本，選中指定軟體源鏡像或者主站，即可獲取由 CatWrt 提供的豐富軟體包，兼容舊版本到 v22.12 的 CatWrt

Q: 為什麼不集成軟體源配置，而是使用默認騰訊雲 A: 因為沒錢運營如果做了集成可能導致部分場景被刷流，導致伺服器不堪重負

選擇一個非主站的，如果你對你的網路環境不抱太大希望就選主站，我希望非贊助用戶可以選擇免費提供的鏡像，如果你願意支持我們可以選擇主站。

主站 repo.miaoer.xyz 是本站搭建在阿里雲廣州機房的一個軟體源，對於 Cattools 後時代我們採取贊助方式使用。
Github Pages 是免費提供的項目托管鏡像站
Cloudflare 免費提供的 CDN 加速後綴如上，對部分地區可能不友好，但是能用
Vercel 免費提供的無伺服器托管鏡像站
Netlify 免費提供的無伺服器托管鏡像站

選擇好對應服務的數字，或者什麼都不做等 5 秒則默認使用 Vercel 鏡像，應用完成後即可使用 opkg install 安裝應用

Diagnostics - 網路診斷#

數字項 4

自動化檢查已知的可疑位置，防止誤操作導致的斷網或者網路故障

PING
DNS
LSLOOKUP
IPv4
IPv6
優選 IPv6
WAN (旁路網關)
PPPoE (DHCP)
WAN6
Tcping

Debug - 抓取日誌#

數字項 5

關於除了插件配置的所有能涉及問題的地方抓取，並且可以通過瀏覽器訪問到，可以用於反饋 BUG

需要用戶執行後使用 [CTRL] + [鼠標左鍵] 打開日誌，[CTRL] + [C] 複製所有文本，新建一個名字為 logs.txt 的文件提交問題

發行版
在線時間
記憶體使用狀態
硬碟使用狀態
已安裝應用列表
系統日誌
核心日誌
部分插件日誌
所有正在執行的任務
網卡信息
網路配置 (包含撥號信息，如果冒犯請抹掉或者直接發郵件)
防火牆
路由表

提交問題或者發郵件到 [email protected] 主題為 catwrt logs: + 問題描述

TG Guoup: t.me/miaoergroup // QQ Guoup: 669190476

CatWrt_update - 檢查更新#

數字項 6

設計邏輯是查看本地文件和博客後端伺服器中的校驗值是否相同實現的檢查更新

本機現在的版本

LOCAL  =================================================
當前版本: v24.9
當前架構: amd64
當前通道: Beta
========================================================

最新版本：Your CatWrt is latest version!

非最新版本：New CatWrt updates found!

UPDATE  ================================================
發現新版本：v23.8 > v24.9 (Beta)
版本：CatWrt.v24.9.amd64
博客：https://www.miaoer.xyz
========================================================

Sysupgrade - 系統更新#

數字項 7

設計邏輯是自動檢測是否滿足升級條件，並且自動獲取下載鏈接，無需繁瑣的前往網站下載

檢測項

EFI
總空間大小
是否為 x86_64 (AMD64), mt7621

升級系統會導致啟用軟體源安裝的所有軟體被新固件覆蓋

ROOT 帳戶的密碼可能被還原為默認密碼：(password)

升級過程中會保留插件配置和預裝插件以獲得升級

會抹除 opkg 或手動方式安裝的插件，可以通過後續在軟體源中獲取！

該更新同樣會下載最新版本，應當更新前使用 Cattools 中的 catwrt_update 檢查更新

下載項

是否選擇 ghproxy 提供的加速下載，原始由 Github release 直接下載

Restore - 恢復軟體包#

數字項 8

這個功能是實現在系統升級後用於還原軟體包，眾所周知的原因 CatWrt (LEDE) 升級後丟掉手動安裝的插件

和 Sysupgrade - 系統更新配合使用，系統更新前會使用這個功能備份已經安裝的軟體包列表，在更新完成後使用 配置軟體源 這個功能獲取最新的軟體源

在操作後使用這個功能讀取軟體包列表，Cattools 會自動安裝升級前的軟體即插件

Utilities (more) - 實用工具#

數字項 9

設計邏輯是實現一些應用的支持和配置，一站式配置

1 內核下載，內核下載後可以啟用插件的功能，由用戶提供的配置文件才能開啟
2 Tailscale 配置，可以自動配置 tailscale 實現異地組網內網穿透
3 Leigod 配置，可以安裝雷神加速器插件，加速遊戲主機，PC，手機
4 TTYD 免密，適合不聯網環境 SSH 終端調試或新環境配置時方便操作，因為比較危險小白無需開啟
5 導入 IPK 軟體包，在導入安裝 CatWrt 軟體源中沒有的軟體包
6 SSL/TLS 上傳，配置騰訊雲和阿里雲的手動下載的證書壓縮包，需要搭配 DDNS 域名解析
7 重置 root 密碼，將密碼還原為 password，適用於 x86_64 接屏後操作，或者單純是用 SSH 軟體保存了密碼但是自己忘了的情況
8 重置系統，將系統還原為出廠設置 (CatWrt 固件最初的樣子)，會放棄所有的配置插件從頭來過
0 返回 Cattools 主菜單

此文由 Mix Space 同步更新至 xLog
原始鏈接為 https://www.miaoer.net/posts/blog/cattools