scripts

A collection of helper scripts for provisioning, tuning, and maintaining the project's server infrastructure.

Layout

.
└── install/   # one-shot installers for system packages and kernels

Contents

Script	Description	Platform
install/xanmod.sh	Auto-installs the latest XanMod kernel (LTS / mainline / RT) with x86-64 microarchitecture detection (v1–v4) and resilient SF mirror logic	Ubuntu / Debian, x86_64

Usage

Each script is self-contained and documents its usage in the file header. General pattern:

curl -fsSL https://raw.githubusercontent.com/stealthsurf-vpn/scripts/main/<path>.sh | sudo bash
# or
wget https://raw.githubusercontent.com/stealthsurf-vpn/scripts/main/<path>.sh
sudo bash <path>.sh [args]

install/xanmod.sh

sudo bash install/xanmod.sh          # latest LTS (default)
sudo bash install/xanmod.sh main     # latest mainline
sudo bash install/xanmod.sh rt       # latest real-time

What it does:

• detects the x86-64 level (v1/v2/v3/v4) from CPU flags;
• resolves the latest version in the chosen channel via the SourceForge RSS feed;
• picks an available build variant (falling back to a lower level if the target one isn't published);
• downloads the .deb packages through aria2c with a fallback to a curated list of working mirrors;
• installs linux-image and linux-headers, then prints a rollback command.

Requirements

• Run as root (sudo)
• bash, curl, wget (installed automatically if missing)
• See the header of each script for script-specific requirements

Conventions

• All scripts run under set -euo pipefail
• Idempotent: re-running must not break the system
• Each script header must include a short description, usage examples, and supported platforms

License

MIT