telegram Telegram 通知
先向 @BotFather 申请 bot,并把 token 和 chat id 准备好。用 --dry-run 确认已提供这两项,再发一条测试消息。综合测试请用 all --tg。
别名 tg
$ curl -fsSL xyz.sh/telegram | bash
一览
- 做什么
- 先向 @BotFather 申请 bot,并把 token 和 chat id 准备好。用 --dry-run 确认已提供这两项,再发一条测试消息。综合测试请用 all --tg。
- 支持的系统
- Debian, Ubuntu, CentOS, Rocky, AlmaLinux · root 可选
- 命令
curl -fsSL xyz.sh/telegram | bash- 会改动什么
- 使用你提供的 Telegram bot token 和 chat id 发送一条消息,用来验证凭证。token 可通过 --token 或环境变量 XYZ_TG_TOKEN / TELEGRAM_BOT_TOKEN 传入,脚本不会把它写进日志。综合测试请用 xyz.sh/all --tg(同样需要 token 与 chat id),结束时发送分数、摘要和可选的分享链接。--dry-run 不发起网络请求。
- 如何还原
- 本脚本不在服务器上安装任何服务。若不再需要通知,在 Telegram 里停用或删除该 bot 即可,并在命令和环境变量中去掉 token。
- 上次核实
telegramf206b6f715a277c8ba70104454d4166a00d7424a0769a89797fa854611767724
· 与 curl 拿到的脚本一致,也可访问 /telegram.sh.sha256
所有脚本都通过 bash -n 与 ShellCheck 检查,并在 Debian 12/11、Ubuntu 24.04/22.04/20.04/18.04、Rocky 9、AlmaLinux 9、CentOS 7 的官方 Docker 镜像中以 root 运行 curl | bash 测试(结果见各页“容器测试结果”)。容器里没有 systemd、内核模块和真实公网线路,相关部分需要在真实 VPS 上确认。
它会做什么
使用你提供的 Telegram bot token 和 chat id 发送一条消息,用来验证凭证。token 可通过 --token 或环境变量 XYZ_TG_TOKEN / TELEGRAM_BOT_TOKEN 传入,脚本不会把它写进日志。综合测试请用 xyz.sh/all --tg(同样需要 token 与 chat id),结束时发送分数、摘要和可选的分享链接。--dry-run 不发起网络请求。
容器测试结果
在各发行版官方 Docker 镜像中以 root、无终端方式运行 curl | bash 的结果。partial 表示容器内无法完整验证(例如没有 systemd、内核模块或测速协议被测试环境的代理拦截),需要在真实 VPS 上确认。 (2026-11-12)
| OS | 结果 |
|---|---|
| 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 |
常见问题
- token 会出现在日志里吗?
- 不会。脚本在错误信息里也会把 token 替换成 <redacted>,不会打印 bot URL。请避免在可被录屏或贴到公共场所的命令历史里留下 token;更稳妥的方式是用环境变量 XYZ_TG_TOKEN 与 XYZ_TG_CHAT。
- 需要 root 吗?
- 不需要。它只是向 Telegram 发送一条消息。
- 和 all --tg 有什么关系?
- tg 用来单独验证 bot 是否能发消息。综合测试请用 curl -fsSL xyz.sh/all | bash -s -- -y --share --tg --tg-token '…' --tg-chat '…',结束时会把分数、摘要和分享链接发到同一个 chat。
- 支持哪些系统?
- 只要能运行 bash 和 curl 即可,声明支持 Debian、Ubuntu、CentOS、Rocky、AlmaLinux。
完整源码
以下就是 curl 实际拿到的内容(公共库 + 脚本正文)。运行前请先读一遍。
#!/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}"
推荐 VPS
以下为占位展示,尚未接入任何商家或联盟链接,也没有可点击的购买地址。上线推广前会再填入真实套餐与合规的返佣链接。
推荐套餐即将接入
目前还没有已上线的商家或联盟链接,因此不展示空的购买入口。接入真实套餐后会显示在这里,链接会标明「推广链接」。
查优惠码 · youhuima.cc — 优惠码也可在 youhuima.cc 查找,是否可用以商家规则为准。