'\" t .\" Title: upsstats.cgi .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 06/21/2026 .\" Manual: NUT Manual .\" Source: Network UPS Tools 2.8.5 .\" Language: Persian .\" .TH "UPSSTATS\&.CGI" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" upsstats.cgi \- نمایشگر وضعیت UPS مبتنی بر وب .SH "خلاصه دستور (SYNOPSIS)" .sp \fBupsstats\&.cgi\fR .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBیادداشت\fR .ps -1 .br .sp این برنامه به عنوان یک برنامه CGI، باید از طریق وب‌سرور شما فراخوانی شود\&. اگر آن را از خط فرمان اجرا کنید، یا از دسترسی غیرمجاز اخطار می‌دهد یا خروجی خام کدهای HTML را به سمت شما سرازیر می‌کند\&. .sp .5v .RE .SH "توضیحات (DESCRIPTION)" .sp \fBupsstats\&.cgi\fR یک کلاینت فقط‌خواندنی NUT است که از فایل‌های الگو برای ساخت صفحات وب حاوی اطلاعات وضعیت سخت‌افزار UPS استفاده می‌کند\&. این ابزار می‌تواند بخش‌هایی از آن فایل‌های الگو را برای نظارت هم‌زمان بر چندین دستگاه تکرار کند، یا بر یک UPS منفرد متمرکز شود\&. .sp این الگوها همچنین می‌توانند شامل ارجاعاتی به \fBupsimage.cgi\fR(8) برای نمایش گرافیکی سطوح شارژ باتری، خوانش‌های ولتاژ و بار مصرفی UPS باشند\&. .sp برای جزئیات بیشتر درباره پیکربندی وب‌سرورهای پرکاربرد جهت اجرای برنامه‌های CGI مربوط به NUT، لطفاً به صفحه \fBupsset.conf\fR(5) مراجعه کنید\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBیادداشت\fR .ps -1 .br .sp در پلتفرم‌هایی با پسوندهای الزامی نام فایل اجرایی (مانند ویندوز)، ممکن است نیاز باشد برای نمونه از پسوند *\&.cgi\&.exe برای برنامه‌ها در فایل‌های الگوی HTML (مانند UPSSTATSPATH و UPSIMAGEPATH) استفاده کنید\&. .sp .5v .RE .SH "کنترل دسترسی (ACCESS CONTROL)" .sp دستور upsstats فقط با سرورهای \fBupsd\fR(8) که در \fBhosts.conf\fR(5) شما تعریف شده‌اند گفتگو می‌کند\&. اگر این ابزار با پیام "Access to that host is not authorized" خطا داد، ابتدا آن فایل را بررسی کنید\&. .SH "الگوها (TEMPLATES)" .sp صفحه وبی که نمایش داده می‌شود در واقع یک الگو حاوی دستوراتی به upsstats است که با اطلاعات وضعیت جایگزین می‌شوند\&. .sp فایل پیش‌فرض مورد استفاده برای بازبینی کلی دستگاه‌ها upsstats\&.html است\&. یک الگوی جایگزین می‌تواند از طریق گزینه پرس‌وجوی CGI به‌صورت &template_list=\&.\&.\&. تعیین شود؛ فایل مربوطه باید از طریق گزینه CUSTOM_TEMPLATE_LIST در \fBhosts.conf\fR(5) مجاز شده باشد\&. .sp هنگام نظارت بر یک UPS منفرد، فایل نمایش‌داده‌شده upsstats\-single\&.html است\&. یک الگوی جایگزین می‌تواند از طریق گزینه پرس‌وجوی CGI به‌صورت &template_single=\&.\&.\&. تعیین شود؛ فایل مربوطه باید از طریق گزینه CUSTOM_TEMPLATE_SINGLE در \fBhosts.conf\fR(5) مجاز شده باشد\&. .sp الگوهای جایگزین باید ساختاری مشابه الگوهای پیش‌فرض داشته باشند، در همان دایرکتوری قرار گیرند، و نام فایل آن‌ها حاوی \&.htm باشد\&. می‌توانید این مورد را در بخش رشته پرس‌وجوی URI (برای مثال، در index\&.html محلی خود یا خانه‌های اضافه‌شده به header\&.html) مشخص کنید، به عنوان مثال: .sp .if n \{\ .RS 4 .\} .nf \&.\&.\&./cgi\-bin/upsstats\&.cgi?template_single=custom\-s\&.html&template_list=custom\-l\&.html .fi .if n \{\ .RE .\} .sp قالب این فایل‌ها، از جمله دستورات معتبر، در \fBupsstats.html\fR(5) مستند شده است\&. .SH "خروجی JSON (JSON OUTPUT)" .sp علاوه بر پردازش الگوهای HTML، \fBupsstats\&.cgi\fR می‌تواند با افزودن پارامتر \fBjson\fR به رشته پرس‌وجو (مانند \fB?json\fR یا \fB&json\fR) به عنوان یک API از نوع JSON فراخوانی شود\&. .sp هنگامی که این پارامتر وجود داشته باشد، اسکریپت CGI تجزیه تمام الگوهای HTML را نادیده گرفته و به جای آن یک شیء JSON بازمی‌گرداند\&. .sp ساختار خروجی JSON به این بستگی دارد که آیا پارامتر \fBhost\fR نیز ارائه شده است یا خیر: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBچندمیزبانی (پیش‌فرض):\fR اگر پارامتر \fBhost\fR مشخص نشده باشد، اسکریپت یک شیء JSON واحد حاوی کلید \fB"devices"\fR بازمی‌گرداند\&. این کلید حاوی یک آرایه است که هر عنصر آن یک شیء JSON نشان‌دهنده یک UPS تحت نظارت است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBحالت تک‌میزبان:\fR اگر پارامتر \fBhost\fR مشخص شده باشد (مانند \fB?host=\fR\fBmyups@localhost\fR\fB&json\fR)، اسکریپت یک شیء JSON واحد برای آن UPS بازمی‌گرداند (درون یک آرایه "devices" قرار نخواهد گرفت)\&. .RE .sp در هر دو حالت، هر شیء UPS شامل موارد زیر است: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhost\fR: شناسه UPS (مانند "myups@localhost") .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdesc\fR: توضیحات میزبان برگرفته از hosts\&.conf .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBstatus_raw\fR: رشته خام وضعیت (مانند "OL") .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBstatus_parsed\fR: آرایه‌ای از رشته‌های وضعیت خوانا برای انسان (مانند ["Online"]) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBvars\fR: شیئی حاوی درخت کامل تمام متغیرهای موجود برای آن UPS (مانند "battery\&.charge": "100"، "ups\&.model": "\&...") .RE .SH "فایل‌ها (FILES)" .sp \fBhosts.conf\fR(5)، \fBupsstats.html\fR(5)، upsstats\-single\&.html .SH "همچنین ببینید (SEE ALSO)" .sp \fBupsimage.cgi\fR(8) .SS "منابع اینترنتی:" .sp صفحه اصلی NUT (Network UPS Tools):