HestiaCP एडमिनर स्क्रिप्ट (जिसमें Nginx प्रमाणीकरण + Fail2Ban दोहरी सुरक्षा शामिल है) की एक-क्लिक स्वचालित तैनाती प्रदान करता है।

एडमिनर को मैन्युअल रूप से इंस्टॉल करना बंद करें! एक स्क्रिप्ट संपूर्ण सुरक्षा कॉन्फ़िगरेशन को संभाल सकती है।

कुछ दिन पहले, सिस्टम एडमिनिस्ट्रेशन में काम करने वाले मेरे एक दोस्त ने मुझसे शिकायत की कि उसे अपने सर्वर पर एडमिनर इंस्टॉल करने में पूरा दिन लग जाता है। एडमिनर को इंस्टॉल करना मुश्किल नहीं है; यह तो बस एक PHP फ़ाइल है, आप इसे बस इंस्टॉल कर देते हैं और यह काम करने लगता है। लेकिन समस्या यह है कि आप बस एक PHP फ़ाइल इंस्टॉल करके काम खत्म नहीं कर सकते।

आपको सबडोमेन कॉन्फ़िगर करने, प्लगइन लोड करने, Nginx प्रमाणीकरण सेट अप करने और ब्रूट-फोर्स हमलों से बचाव के लिए Fail2Ban को कॉन्फ़िगर करने की आवश्यकता है । प्रत्येक चरण जटिल नहीं है, लेकिन ये सभी मिलकर कई खंडित कमांड और कॉन्फ़िगरेशन फ़ाइलें बनाते हैं।

इससे भी ज्यादा परेशान करने वाली बात यह है कि प्रमाणीकरण और फ़ायरवॉल जैसी सुरक्षा संबंधी कॉन्फ़िगरेशन में त्रुटियां होने की संभावना बहुत अधिक होती है। एक छोटी सी चूक से डेटाबेस प्रबंधन इंटरफ़ेस सार्वजनिक इंटरनेट पर उजागर हो सकता है, जिससे यह किसी के भी लिए सुलभ हो जाता है।

उस समय तो मुझे हंसी आ गई क्योंकि मैं भी पहले यही कर रहा था। बाद में, मुझसे यह और बर्दाश्त नहीं हुआ, इसलिए मैंने इन सभी चरणों को स्वचालित करने के लिए एक क्लिक-आधारित डिप्लॉयमेंट स्क्रिप्ट लिखी।

क्यों न उपयोग करेंphpMyAdmin

आप पूछ सकते हैं, अधिक प्रचलित phpMyAdmin का उपयोग क्यों नहीं किया जाए?

बेशक, phpMyAdmin के उपयोगकर्ता अधिक हैं और इसका समुदाय भी बड़ा है। लेकिन मुझे लगता है कि Adminer कुछ मामलों में बेहतर काम करता है।

पहली बात, यह हल्का है; Adminer सिर्फ एक PHP फ़ाइल है, जबकि phpMyAdmin कई सारी फ़ाइलों से मिलकर बना है। दूसरी बात, यह सुरक्षित है; Adminer की डिज़ाइन फिलॉसफी "डिफ़ॉल्ट रूप से अविश्वसनीय" है, जिसका अर्थ है कि डेटाबेस को चलाने के लिए आपको कनेक्शन संबंधी जानकारी स्पष्ट रूप से कॉन्फ़िगर करनी होगी।

एक और पहलू है प्रदर्शन; बड़े डेटाबेस को संभालने के मामले में एडमिनर, phpMyAdmin की तुलना में काफी तेज है।

बेशक, इनमें से कोई भी सबसे महत्वपूर्ण बात नहीं है। सबसे महत्वपूर्ण बात यह है कि इस स्क्रिप्ट की वजह से मुझे अब सुरक्षा संबंधी चीजों को मैन्युअल रूप से कॉन्फ़िगर करने की आवश्यकता नहीं है।

स्क्रिप्ट ने वास्तव में क्या किया?

इस स्क्रिप्ट के पीछे का विचार वास्तव में काफी सरल है: उन सभी चरणों को स्वचालित करना जिन्हें आप सामान्यतः मैन्युअल रूप से करते हैं।

इंटरैक्टिव इनपुट के लिए, स्क्रिप्ट आपसे कुछ प्रश्न पूछेगी: हेस्टियासीपी उपयोगकर्ता नाम, डोमेन नाम, प्रमाणीकरण उपयोगकर्ता नाम और पासवर्ड। आपको केवल ये दर्ज करने होंगे, बाकी का काम स्क्रिप्ट खुद कर लेगी।

यह स्क्रिप्ट स्वचालित रूप से वेब रूट डायरेक्टरी बनाती है, यह जांचती है कि apache2-utils (पासवर्ड फाइल बनाने के लिए उपयोग किया जाता है) और PHP वातावरण स्थापित हैं या नहीं, और डायरेक्टरी निर्माण और निर्भरता स्थापना को संभालती है।

Adminer डाउनलोड करते समय, स्क्रिप्ट सबसे पहले आधिकारिक रिपॉजिटरी से नवीनतम संस्करण डाउनलोड करने का प्रयास करती है। यदि आधिकारिक रिपॉजिटरी उपलब्ध नहीं है, तो यह स्वचालित रूप से GitHub Releases की स्थिर रिपॉजिटरी पर स्विच हो जाती है। मुझे लगता है कि यह काफी महत्वपूर्ण है, क्योंकि आधिकारिक रिपॉजिटरी कभी-कभी अस्थिर हो सकती है; मुझे पहले भी कनेक्शन टाइमआउट की समस्या का सामना करना पड़ा है।

प्लगइन डाउनलोड के संबंध में, स्क्रिप्ट तीन मुख्य प्लगइन डाउनलोड करेगी: plugin.php प्लगइन लोडर है, fc-sqlite-connection-without-credentials.php का उपयोग पासवर्ड रहित कनेक्शन को संभालने के लिए किया जाता है, और login-password-less.php पासवर्ड हैश लॉगिन का समर्थन करता है।

पासवर्ड हैश जनरेशन और index.php के संबंध में, एक छोटी सी बात ध्यान देने योग्य है: स्क्रिप्ट पासवर्ड प्राप्त करने के लिए सीधे $_ENV का उपयोग करने के बजाय getenv() का उपयोग करती है। इससे php.ini कॉन्फ़िगरेशन की उस समस्या से बचा जा सकता है जिसके कारण हैश गणना खाली रह जाती है। मुझे स्वयं इस समस्या का सामना करना पड़ा और यह पता लगाने में काफी समय लगा कि php.ini में 'E' स्कोप सक्षम नहीं था।

Nginx प्रमाणीकरण को कॉन्फ़िगर करने के लिए, स्क्रिप्ट Nginx की मुख्य कॉन्फ़िगरेशन फ़ाइल को सीधे संशोधित करने के बजाय HestiaCP के नेटिव इंक्लूड मैकेनिज़्म का उपयोग करती है। इस दृष्टिकोण का लाभ यह है कि डोमेन कॉन्फ़िगरेशन को दोबारा बनाने पर भी प्रमाणीकरण विफल नहीं होगा।

Fail2Ban कॉन्फ़िगरेशन में, स्क्रिप्ट 401 त्रुटियों की निगरानी के लिए एक फ़िल्टरिंग नियम बनाती है। यदि कोई IP 10 मिनट के भीतर 3 बार लॉग इन करने में विफल रहता है, तो उसे 1 घंटे के लिए ब्लॉक कर दिया जाएगा।

अनुमतियों की मरम्मत और सेवा रीलोडिंग के संबंध में, स्क्रिप्ट स्वचालित रूप से सही फ़ाइल अनुमतियाँ सेट करेगी और PHP-FPM, Nginx और Fail2Ban को रीलोड करेगी।

मैं सुरक्षा को लेकर गंभीर हूं।

सच कहूं तो, डेटाबेस प्रबंधन उपकरणों की सुरक्षा ही वह चीज है जिसकी मुझे सबसे ज्यादा परवाह है।

ज़रा सोचिए, एडमिन आपके सर्वर पर मौजूद सभी डेटाबेस को सीधे नियंत्रित कर सकता है। अगर यह सार्वजनिक इंटरनेट पर उपलब्ध है और कोई इसे स्कैन कर लेता है, तो इसके परिणाम अकल्पनीय होंगे।

इस स्क्रिप्ट में तिहरी सुरक्षा है।

पहली परत Nginx की HTTP बेसिक ऑथेंटिकेशन है। जब आप Adminer खोलते हैं, तो आपके ब्राउज़र में एक डायलॉग बॉक्स खुलेगा जिसमें आपसे अपना यूज़रनेम और पासवर्ड डालने के लिए कहा जाएगा। सही जानकारी डालने के बाद ही आप Adminer का लॉगिन पेज देख पाएंगे।

दूसरी परत एडमिन के अपने पासवर्ड हैश लॉगिन की है। मैंने index.php में पासवर्ड हैशिंग कॉन्फ़िगर की है, इसलिए अगर कोई Nginx प्रमाणीकरण को बायपास भी कर लेता है, तो भी उसे एडमिन का लॉगिन पासवर्ड पता नहीं चलेगा।

तीसरी परत Fail2Ban की ब्रूट-फोर्स सुरक्षा है। यदि कोई आपके पासवर्ड को ब्रूट-फोर्स करने का प्रयास करता है, तो Fail2Ban स्वचालित रूप से उनके आईपी पते को ब्लॉक कर देगा।

सुरक्षा की इन तीनों परतों के संयोजन से, आप निश्चिंत होकर सार्वजनिक इंटरनेट पर एडमिनिस्ट्रेटर की भूमिका निभा सकते हैं।

एक क्लिक में काम हो जाता है, सचमुच एक क्लिक में।

तैनाती की प्रक्रिया बेहद सरल है।

#!/bin/bash
# ==============================================================================
# Adminer + 插件 + Nginx Auth + Fail2Ban 一键自动化部署脚本 (HestiaCP 完美版)
# ==============================================================================

set -e

# 必须以 root 权限运行
if [ "$EUID" -ne 0 ]; then
echo "❌ 错误：请使用 root 或 sudo 运行此脚本！"
exit 1
fi

# ------------------------------------------------------------------------------
# 1. 交互式输入配置参数
# ------------------------------------------------------------------------------
read -p "请输入 HestiaCP 用户名 [默认: admin]: " HESTIA_USER
HESTIA_USER=${HESTIA_USER:-admin}

read -p "请输入 Adminer 部署域名 [例如: adminer.example.com]: " DOMAIN
if [ -z "$DOMAIN" ]; then
echo "❌ 错误：域名不能为空！"
exit 1
fi

read -p "请输入 Nginx 网页认证用户名 [默认: adminuser]: " AUTH_USER
AUTH_USER=${AUTH_USER:-adminuser}

read -sp "请输入防护密码 (用于 Nginx 认证与 Adminer 登录): " AUTH_PASS
echo ""
if [ -z "$AUTH_PASS" ]; then
echo "❌ 错误：密码不能为空！"
exit 1
fi

# 核心路径变量定义
WEBROOT="/home/$HESTIA_USER/web/$DOMAIN/public_html"
ADMINER_FILE="$WEBROOT/adminer.php"
PLUGIN_DIR="$WEBROOT/plugins"
HTPASSWD_FILE="/etc/nginx/.htpasswd-$DOMAIN"

echo -e "\n🚀 开始部署 Adminer 到域名: $DOMAIN ..."

# ------------------------------------------------------------------------------
# 2. 创建目录与安装基础依赖
# ------------------------------------------------------------------------------
if [ ! -d "$WEBROOT" ]; then
echo "📁 创建 Web 根目录: $WEBROOT"
mkdir -p "$WEBROOT"
fi
mkdir -p "$PLUGIN_DIR"

echo "🔍 检查基础依赖环境..."
if ! command -v htpasswd >/dev/null 2>&1; then
echo "📦 安装 apache2-utils 工具包..."
apt-get update -qq && apt-get install -y -qq apache2-utils
fi

if ! command -v php >/dev/null 2>&1; then
echo "❌ 错误：未检测到系统的 PHP 环境！"
exit 1
fi

# ------------------------------------------------------------------------------
# 3. 安全下载 Adminer 核心程序
# ------------------------------------------------------------------------------
echo "📥 正在下载最新版 Adminer..."
curl -sL -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)" \
-o "$ADMINER_FILE" "https://www.adminer.org/latest.php"

# 校验下载有效性
if ! grep -q "<?php" "$ADMINER_FILE"; then
echo "⚠️ 官方源连接异常，正在切换至 GitHub Releases 稳定源..."
curl -sL -o "$ADMINER_FILE" \
"https://github.com/vrana/adminer/releases/download/v4.8.1/adminer-4.8.1.php"
fi

# ------------------------------------------------------------------------------
# 4. 下载官方核心插件与加载器
# ------------------------------------------------------------------------------
echo "🧩 正在下载插件组件..."
curl -sL -o "$PLUGIN_DIR/plugin.php" \
https://raw.githubusercontent.com/vrana/adminer/master/plugins/plugin.php

curl -sL -o "$PLUGIN_DIR/fc-sqlite-connection-without-credentials.php" \
https://raw.githubusercontent.com/vrana/adminer/master/plugins/fc-sqlite-connection-without-credentials.php

curl -sL -o "$PLUGIN_DIR/login-password-less.php" \
https://raw.githubusercontent.com/vrana/adminer/master/plugins/login-password-less.php

# ------------------------------------------------------------------------------
# 5. 安全生成密码 Hash 并构建入口文件 index.php
# ------------------------------------------------------------------------------
echo "⚙️ 生成密码 Hash 与 index.php 配置..."
# 使用 getenv() 替代 $_ENV，防止 php.ini 未开启 E 作用域导致 Hash 计算为空
HASHED_PASSWORD=$(AUTH_PASS="$AUTH_PASS" php -r 'echo password_hash(getenv("AUTH_PASS"), PASSWORD_DEFAULT);')

cat > "$WEBROOT/index.php" <<EOF
<?php
function adminer_object() {
include_once "./plugins/plugin.php";
include_once "./plugins/fc-sqlite-connection-without-credentials.php";
include_once "./plugins/login-password-less.php";

return new AdminerPlugin([
new AdminerFCSqliteConnectionWithoutCredentials(),
new AdminerLoginPasswordLess('$HASHED_PASSWORD'),
]);
}
include "./adminer.php";
EOF

# ------------------------------------------------------------------------------
# 6. 配置 Nginx 基础认证 (完全依赖 HestiaCP 原生 Include 机制)
# ------------------------------------------------------------------------------
echo "🔒 配置 Nginx HTTP Basic Auth..."
htpasswd -b -c "$HTPASSWD_FILE" "$AUTH_USER" "$AUTH_PASS"
chmod 644 "$HTPASSWD_FILE"

HESTIA_CONF_DIR="/home/$HESTIA_USER/conf/web/$DOMAIN"
if [ -d "$HESTIA_CONF_DIR" ]; then
# HestiaCP 原生包含文件名格式：nginx.conf_* 与 nginx.ssl.conf_*
# 这样无需 sed 修改主配置文件，重建域名配置时也不会失效
cat > "$HESTIA_CONF_DIR/nginx.conf_adminer" <<EOF
auth_basic "Restricted Adminer Access";
auth_basic_user_file $HTPASSWD_FILE;
EOF

cat > "$HESTIA_CONF_DIR/nginx.ssl.conf_adminer" <<EOF
auth_basic "Restricted Adminer Access";
auth_basic_user_file $HTPASSWD_FILE;
EOF
fi

# ------------------------------------------------------------------------------
# 7. 配置 Fail2Ban 防护规则
# ------------------------------------------------------------------------------
echo "🛡️ 配置 Fail2Ban 规则..."
cat > /etc/fail2ban/filter.d/nginx-adminer.conf <<'EOF'
[Definition]
failregex = ^<HOST> - .* "GET /.* HTTP/.*" 401
ignoreregex =
EOF

cat > /etc/fail2ban/jail.d/nginx-adminer.conf <<EOF
[nginx-adminer]
enabled = true
filter = nginx-adminer
port = http,https
logpath = /var/log/nginx/domains/$DOMAIN.log
maxretry = 3
findtime = 600
bantime = 3600
EOF

# ------------------------------------------------------------------------------
# 8. 修复权限、刷新缓存与重载服务
# ------------------------------------------------------------------------------
echo "🧹 修复权限并重载服务..."
chown -R $HESTIA_USER:$HESTIA_USER "$WEBROOT"
find "$WEBROOT" -type d -exec chmod 755 {} +
find "$WEBROOT" -type f -exec chmod 644 {} +

# 平滑重载 PHP-FPM（兼容多版本 PHP 环境）
for service in $(systemctl list-units --type=service --state=running --no-legend | awk '{print $1}' | grep -E 'php.*fpm'); do
systemctl reload "$service" || true
done

# 重载 Web 与防护服务
nginx -t && systemctl reload nginx
if systemctl is-active --quiet fail2ban; then
systemctl restart fail2ban
fi

echo -e "\n=================================================="
echo -e "✅ Adminer 一键部署成功！"
echo -e "--------------------------------------------------"
echo -e "🌐 访问地址 : https://$DOMAIN/index.php"
echo -e "👤 Nginx 认证账号 : $AUTH_USER"
echo -e "🔑 Nginx 认证密码 : [你输入的防护密码]"
echo -e "--------------------------------------------------"
echo -e "💡 Adminer 登录说明："
echo -e " 数据库用户名填写：root（或你的数据库账号）"
echo -e " 数据库密码填写：[你输入的防护密码]"
echo -e "=================================================="

स्क्रिप्ट को कैसे चलाएं: स्क्रिप्ट को निष्पादन की अनुमति दें:

sudo chmod +x /usr/local/bin/deploy-adminer.sh 

स्क्रिप्ट को sudo का उपयोग करके चलाएँ:

sudo /usr/local/bin/deploy-adminer.sh 

निर्देशानुसार कॉन्फ़िगरेशन जानकारी दर्ज करें:

• अपना हेस्टियासीपी उपयोगकर्ता नाम दर्ज करें (उदाहरण के लिए, एडमिन)।
• तैयार किया गया पूरा सबडोमेन दर्ज करें (उदाहरण के लिए, adminer.example.com)।
• अपना सुरक्षा पासवर्ड दर्ज करें (उदाहरण के लिए, MySuperPassword123)

यह स्क्रिप्ट बिना कुछ छोड़े पूरी कॉन्फ़िगरेशन प्रक्रिया को स्वचालित रूप से पूरा कर देगी।

इस पूरी प्रक्रिया में लगभग एक या दो मिनट लगते हैं। स्क्रिप्ट सब कुछ स्वचालित रूप से संभाल लेगी, और आपको मैन्युअल रूप से कोई कमांड चलाने की आवश्यकता नहीं है।

कार्य पूरा होने के बाद, आप https://yourdomain/index.php के माध्यम से Adminer तक पहुंच सकते हैं।

कुछ प्रश्न जिनके बारे में आप चिंतित हो सकते हैं

कुछ दोस्त पूछ सकते हैं, क्या यह स्क्रिप्ट कई PHP संस्करणों का समर्थन करती है?

जी हां, यह समर्थित है। स्क्रिप्ट सिस्टम पर चल रही सभी PHP-FPM सेवाओं का स्वतः पता लगा लेगी और उन्हें एक-एक करके पुनः लोड कर देगी। इसलिए, चाहे आप PHP 7.4 का उपयोग कर रहे हों या PHP 8.2 का, यह ठीक से काम करता है।

कुछ दोस्त पूछ सकते हैं, अगर मैं अपना पासवर्ड बदलना चाहूँ तो क्या होगा?

यह बहुत आसान है; बस स्क्रिप्ट को दोबारा चलाएँ। स्क्रिप्ट पासवर्ड हैश को पुनः उत्पन्न करेगी, Nginx प्रमाणीकरण को पुनः कॉन्फ़िगर करेगी और Fail2Ban को पुनः कॉन्फ़िगर करेगी। पुरानी कॉन्फ़िगरेशन ओवरराइट हो जाएगी।

अगर मैं इसे अनइंस्टॉल करना चाहूँ तो क्या होगा?

आप वेब रूट डायरेक्टरी, पासवर्ड फ़ाइल और Fail2Ban कॉन्फ़िगरेशन को मैन्युअल रूप से हटा सकते हैं। स्क्रिप्ट सिस्टम पर कोई अन्य निशान नहीं छोड़ेगी।

आखिर में लिखिए

मुझे हमेशा से ऐसा लगता रहा है कि संचालन और रखरखाव इतना जटिल नहीं होना चाहिए।

स्क्रिप्ट का उपयोग करके कई मैन्युअल कार्यों को स्वचालित किया जा सकता है। इससे आप अपना समय सर्वर प्रदर्शन को बेहतर बनाने, एप्लिकेशन की स्थिति की निगरानी करने और नई तकनीकों पर शोध करने जैसे अधिक महत्वपूर्ण कार्यों पर लगा सकते हैं।

इससे मुझे एक ऐतिहासिक कहानी याद आती है। 1880 के दशक में, संयुक्त राज्य अमेरिका में बिजली का प्रसार शुरू हुआ। कई कारखाना मालिकों ने जनरेटर और इलेक्ट्रिक मोटर खरीदने और उन्हें अपने कारखानों में स्थापित करने के लिए काफी पैसा खर्च किया। हालांकि, स्थापना के बाद, कई लोगों ने पाया कि उत्पादन क्षमता में कोई खास सुधार नहीं हुआ। इसका कारण यह था कि उन्होंने केवल भाप इंजनों को इलेक्ट्रिक मोटरों से बदला था, लेकिन कारखाने की समग्र संरचना, प्रक्रियाएं और प्रबंधन विधियां अपरिवर्तित रहीं।

बिजली के बढ़ते उपयोग से वास्तव में लाभान्वित होने वाले वे लोग थे जिन्होंने सबसे पहले बिजली का सही अर्थ समझा। उन्होंने उत्पादन लाइनों को फिर से डिज़ाइन किया, कार्यशालाओं का पुनर्गठन किया और श्रमिकों के काम करने के तरीके को फिर से व्यवस्थित किया।

संचालन और रखरखाव स्वचालन के मामले में भी यही बात लागू होती है। कई लोग जानते हैं कि स्क्रिप्ट का उपयोग किया जा सकता है, लेकिन फिर भी वे मैन्युअल संचालन को प्राथमिकता देते हैं, ठीक वैसे ही जैसे अतीत में कारखाने के मालिक बिजली के मोटरों के बारे में जानते थे, लेकिन फिर भी उन्हें इस्तेमाल करने के लिए भाप इंजनों वाली मानसिकता का इस्तेमाल करते थे। स्क्रिप्ट का उद्देश्य आपके विवेक का स्थान लेना नहीं है, बल्कि दोहराव वाले, यांत्रिक और त्रुटि-प्रवण कार्यों को स्वचालित करना है, जिससे आप अपनी ऊर्जा उन कार्यों पर केंद्रित कर सकें जिनमें वास्तव में सोच-विचार की आवश्यकता होती है।

इस तरह यह स्क्रिप्ट अस्तित्व में आई। इसने मेरी एक बड़ी समस्या का समाधान किया, और मुझे उम्मीद है कि यह आपकी भी मदद कर सकती है।

यदि आप HestiaCP और Adminer का उपयोग कर रहे हैं, तो आप इस स्क्रिप्ट को आज़मा सकते हैं। इससे आपका काफी समय बच सकता है।

आपने यहाँ तक पढ़ लिया है, अगर आपको यह उपयोगी लगा हो तो कृपया इसे लाइक और शेयर करें। अगर आप सबसे पहले अपडेट पाना चाहते हैं तो मुझे फॉलो भी कर सकते हैं!

मेरा लेख पढ़ने के लिए धन्यवाद। फिर मिलेंगे।