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
$ 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
telegramf206b6f715a277c8ba70104454d4166a00d7424a0769a89797fa854611767724
· Matches the script curl receives. You can also fetch /telegram.sh.sha256
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.
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)
| OS | Result |
|---|---|
| debian:12 | pass |
| debian:11 | pass |
| ubuntu:24.04 | pass |
| ubuntu:22.04 | pass |
| ubuntu:20.04 | pass |
| ubuntu:18.04 | pass |
| rockylinux:9 | pass |
| almalinux:9 | pass |
| centos:7 | pass |
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.
#!/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.