Reference: Cloudbox Tools - dibrz/ARMBand GitHub Wiki
Cloudox comes with some useful command line tools and scripts. Some are meant to be utilized by Cloudbox, automatically (e.g. fail2ban, torrentcleanup.py, etc), and some are for your usage.
Name |
Type |
Description |
Invoked by |
Homepage |
---|---|---|---|---|
htop | application | Interactive process viewer for Unix. | htop |
http://hisham.hm/htop/ |
ctop | application | Top-like interface for container metrics. | ctop |
https://ctop.sh/ |
iotop | application | Top like utility for disk I/O. | iotop |
http://guichaz.free.fr/iotop/ |
nload | application | Monitor network traffic and bandwidth usage in real time. | nload |
http://www.roland-riegel.de/nload/ |
vnstate | application | Network traffic monitor for that keeps a log of network traffic for the selected interface(s). | vnstat |
http://humdi.net/vnstat/ |
nethogs | application | Small 'net top' tool that groups bandwidth by process. | nethogs |
https://github.com/raboof/nethogs |
ngrok | application | Secure tunnels to localhost. | ngrok |
https://ngrok.com/ |
ufw | application | UFW, or Uncomplicated Firewall, is a front-end to iptables. | ufw |
https://launchpad.net/ufw |
fail2ban | application | Ban hosts that cause multiple authentication errors. | fail2ban |
http://www.fail2ban.org |
speedtest-cli | application | Command line interface for testing internet bandwidth using speedtest.net | speedtest |
https://github.com/sivel/speedtest-cli |
Rclone | application | "rsync for cloud storage". | rclone |
https://rclone.org/ |
tree | application | Displays an indented directory tree, in color. | tree |
http://mama.indstate.edu/users/ice/tree/ |
ncdu | application | Disk usage analyzer with an ncurses interface. | ncdu |
https://dev.yorhel.nl/ncdu |
GNU Midnight Commander | application | A visual file manager. | mc |
https://midnight-commander.org/ |
hostess | application | Tool for tweaking local DNS by managing your /etc/hosts file. | hostess |
https://github.com/cbednarski/hostess |
logrotate | application | Utility is designed to simplify the administration of log files. | logrotate |
https://fedorahosted.org/logrotate/ |
npm | application | Package manager for Node.js modules. | npm |
https://www.npmjs.com/ |
frontail | application | Node.js application for streaming logs to the browser, like a tail -F with a UI. | frontail |
https://github.com/mthenw/frontail |
revoke_certs.sh | script | Revoke all of the SSL certifications for your domain | /opt/scripts/nginx/revoke_certs.sh |
https://github.com/Cloudbox/Cloudbox/wiki/Revoking-SSL-Certificates ; Credit: https://github.com/desimaniac |
certbot | application | Fetches and revokes certificates from Let’s Encrypt. Used by revoke_certs.sh. | certbot |
https://certbot.eff.org/ |
TorrentCleanup.py | script | Cleans up extracted media files in Rutorrent's downloads folder. | Sonarr / Radarr | Credit: https://github.com/l3uddz |
-Work in progress-
TorrentCLeanup.py has been explained in the Sonarr section, but in a nutshell, sonarr/radarr launches this script if you set it up, and it will scan the folder of the file that was imported, if rars exist, delete the file that was imported. this is useful for torrent sites that allow rars, as it will only leave you with the imported file (before its uploaded to google) and just the rars for seeding, instead of also leaving the extracted file.
( cd / && sudo ncdu -x
)
frontail is a Node.js application for streaming logs to the browser (basically a tail -F with an UI).
This is useful in cases you need help and need to show someone from slack support channels your logs. You can mask your IP using ngrok (more on that later).
Steps to do so are as follows:
frontail --ui-highlight --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed <path of log file> &
-
You may change the user and password.
-
The
&
at the end sends it to the background. -
You can now see this log at http://serveripaddress:9001.
-
To specify another port, just add:
--port <port>
Edit ~/.bashrc file and add the following (you may change the user and password):
## custom aliases
alias ftail='frontail --ui-highlight --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed '
You can now use:
ftail --port <port number> <log path> &
pkill -f frontail
frontail --port 9001 --ui-highlight --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed /opt/plex_autoscan/plex_autoscan.log &
or via alias...
ftail --port 9001 /opt/plex_autoscan/plex_autoscan.log &
or via docker...
docker run --restart=always --name "frontail_plex_autoscan" -d -p 9001:9001 -v /opt/plex_autoscan:/logs -v /opt/scripts/frontail/frontail_custom_preset.json:/preset/custom.json mthenw/frontail --ui-highlight --ui-highlight-preset /preset/custom.json --theme dark --user <user> --password <pass> /logs/plex_autoscan.log
Log: http://serveripaddress:9001
frontail --ui-highlight --port 9002 --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed /opt/cloudplow/cloudplow.log &
Log: http://serveripaddress:9002
or via alias...
ftail --port 9002 /opt/cloudplow/cloudplow.log &
or via docker...
docker run --restart=always --name "frontail_cloudplow" -d -p 9002:9001 -v /opt/cloudplow:/logs -v /opt/scripts/frontail/frontail_custom_preset.json:/preset/custom.json mthenw/frontail --ui-highlight --ui-highlight-preset /preset/custom.json --theme dark --user <user> --password <pass> /logs/cloudplow.log
Log: http://serveripaddress:9002
If you want to share your log with someone (forums, slack, etc), but don't want to reveal your IP address, you can use ngrok to hide your IP address.
ngrok http <port>
It will show you something like this...
You can now use the http://XXXXXXXX.ngrok.io
address to share your log. This will be active as long as ngrok is running. To cancel, ctrl-c
.