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 执行 root@192.168.1.4
输入密码 (在输入密码时密码不可见)
输入 cattools
进行使用没安装的使用下面方法进行安装
如果你是 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
的文件提交问题
- 发行版
- 在线时间
- 内存使用状态
- 硬盘使用状态
- 已安装应用列表
- 系统日志
- 内核日志
- 部分插件日志
- 所有正在执行的任务
- 网卡信息
- 网络配置 (包含拨号信息,如果冒犯请抹掉或者直接发邮件)
- 防火墙
- 路由表
提交问题 或者发邮件到 i@miaoer.xyz 主题为 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 主菜单