git404hub

what is aliyun-guard fr?

felix666-ship-it/aliyun-guard — explained in plain English

Analysis updated 2026-05-18

12ShellAudience · ops devopsComplexity · 3/5Setup · moderate

tl;dr

A watchdog tool for Alibaba Cloud servers that auto stops them before traffic charges hit and can auto restart them on a schedule.

vibe map

mindmap
  root((aliyun-guard))
    What it does
      Watches CDT traffic
      Auto stops instances
      Auto restarts instances
    Tech stack
      Shell
      Python
      systemd or cron
      Docker
    Use cases
      Traffic cost control
      Daily power schedule
      Telegram remote control
      Encrypted backups
    Audience
      DevOps
      Cloud server owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically stop an Alibaba Cloud ECS instance before it exceeds a monthly traffic threshold.

VIBE 2

Schedule daily automatic power on and power off times for cloud servers.

VIBE 3

Get Telegram notifications and remote control over server power state.

VIBE 4

Back up server configuration with encryption and optionally sync backups to S3 storage.

what's the stack?

ShellPythonsystemdDockerTelegram Bot API

how it stacks up fr

felix666-ship-it/aliyun-guardabiodundotdo/termframeaveyo/streamlink-portable
Stars121212
LanguageShellShellShell
Last pushed2018-01-22
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audienceops devopsdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an Alibaba Cloud AccessKey and optional Telegram bot token for notifications.

in plain english

Aliyun Guard is a monitoring and automation tool for servers rented on Alibaba Cloud, known as ECS instances. Its main job is to watch how much public network traffic an account is using on Alibaba's CDT billing plan and automatically shut the server down before that traffic causes extra charges, then start it again once usage resets or drops back under the limit. The tool checks three things on a repeating schedule: the account's total CDT traffic for the month, the current status of each watched instance, and its pre tax bill. Based on those checks it decides whether to keep an instance running, start a stopped one, or stop a running one, following clear threshold rules. Users can also set a daily on and off schedule per instance, with times that can cross midnight and catch up if the service was briefly offline. Control happens through three interfaces. A terminal menu, opened by typing the command aliyun-guard or the shortcut ag, lets you add or edit instances, run test checks, view logs, and manage settings. A web dashboard offers the same controls in a browser, with charts showing traffic history and what action was taken at each check. A Telegram bot can also report status and accept commands like checking now or turning an instance on or off, with confirmation steps required before any real power action. The project supports several Linux distributions and package managers, and it can run under systemd, OpenRC, or fall back to cron if neither is available. It also ships as a Docker image. Extra features include encrypted backups that can be restored or rolled back, optional automatic backup uploads to S3 compatible storage, a watchdog that restarts the service if it stops responding, and a bulk discovery feature that scans an Alibaba Cloud account for existing ECS instances to import. Credentials are stored with restricted file permissions and are not written to logs.

prompts (copy fr)

prompt 1
Help me install aliyun-guard on my Alibaba Cloud ECS instance using the terminal.
prompt 2
Explain how the CDT traffic threshold and auto shutdown logic works in this project.
prompt 3
Show me how to set up the Telegram bot notifications for this tool.
prompt 4
Walk me through configuring the daily power on and off schedule for one instance.

Frequently asked questions

what is aliyun-guard fr?

A watchdog tool for Alibaba Cloud servers that auto stops them before traffic charges hit and can auto restart them on a schedule.

What language is aliyun-guard written in?

Mainly Shell. The stack also includes Shell, Python, systemd.

How hard is aliyun-guard to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is aliyun-guard for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.