VPS one-click scripts
All scripts / telegram

telegram Telegram notification

Create a bot with @BotFather and have the token and chat id ready. Use --dry-run to confirm both are present, then send a test message. For a VPS test summary, use all --tg.

Alias of tg

Command
$ curl -fsSL xyz.sh/telegram | bash

At a glance

What it does
Create a bot with @BotFather and have the token and chat id ready. Use --dry-run to confirm both are present, then send a test message. For a VPS test summary, use all --tg.
Supported OS
Debian, Ubuntu, CentOS, Rocky, AlmaLinux · Root optional
Command
curl -fsSL xyz.sh/telegram | bash
What it changes
Sends a message with a Telegram bot token and chat id you provide, to verify the credentials.
How to undo it
Nothing is installed on the server. To stop notifications, disable or delete the bot in Telegram and remove the token from commands and environment variables.
Last verified
Aliases:telegram
SHA256:f206b6f715a277c8ba70104454d4166a00d7424a0769a89797fa854611767724 · Matches the script curl receives. You can also fetch /telegram.sh.sha256
Read the tutorial:Receive xyz.sh Test Notifications on Telegram

Every script passes bash -n and ShellCheck and was tested with curl | bash as root in the official Docker images of Debian 12/11, Ubuntu 24.04/22.04/20.04/18.04, Rocky 9, AlmaLinux 9 and CentOS 7 (see “Container test results” on each page). Containers lack systemd, kernel modules and real public routes, so those parts still need a real VPS.

What it does

Sends a message with a Telegram bot token and chat id you provide, to verify the credentials. Pass the token with --token or XYZ_TG_TOKEN / TELEGRAM_BOT_TOKEN; it is never written to logs. For a VPS test summary use xyz.sh/all --tg with the same token and chat id; it can include the share link. --dry-run makes no network request.

Supported OS

  • Debian
  • Ubuntu
  • CentOS
  • Rocky
  • AlmaLinux

Root optional

Flags and examples

$ curl -fsSL xyz.sh/tg | bash -s -- --token '<token>' --chat '<chat-id>' --dry-run
$ curl -fsSL xyz.sh/tg | bash -s -- --token '<token>' --chat '<chat-id>'
$ curl -fsSL xyz.sh/all | bash -s -- -y --share --tg --tg-token '<token>' --tg-chat '<chat-id>'

Container test results

Results of curl | bash as root without a terminal in each distribution's official Docker image. partial means the container could not verify everything (for example no systemd, no kernel module, or the test protocol blocked by the test environment's proxy) and a real VPS is needed to confirm. (2026-11-12)

OSResult
debian:12pass
debian:11pass
ubuntu:24.04pass
ubuntu:22.04pass
ubuntu:20.04pass
ubuntu:18.04pass
rockylinux:9pass
almalinux:9pass
centos:7pass

FAQ

Will the token appear in logs?
No. Error messages replace the token with <redacted>, and the bot URL is not printed. Still avoid leaving a token in shell history that might be recorded or pasted in public; XYZ_TG_TOKEN and XYZ_TG_CHAT are safer.
Do I need root?
No. It only sends a Telegram message.
How does this relate to all --tg?
tg is for checking that the bot can send a message on its own. For a VPS test, use curl -fsSL xyz.sh/all | bash -s -- -y --share --tg --tg-token '…' --tg-chat '…' to send the score, a short summary and the share link to the same chat.
Which operating systems are supported?
Any system with bash and curl is enough. Declared support: Debian, Ubuntu, CentOS, Rocky Linux and AlmaLinux.

Full source

This is exactly what curl receives (common library + script body). Read it before running.

xyz.sh/telegram.sh
#!/usr/bin/env bash
# Served by xyz.sh/telegram
# Human-readable page: https://xyz.sh/telegram
# This file is the common library followed by the script body.
# No telemetry is added by xyz.sh.
# =============================================================================
# xyz.sh common library
# Shared helpers for every script served by xyz.sh.
#
# Promises:
#   - No telemetry, analytics, or background "phone-home" calls
#   - No hidden installs or config changes beyond what the script announces
#   - Official upstream URLs are printed before any remote code is executed
#   - Destructive or system-changing steps ask for confirmation (or YES=1 / -y)
# =============================================================================

if [[ -n "${XYZ_COMMON_LOADED:-}" ]]; then
  # When sourced a second time, return. When executed as a file, return fails.
  # shellcheck disable=SC2317
  return 0 2>/dev/null || true
fi
# shellcheck disable=SC2034
XYZ_COMMON_LOADED=1

set -euo pipefail

XYZ_VERSION="1.5.0"
XYZ_BASE="${XYZ_BASE:-https://xyz.sh}"
XYZ_NAME="${XYZ_NAME:-unknown}"

# --- language ---------------------------------------------------------------
# Override with XYZ_LANG=zh or XYZ_LANG=en.
if [[ -z "${XYZ_LANG:-}" ]]; then
  case "${LC_ALL:-${LC_MESSAGES:-${LANG:-}}}" in
    zh*|ZH*|cmn*|CMN*) XYZ_LANG="zh" ;;
    *) XYZ_LANG="en" ;;
  esac
fi

xyz_t() {
  # xyz_t "English text" "中文文本"
  if [[ "${XYZ_LANG}" == "zh" ]]; then
    printf '%s' "${2:-$1}"
  else
    printf '%s' "$1"
  fi
}

# --- colors (TTY only) ------------------------------------------------------
# XYZ_COLOR=always|never|auto (default auto: TTY and no NO_COLOR); --no-color.
_xyz_color=0
case "${XYZ_COLOR:-auto}" in
  always) _xyz_color=1 ;;
  never) _xyz_color=0 ;;
  *) [[ -t 1 && -z "${NO_COLOR:-}" ]] && _xyz_color=1 ;;
esac
[[ "${XYZ_NO_COLOR:-0}" == "1" ]] && _xyz_color=0
if [[ "${_xyz_color}" == "1" ]]; then
  XYZ_C_RESET=$'\033[0m'
  XYZ_C_BOLD=$'\033[1m'
  XYZ_C_DIM=$'\033[2m'
  XYZ_C_RED=$'\033[31m'
  XYZ_C_GREEN=$'\033[32m'
  XYZ_C_YELLOW=$'\033[33m'
  XYZ_C_CYAN=$'\033[36m'
else
  XYZ_C_RESET=""
  XYZ_C_BOLD=""
  XYZ_C_DIM=""
  XYZ_C_RED=""
  XYZ_C_GREEN=""
  XYZ_C_YELLOW=""
  XYZ_C_CYAN=""
fi

xyz_info()  { printf '%s[INFO]%s %s\n'  "${XYZ_C_GREEN}"  "${XYZ_C_RESET}" "$*"; }
xyz_warn()  { printf '%s[WARN]%s %s\n'  "${XYZ_C_YELLOW}" "${XYZ_C_RESET}" "$*" >&2; }
xyz_error() { printf '%s[ERROR]%s %s\n' "${XYZ_C_RED}"    "${XYZ_C_RESET}" "$*" >&2; }
xyz_step()  { printf '%s==>%s %s\n'     "${XYZ_C_CYAN}"   "${XYZ_C_RESET}" "$*"; }

# --- args / init ------------------------------------------------------------
XYZ_ARGS=()
XYZ_YES=0
XYZ_DRY_RUN=0

xyz_parse_global_args() {
  local filtered=()
  local arg
  for arg in "$@"; do
    case "${arg}" in
      -y|--yes)
        XYZ_YES=1
        ;;
      --lang=zh|zh)
        XYZ_LANG="zh"
        ;;
      --lang=en|en)
        XYZ_LANG="en"
        ;;
      --dry-run)
        XYZ_DRY_RUN=1
        ;;
      --no-color)
        XYZ_NO_COLOR=1
        XYZ_C_RESET=""; XYZ_C_BOLD=""; XYZ_C_DIM=""; XYZ_C_RED=""
        XYZ_C_GREEN=""; XYZ_C_YELLOW=""; XYZ_C_CYAN=""
        ;;
      --help|-h)
        XYZ_HELP=1
        filtered+=("${arg}")
        ;;
      *)
        filtered+=("${arg}")
        ;;
    esac
  done
  XYZ_ARGS=("${filtered[@]+"${filtered[@]}"}")
  if [[ "${YES:-}" =~ ^(1|yes|true|YES)$ || "${XYZ_ASSUME_YES:-}" == "1" ]]; then
    XYZ_YES=1
  fi
  # Exported so individual scripts can read flags set here.
  export XYZ_ARGS XYZ_YES XYZ_LANG XYZ_HELP="${XYZ_HELP:-}" XYZ_DRY_RUN="${XYZ_DRY_RUN:-0}"
  export XYZ_NO_COLOR="${XYZ_NO_COLOR:-0}"
  if declare -F xyz_ui_init >/dev/null; then xyz_ui_init; fi
}

xyz_banner() {
  local title="${XYZ_TITLE:-$XYZ_NAME}"
  printf '\n%s%sxyz.sh/%s%s  v%s\n' "${XYZ_C_BOLD}" "${XYZ_C_CYAN}" "${XYZ_NAME}" "${XYZ_C_RESET}" "${XYZ_VERSION}"
  printf '%s\n' "${XYZ_C_DIM}----------------------------------------${XYZ_C_RESET}"
  printf '  %s: %s/%s\n' "$(xyz_t "Page" "页面")" "${XYZ_BASE}" "${XYZ_NAME}"
  printf '  %s: %s/%s.sh\n' "$(xyz_t "Raw" "源码")" "${XYZ_BASE}" "${XYZ_NAME}"
  if [[ -n "${XYZ_UPSTREAM:-}" ]]; then
    printf '  %s: %s\n' "$(xyz_t "Upstream" "上游来源")" "${XYZ_UPSTREAM}"
  fi
  printf '  %s\n' "$(xyz_t "No telemetry, no hidden actions." "无遥测、无隐藏操作。")"
  printf '%s\n\n' "${XYZ_C_DIM}----------------------------------------${XYZ_C_RESET}"
  if [[ -n "${title}" && "${title}" != "${XYZ_NAME}" ]]; then
    xyz_step "${title}"
  fi
}

xyz_init() {
  xyz_parse_global_args "$@"
  xyz_detect_os
  xyz_banner
}

# --- root / OS --------------------------------------------------------------
xyz_is_root() {
  [[ "${EUID:-$(id -u)}" -eq 0 ]]
}

xyz_require_root() {
  if ! xyz_is_root; then
    xyz_error "$(xyz_t \
      "This script must be run as root. Try: sudo bash" \
      "请使用 root 运行。可尝试:sudo bash")"
    exit 1
  fi
}

xyz_prefer_root() {
  if ! xyz_is_root; then
    xyz_warn "$(xyz_t \
      "Not running as root; some information or tests may be limited." \
      "当前不是 root,部分信息或测试可能不完整。")"
  fi
}

XYZ_OS_ID=""
XYZ_OS_LIKE=""
XYZ_OS_VERSION=""
XYZ_OS_FAMILY=""   # debian | rhel | unknown
XYZ_OS_PRETTY=""

xyz_detect_os() {
  XYZ_OS_ID=""
  XYZ_OS_LIKE=""
  XYZ_OS_VERSION=""
  XYZ_OS_FAMILY="unknown"
  XYZ_OS_PRETTY="unknown"
  if [[ -r /etc/os-release ]]; then
    # shellcheck disable=SC1091
    . /etc/os-release
    XYZ_OS_ID="${ID:-}"
    XYZ_OS_LIKE="${ID_LIKE:-}"
    XYZ_OS_VERSION="${VERSION_ID:-}"
    XYZ_OS_PRETTY="${PRETTY_NAME:-$XYZ_OS_ID}"
    export XYZ_OS_ID XYZ_OS_LIKE XYZ_OS_VERSION XYZ_OS_FAMILY XYZ_OS_PRETTY
  fi
  case "${XYZ_OS_ID}" in
    debian|ubuntu)
      XYZ_OS_FAMILY="debian"
      ;;
    centos|rhel|rocky|almalinux|alma|fedora)
      XYZ_OS_FAMILY="rhel"
      ;;
    *)
      case " ${XYZ_OS_ID} ${XYZ_OS_LIKE} " in
        *debian*|*ubuntu*) XYZ_OS_FAMILY="debian" ;;
        *rhel*|*centos*|*fedora*|*rocky*|*alma*) XYZ_OS_FAMILY="rhel" ;;
        *) : ;;
      esac
      ;;
  esac
}

xyz_os_supported() {
  case "${XYZ_OS_ID}" in
    debian|ubuntu|centos|rocky|almalinux) return 0 ;;
    *) : ;;
  esac
  case " ${XYZ_OS_LIKE} " in
    *debian*|*ubuntu*|*rhel*|*centos*|*rocky*|*alma*) return 0 ;;
    *) : ;;
  esac
  return 1
}

xyz_require_supported_os() {
  xyz_detect_os
  if ! xyz_os_supported; then
    xyz_warn "$(xyz_t \
      "Unrecognized distribution: ${XYZ_OS_ID:-unknown} (${XYZ_OS_PRETTY}). Officially supported: Debian, Ubuntu, CentOS, Rocky, AlmaLinux." \
      "未能识别的发行版:${XYZ_OS_ID:-unknown}(${XYZ_OS_PRETTY})。官方支持:Debian、Ubuntu、CentOS、Rocky、AlmaLinux。")"
    if ! xyz_confirm "$(xyz_t "Continue anyway?" "仍然继续?")"; then
      exit 1
    fi
  else
    xyz_info "$(xyz_t "Detected OS:" "检测到系统:") ${XYZ_OS_PRETTY} (${XYZ_OS_FAMILY})"
  fi
}

# --- packages / commands ----------------------------------------------------
xyz_need_cmd() {
  command -v "$1" >/dev/null 2>&1
}

xyz_pkg_install() {
  xyz_detect_os
  if (( $# == 0 )); then
    return 0
  fi
  case "${XYZ_OS_FAMILY}" in
    debian)
      export DEBIAN_FRONTEND=noninteractive
      apt-get update -y || xyz_warn "$(xyz_t "apt-get update reported errors (a repository may be unreachable); trying to install anyway." "apt-get update 报错(可能有软件源无法访问),仍尝试安装。")"
      apt-get install -y --no-install-recommends "$@"
      ;;
    rhel)
      if xyz_need_cmd dnf; then
        dnf install -y "$@"
      elif xyz_need_cmd yum; then
        yum install -y "$@"
      else
        xyz_error "$(xyz_t "Neither dnf nor yum is available." "找不到 dnf 或 yum。")"
        exit 1
      fi
      ;;
    *)
      xyz_error "$(xyz_t "Cannot install packages on this OS automatically." "无法在此系统上自动安装软件包。")"
      exit 1
      ;;
  esac
}

xyz_ensure_cmds() {
  local pkg
  local missing=()
  for pkg in "$@"; do
    if ! xyz_need_cmd "${pkg}"; then
      missing+=("${pkg}")
    fi
  done
  if ((${#missing[@]} > 0)); then
    xyz_info "$(xyz_t "Installing missing commands:" "正在安装缺失命令:") ${missing[*]}"
    xyz_pkg_install "${missing[@]}"
  fi
}

# --- confirmation (safe with curl | bash) -----------------------------------
# A readable /dev/tty node is not enough: in containers or curl|bash without a
# controlling terminal, open() fails with ENXIO ("No such device or address").
# [[ -r /dev/tty ]] is true in that case and must not be used as the check.
xyz_open_tty() {
  # Opens /dev/tty into XYZ_TTY_FD if it is a real terminal. Caller must close.
  local fd
  XYZ_TTY_FD=""
  # Brace group so a failed open cannot leak "No such device or address".
  if { exec {fd}<>/dev/tty; } 2>/dev/null && [[ -t "${fd}" ]]; then
    XYZ_TTY_FD="${fd}"
    return 0
  fi
  if [[ -n "${fd:-}" ]]; then
    exec {fd}>&- 2>/dev/null || true
  fi
  return 1
}

xyz_close_tty() {
  if [[ -n "${XYZ_TTY_FD:-}" ]]; then
    exec {XYZ_TTY_FD}>&- 2>/dev/null || true
    XYZ_TTY_FD=""
  fi
}

xyz_confirm() {
  local prompt="$1"
  if [[ "${XYZ_YES}" == "1" ]]; then
    xyz_info "$(xyz_t "Auto-confirmed (-y / YES=1):" "已自动确认(-y / YES=1):") ${prompt}"
    return 0
  fi
  local reply=""
  if xyz_open_tty; then
    printf '%s [y/N] ' "${prompt}" >&"${XYZ_TTY_FD}"
    # shellcheck disable=SC2162
    read -r reply <&"${XYZ_TTY_FD}" || true
    xyz_close_tty
  else
    xyz_warn "$(xyz_t \
      "No TTY available for confirmation. Re-run with -y or YES=1 if you accept." \
      "没有可用的终端来确认。若你已了解并同意,请加 -y 或 YES=1 重试。")"
    return 1
  fi
  case "${reply}" in
    y|Y|yes|YES|Yes) return 0 ;;
    *) return 1 ;;
  esac
}

# --- download helpers -------------------------------------------------------
# Create the temp dir in the main shell. xyz_tmpdir is usually called inside
# $(...), a subshell, so creating it (and its EXIT trap) there would delete the
# directory as soon as the subshell returned.
xyz_init_tmpdir() {
  if [[ -z "${XYZ_TMPDIR:-}" || ! -d "${XYZ_TMPDIR}" ]]; then
    XYZ_TMPDIR="$(mktemp -d "${TMPDIR:-/tmp}/xyzsh.XXXXXX")"
    # shellcheck disable=SC2064
    trap "rm -rf '${XYZ_TMPDIR}'" EXIT
  fi
}

xyz_tmpdir() {
  if [[ -z "${XYZ_TMPDIR:-}" || ! -d "${XYZ_TMPDIR}" ]]; then
    xyz_error "internal: temp dir not initialised"
    exit 1
  fi
  printf '%s' "${XYZ_TMPDIR}"
}

xyz_fetch() {
  # xyz_fetch URL DEST
  local url="$1"
  local dest="$2"
  xyz_info "$(xyz_t "Downloading" "正在下载"): ${url}"
  xyz_info "$(xyz_t "Saving to" "保存到"): ${dest}"
  if xyz_need_cmd curl; then
    curl -fsSL --connect-timeout 20 --max-time 180 --retry 2 --retry-delay 1 \
      -o "${dest}" "${url}"
  elif xyz_need_cmd wget; then
    wget -q --timeout=60 -O "${dest}" "${url}"
  else
    xyz_error "$(xyz_t "Need curl or wget to download files." "需要 curl 或 wget 才能下载文件。")"
    exit 1
  fi
  if [[ ! -s "${dest}" ]]; then
    xyz_error "$(xyz_t "Download failed or file is empty:" "下载失败或文件为空:") ${url}"
    exit 1
  fi
  if xyz_need_cmd sha256sum; then
    xyz_info "SHA256: $(sha256sum "${dest}" | awk '{print $1}')"
  elif xyz_need_cmd shasum; then
    xyz_info "SHA256: $(shasum -a 256 "${dest}" | awk '{print $1}')"
  fi
}

xyz_run_upstream() {
  # xyz_run_upstream URL [args...]
  # Downloads an official installer, shows the URL and a short preview, then
  # runs it only after confirmation (unless -y / YES=1).
  local url="$1"
  shift
  local dest
  xyz_init_tmpdir
  dest="$(xyz_tmpdir)/upstream.sh"
  xyz_fetch "${url}" "${dest}"
  chmod +x "${dest}"
  xyz_info "$(xyz_t "Preview (first 20 lines):" "预览(前 20 行):")"
  sed -n '1,20p' "${dest}" || true
  printf '%s\n' "${XYZ_C_DIM}...${XYZ_C_RESET}"
  # Default --dry-run: verify the download and preview, do not execute.
  # Scripts that forward --dry-run to upstream (e.g. docker) set
  # XYZ_FORWARD_DRY_RUN=1 so the official script still runs with that flag.
  if [[ "${XYZ_DRY_RUN:-0}" == "1" && "${XYZ_FORWARD_DRY_RUN:-0}" != "1" ]]; then
    xyz_info "$(xyz_t \
      "Dry-run: official script downloaded and previewed; not executing it." \
      "演练模式:已下载并预览官方脚本,不会执行。")"
    return 0
  fi
  if ! xyz_confirm "$(xyz_t \
    "Run this official upstream script?" \
    "运行这份官方上游脚本?")"; then
    xyz_error "$(xyz_t "Aborted by user." "已取消。")"
    exit 1
  fi
  xyz_step "$(xyz_t "Executing upstream script" "正在执行上游脚本")"
  # Never let the upstream script inherit our stdin: under `curl | bash` that
  # is the rest of this very script. Give it the terminal if there is one,
  # otherwise /dev/null. Interactive installers set XYZ_UPSTREAM_NEEDS_TTY=1.
  if xyz_open_tty; then
    local tty_fd="${XYZ_TTY_FD}"
    XYZ_TTY_FD=""
    bash "${dest}" "$@" <&"${tty_fd}"
    local rc=$?
    exec {tty_fd}>&- 2>/dev/null || true
    return "${rc}"
  fi
  if [[ "${XYZ_UPSTREAM_NEEDS_TTY:-0}" == "1" ]]; then
    xyz_error "$(xyz_t \
      "This official installer is interactive and needs a terminal. Log in with SSH and run: bash <(curl -fsSL ${XYZ_BASE}/${XYZ_NAME})" \
      "这个官方安装脚本需要交互,必须在终端里运行。请用 SSH 登录后执行:bash <(curl -fsSL ${XYZ_BASE}/${XYZ_NAME})")"
    exit 1
  fi
  bash "${dest}" "$@" </dev/null
}

# --- small shared helpers ----------------------------------------------------
xyz_strip_ansi() {
  sed -e 's/\x1b\[[0-9;?]*[A-Za-z]//g' -e 's/\r//g'
}

# Effective SSH port: sshd -T (what sshd really uses) > config files > env > 22.
xyz_effective_ssh_port() {
  local port=""
  if xyz_need_cmd sshd; then
    port="$(sshd -T 2>/dev/null | awk '$1=="port" {print $2; exit}' || true)"
  fi
  if [[ -z "${port}" && -d /etc/ssh/sshd_config.d ]]; then
    port="$(cat /etc/ssh/sshd_config.d/*.conf 2>/dev/null | awk 'tolower($1)=="port" {print $2; exit}' || true)"
  fi
  if [[ -z "${port}" && -f /etc/ssh/sshd_config ]]; then
    port="$(awk 'tolower($1)=="port" {print $2; exit}' /etc/ssh/sshd_config || true)"
  fi
  if [[ -z "${port}" && -n "${SSH_CONNECTION:-}" ]]; then
    port="$(printf '%s' "${SSH_CONNECTION}" | awk '{print $4}')"
  fi
  printf '%s' "${port:-22}"
}

xyz_has_systemd() {
  [[ -d /run/systemd/system ]] && xyz_need_cmd systemctl
}

# Back up a file once per run as FILE.xyz-bak-YYYYmmddHHMMSS and print the path.
xyz_backup_file() {
  local f="$1"
  local bak
  bak="${f}.xyz-bak-$(date +%Y%m%d%H%M%S)"
  if [[ -e "${f}" ]]; then
    cp -a "${f}" "${bak}"
    printf '%s' "${bak}"
  fi
}

# --- misc -------------------------------------------------------------------
xyz_usage_exit() {
  if [[ "${1:-}" != "" ]]; then
    printf '%s\n' "$1"
  fi
  exit 0
}

# xyz.sh Telegram helper. Never prints the bot token.
# shellcheck disable=SC2034
XYZ_TG_LOADED=1

xyz_tg_redact() {
  # xyz_tg_redact TOKEN TEXT -> TEXT with token (and bot URL) replaced
  local token="$1" text="$2"
  [[ -z "${token}" ]] && { printf '%s' "${text}"; return 0; }
  text="${text//${token}/<redacted>}"
  text="${text//bot${token}/bot<redacted>}"
  printf '%s' "${text}"
}

xyz_tg_send() {
  # xyz_tg_send TOKEN CHAT_ID TEXT
  # Returns 0 on success. Errors are printed with the token redacted.
  local token="$1" chat="$2" text="$3" api resp rc
  if [[ -z "${token}" || -z "${chat}" ]]; then
    xyz_error "$(xyz_t "Telegram: missing bot token or chat id." "Telegram:缺少 bot token 或 chat id。")"
    return 1
  fi
  if ! xyz_need_cmd curl; then
    xyz_error "$(xyz_t "Telegram: curl is required to send a message." "Telegram:发送消息需要 curl。")"
    return 1
  fi
  api="https://api.telegram.org/bot${token}/sendMessage"
  resp="$(curl -fsS --connect-timeout 10 --max-time 20 -X POST \
    --data-urlencode "chat_id=${chat}" \
    --data-urlencode "text=${text}" \
    --data-urlencode "disable_web_page_preview=true" \
    "${api}" 2>&1)" && rc=0 || rc=$?
  if [[ "${rc}" -ne 0 ]]; then
    xyz_error "$(xyz_t "Telegram send failed:" "Telegram 发送失败:") $(xyz_tg_redact "${token}" "${resp}")"
    return 1
  fi
  if ! printf '%s' "${resp}" | grep -q '"ok":true'; then
    xyz_error "$(xyz_t "Telegram API rejected the message:" "Telegram 接口拒绝了这条消息:") $(xyz_tg_redact "${token}" "${resp}")"
    return 1
  fi
  xyz_info "$(xyz_t "Telegram notification sent." "已发送 Telegram 通知。")"
  return 0
}

XYZ_NAME="telegram"

# xyz.sh/tg — send a short Telegram message with a user-provided bot
# token and chat id. Also used to verify the credentials that xyz.sh/all
# --tg will use. The token is never printed or written to logs.
#
# Usage:
#   curl -fsSL xyz.sh/tg | bash -s -- --token '<bot-token>' --chat '<chat-id>' --dry-run
#   curl -fsSL xyz.sh/tg | bash -s -- --token '<bot-token>' --chat '<chat-id>' --text 'hello'
#   XYZ_TG_TOKEN=... XYZ_TG_CHAT=... curl -fsSL xyz.sh/tg | bash -s -- --text 'hello'
#
# Root is not required. No telemetry.

set -euo pipefail

if [[ -z "${XYZ_COMMON_LOADED:-}" ]]; then
  _xyz_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
  if [[ -f "${_xyz_dir}/lib/common.sh" ]]; then
    # shellcheck source=lib/common.sh
    source "${_xyz_dir}/lib/common.sh"
  else
    echo "xyz.sh: missing lib/common.sh" >&2
    exit 1
  fi
fi

if [[ -z "${XYZ_TG_LOADED:-}" ]]; then
  _xyz_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
  if [[ -f "${_xyz_dir}/lib/telegram.sh" ]]; then
    # shellcheck source=lib/telegram.sh
    source "${_xyz_dir}/lib/telegram.sh"
  fi
fi

XYZ_NAME="${XYZ_NAME:-tg}"
XYZ_TITLE="$(xyz_t "Telegram notification" "Telegram 通知")"
xyz_init "$@"

TG_TOKEN="${XYZ_TG_TOKEN:-${TELEGRAM_BOT_TOKEN:-}}"
TG_CHAT="${XYZ_TG_CHAT:-${TELEGRAM_CHAT_ID:-}}"
TG_TEXT=""
i=0
while [[ ${i} -lt ${#XYZ_ARGS[@]} ]]; do
  arg="${XYZ_ARGS[i]}"
  case "${arg}" in
    --help|-h) XYZ_HELP=1 ;;
    --token|--tg-token)
      i=$((i + 1))
      TG_TOKEN="${XYZ_ARGS[i]:-}"
      ;;
    --token=*|--tg-token=*)
      TG_TOKEN="${arg#*=}"
      ;;
    --chat|--tg-chat|--chat-id)
      i=$((i + 1))
      TG_CHAT="${XYZ_ARGS[i]:-}"
      ;;
    --chat=*|--tg-chat=*|--chat-id=*)
      TG_CHAT="${arg#*=}"
      ;;
    --text|--message)
      i=$((i + 1))
      TG_TEXT="${XYZ_ARGS[i]:-}"
      ;;
    --text=*|--message=*)
      TG_TEXT="${arg#*=}"
      ;;
    *)
      xyz_error "$(xyz_t "Unknown argument (token values are not repeated here)." "未知参数(此处不会回显 token)。") "
      exit 1
      ;;
  esac
  i=$((i + 1))
done

if [[ "${XYZ_HELP:-}" == "1" ]]; then
  cat <<HINT
$(xyz_t "Usage:" "用法:")
  curl -fsSL xyz.sh/tg | bash -s -- --token '<bot-token>' --chat '<chat-id>' --dry-run
  curl -fsSL xyz.sh/tg | bash -s -- --token '<bot-token>' --chat '<chat-id>' --text 'hello from xyz.sh'
  XYZ_TG_TOKEN=... XYZ_TG_CHAT=... curl -fsSL xyz.sh/tg | bash -s -- --text 'hello'

$(xyz_t "Environment alternatives: XYZ_TG_TOKEN / TELEGRAM_BOT_TOKEN and XYZ_TG_CHAT / TELEGRAM_CHAT_ID." "也可用环境变量:XYZ_TG_TOKEN / TELEGRAM_BOT_TOKEN 与 XYZ_TG_CHAT / TELEGRAM_CHAT_ID。")
$(xyz_t "The bot token is never printed. --dry-run checks that token and chat id are present and does not call Telegram." "bot token 绝不会被打印。--dry-run 只检查 token 与 chat id 是否已提供,不会请求 Telegram。")
$(xyz_t "For a VPS test report, prefer: curl -fsSL xyz.sh/all | bash -s -- -y --share --tg --tg-token '...' --tg-chat '...'" "若要在综合测试结束后发通知,请用:curl -fsSL xyz.sh/all | bash -s -- -y --share --tg --tg-token '...' --tg-chat '...'")
HINT
  exit 0
fi

# Do not print whether the token looks like a token (avoids leaking prefixes).
if [[ -z "${TG_TOKEN}" || -z "${TG_CHAT}" ]]; then
  xyz_error "$(xyz_t "Missing bot token or chat id. Pass --token and --chat, or set XYZ_TG_TOKEN and XYZ_TG_CHAT." "缺少 bot token 或 chat id。请传入 --token 和 --chat,或设置 XYZ_TG_TOKEN 与 XYZ_TG_CHAT。")"
  exit 1
fi

if [[ "${XYZ_DRY_RUN:-0}" == "1" ]]; then
  xyz_info "$(xyz_t "Dry-run: token and chat id are present; no Telegram request will be sent." "演练模式:已提供 token 与 chat id,不会向 Telegram 发送请求。")"
  if [[ -n "${TG_TEXT}" ]]; then
    xyz_info "$(xyz_t "Would send a message of" "将发送一条消息,长度为") ${#TG_TEXT} $(xyz_t "characters." "个字符。")"
  else
    xyz_info "$(xyz_t "Would send a short default test message." "将发送一条默认的简短测试消息。")"
  fi
  exit 0
fi

if [[ -z "${TG_TEXT}" ]]; then
  TG_TEXT="$(xyz_t "Test message from xyz.sh/tg. If you can read this, the bot token and chat id work. Use xyz.sh/all --tg to notify when a VPS test finishes." "这是来自 xyz.sh/tg 的测试消息。若你能看到它,说明 bot token 与 chat id 可用。综合测试结束时可用 xyz.sh/all --tg 发送通知。")"
fi

xyz_tg_send "${TG_TOKEN}" "${TG_CHAT}" "${TG_TEXT}"

Recommended VPS

These slots are placeholders. No vendor or affiliate link has been added, and nothing here is a purchase button. Real plans and compliant referral links will be filled in later.

Recommended plans coming later

No live merchant or affiliate links have been added yet, so empty purchase slots are hidden. Real plans will appear here with a visible affiliate disclosure.

Promo codes · youhuima.cc — Promo codes may also be listed on youhuima.cc; the merchant’s rules apply.