banner
miaoer

miaoer

喵二の小博客 https://www.miaoer.net xLog 分站
tg_channel
telegram
bilibili

CatWrt Network Diagnosis and Update Check Script Usage Instructions

The installation method in this article is for reference only and has been replaced.

1

This article recommends everyone to install this catnd, and catwrt-update is a script for checking updates that has been available since CatWrt v23.2; the previous version did not have it, and future updates will integrate both.

catnd: Full name CatWrt-network-diagnostics, a network diagnostic script suitable for CatWrt.

catwrt-update: Checks CatWrt updates, responsible for checking if the server version information is consistent.

This article briefly discusses features that everyone may not know about; the script itself is open source and very useful.

Thanks to @timochan

First, these scripts need to be executed under SSH, as there is no graphical interface (LuCI). Installation is relatively simple and convenient to use. Of course, you can use third-party SSH tools to connect, such as Termius or Finalshell, or the TTYD WebShell that comes with the router system.

It is important to note that all scripts are located in /usr/bin.

catwrt-update#

Enter catwrt-update in the terminal to call the local verification file and compare it with the cloud server using SHA256.

When the output shows the result, there are no updates.

================================
Your CatWrt is up to date!
================================

When the output comparison finds an update, it provides the homepage link of the CatWrt project for downloading updates as needed; the specific update method may vary with version updates.

================================
Your CatWrt is out of date, you should upgrade it!
You can visit 'https://www.miaoer.net/posts/network/catwrt' to get more information!
================================

catnd#

Enter catnd in the terminal to start network diagnostics.

Install into CatWrt

curl https://fastly.jsdelivr.net/gh/miaoermua/catnd@main/installer.sh | bash

Self-Diagnosis#

Diagnosis result: Ping failed several times; checked that you included the PPPoE field.

Fix method: The account password may be incorrect.

[PPPoE] Please check if your PPPoE account and password are correct.

Diagnosis result: This DNS is unreliable.

Fix method: Change to a reliable DNS, for example: 223.6.6.6 223.5.5.5 119.29.29.99.

[DNS] Recommended to delete DNS $ip

Diagnosis result: Resolution failed.

Fix method: It may be a DNS, optical modem, or IPS issue.

[DNS] NS resolution failed for 'www.miaoer.xyz'
[DNS] Your DNS server may have issues

Diagnosis result: IPv6 address acquisition failed.

Fix method: Restore IPv6 settings.

[IPv6] IPv6 network connection timed out

Diagnosis result: CatWrt is not the default address; if you are a novice user, you may have changed the settings.

Fix method: Novice users should set it according to our blog.

[Default-IP] address is not the catwrt default 192.168.1.4
Please configure your network at 'https://www.miaoer.net/posts/network/quickstart-catwrt'

Diagnosis result: Bypass gateway? Why is there no WAN port?

[Bypass Gateway] No config for 'wan' interface found in /etc/config/network
Please check if your device is set as a Bypass Gateway

Diagnosis result: The router is not dialing to connect to the internet.

[PPPoE] DHCP protocol detected in WAN interface
The device may not be in PPPoE Router Mode

Diagnosis result: IPv6 interface deleted.

Fix method: Reconfigure the DHCPv6 client.

[wan6] Your IPv6 network may have issues

Offline Installation#

Suitable for those who are already offline but have not installed the catnd script, choose one of the two options.

Upload#

Download the file from https://github.com/miaoermua/catnd/raw/main/catnd.sh, upload it to /usr/bin/, then execute chmod +x /usr/bin/catnd.sh to grant execution permissions, and finally execute catnd.

Edit#

Copy all content from the file at https://github.com/miaoermua/catnd/raw/main/catnd.sh, and use editors like vi, vim, or nano to create catnd and grant execution permissions, then execute catnd.

chmod +x /usr/bin/catnd.sh
catnd

Open Source Code#

Welcome to discuss or point out errors to help us optimize. If you can, please PR this project to submit your code.

miaoermua/catnd
miaoermua/catwrt-update

This article was synchronized and updated to xLog by Mix Space. The original link is https://www.miaoer.net/posts/network/catwrt-bash-script

Footnotes#

  1. https://www.miaoer.net/posts/blog/cattools

Loading...
Ownership of this post data is guaranteed by blockchain and smart contracts to the creator alone.