'\" t
.\"     Title: upsset.conf
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/21/2026
.\"    Manual: راهنمای NUT
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "UPSSET\&.CONF" "5" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "راهنمای NUT"
.\" -----------------------------------------------------------------
.\" * 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)"
upsset.conf \- پیکربندی upsset\&.cgi در Network UPS Tools و توضیحات عمومی راه‌اندازی کارساز وب برای برنامه‌های CGI در NUT
.SH "توضیحات (DESCRIPTION)"
.sp
این فایل تنها یک وظیفه دارد \(em به شما اجازه می‌دهد تا \fBupsset.cgi\fR(8) را متقاعد کنید که شاخهٔ CGI سیستم شما امن است\&. این برنامه تا زمانی که این فایل به‌درستی تعریف نشود اجرا نخواهد شد\&.
.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
اگر NUT را به‌صورت سفارشی برای ویندوز می‌سازید، گزینهٔ پیکربندی \-\-with\-cgi\-uri را به یاد داشته باشید\&. این گزینه به‌طور پیش‌فرض برای ساخت‌های POSIX روی /cgi\-bin/nut و برای ساخت‌های ویندوز روی /cgi\-nut ساده تنظیم شده است تا ادغام آن‌ها به ترتیب به‌عنوان بخشی از وب‌سایت‌های موجود یا یک وب‌سایت اختصاصی آسان‌تر شود\&. اگر در استقرار خاص شما برای این مقدار ناهماهنگی وجود دارد، فایل html/header\&.html را بررسی کنید تا پیوندهای a href مربوط به برنامه‌های CGI را که قرار است در بخش پایینی (تحت عنوان target=mainFrame) باز شوند تنظیم کنید\&.
.sp .5v
.RE
.SH "نکات مهم (IMPORTANT NOTES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
محتویات این فایل باید صرفاً ASCII باشد (کدهای نویسه‌ای که در این محدوده نباشند همراه با پیام هشدار نادیده گرفته می‌شوند)\&.
.RE
.SH "الزامات امنیتی (SECURITY REQUIREMENTS)"
.sp
\fBupsset.cgi\fR(8) به شما اجازه می‌دهد تا ترکیب‌های نام کاربری و گذرواژه را امتحان کنید\&. هیچ محدودیتی بر نرخ درخواست‌ها (rate limiting) وجود ندارد، چرا که برنامه پس از هر درخواست بسته می‌شود\&. ماهیت برنامه‌های CGI چنین است\&.
.sp
اعتبارنامه‌ها به‌عنوان بخشی از نشست مرور شما به upsset\&.cgi ارائه می‌شوند، بنابراین اکیداً توصیه می‌شود HTTPS را روی کارساز وب راه‌اندازی کنید\&. همچنین ممکن است بخواهید به‌طور کلی از احراز هویت مبتنی بر کارساز وب (خواه نام کاربری و گذرواژه پایه، یا LDAP، یا گواهی کارخواه و غیره) استفاده کنید، یا شنودکننده‌های میزبان مجازی با نام‌های میزبان منتشرنشده («امنیت از طریق ابهام») راه‌اندازی نمایید تا دسترسی به برنامه‌های CGI مربوط به NUT را به‌طور کلی محدود سازید\&. روش‌های انجام این کار به پیاده‌سازی کارساز وب انتخابی شما بستگی دارد و خارج از حوزهٔ این سند است\&.
.sp
در حالت عادی، مهاجمان نمی‌توانند مستقیماً به کارساز دادهٔ NUT یعنی \fBupsd\fR(8) دسترسی پیدا کنند، زیرا توسط دستورالعمل‌های LISTEN در فایل \fBupsd.conf\fR(5) شما، tcp\-wrappers (در صورت در دسترس بودن هنگام ساخت NUT) و به احتمال زیاد تنظیمات دیوار آتش محلی در سیستم‌عاملتان محافظت می‌شود\&.
.sp
\fBupsset\fR روی کارساز وب شما اجرا می‌شود، بنابراین upsd آن را به‌صورت اتصالی از یک میزبان در شبکهٔ داخلی خواهد دید\&. upsd نمی‌داند که این اتصال در واقع توسط شخصی از بیرون آغاز شده است\&. به همین دلیل است که باید آن را ایمن کنید\&.
.SS "کارساز وب آپاچی (Apache Web Server)"
.sp
در آپاچی، می‌توانید از فایل \&.htaccess استفاده کنید یا دستورالعمل‌ها را در httpd\&.conf خود قرار دهید\&. با فرض روش \&.htaccess برای نسخه‌های قدیمی‌تر آپاچی، چیزی شبیه به این خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
<Files upsset\&.cgi>
        deny from all
        allow from your\&.network\&.addresses
</Files>
.fi
.if n \{\
.RE
.\}
.sp
احتمالاً باید AllowOverride Limit را برای این شاخه در فایل پیکربندی سطح سرور خود نیز تنظیم کنید\&.
.sp
نسخه‌های مدرن آپاچی از نحو دقیق‌تری بهره می‌برند، مانند این:
.sp
.if n \{\
.RS 4
.\}
.nf
ScriptAlias /upsstats\&.cgi /usr/share/nut/cgi/upsstats\&.cgi
ScriptAlias /upsset\&.cgi /usr/share/nut/cgi/upsset\&.cgi
<Directory "/usr/share/nut/cgi">
      Options +Includes +ExecCGI
      AllowOverride Limit
      <RequireAny>
          Require local
          Require ip aa\&.bb\&.cc\&.dd/nn
      </RequireAny>
</Directory>
.fi
.if n \{\
.RE
.\}
.SS "Microsoft IIS"
.sp
با ساخت‌های NUT برای ویندوز، کارساز اطلاعات اینترنتی مایکروسافت (IIS) می‌تواند به‌عنوان کارساز وب بومی این پلتفرم برای میزبانی برنامه‌های CGI در NUT مورد استفاده قرار گیرد\&.
.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
مانند سایر جنبه‌های NUT برای ویندوز، این پیکربندی باید آزمایشی در نظر گرفته شود؛ بازخوردها و pull requestها برای بهبود کد و مستنداتی مانند این صفحه بسیار مورد استقبال قرار می‌گیرند\&.
.sp .5v
.RE
.sp
یکی از جنبه‌هایی که ممکن است امور را ساده یا پیچیده کند این است که این ساخت‌ها با هدف تغییرپذیر بودن مکان نصب (relocatable) طراحی شده‌اند، بنابراین بایگانی (و در نهایت بسته) را می‌توان در هر شاخه‌ای به انتخاب کاربر نهایی باز کرد و «بدون مشکل کار کند»؛ این امر بر استفادهٔ پیش‌فرض از مکان پیکربندی و برنامه نسبت به برنامهٔ NUT در حال اجرای فعلی متکی است، نه مسیرهای کدگذاری‌شدهٔ ثابت مانند ساخت‌های POSIX که برای استقرار یا بسته‌ای خاص سفارشی شده‌اند\&.
.sp
راه‌اندازی گام‌به‌گام زیر روی یک ایستگاه کاری Windows 10 تأیید شده است\&. نام‌ها و لایه‌بندی مفاهیم اشاره‌شده در سایر نسخه‌های این سیستم‌عامل ممکن است متفاوت باشند\&. برای جزئیات بیشتر به اسنادی مانند https://learn\&.microsoft\&.com/en\-us/iis/configuration/system\&.webserver/cgi یا وبلاگ‌هایی مانند https://dotnetblog\&.asphostportal\&.com/5\-steps\-to\-run\-cgi\-program\-on\-your\-iis/ مراجعه کنید\&.
.sp
در ویندوز، Control Panel را باز کرده و به مسیر «Programs / Programs and Features» و سپس به بخش «Turn Windows features on or off» بروید\&. به پایین پیمایش کرده و در بخش «Internet Information Services» گزینهٔ مربوطه را علامت بزنید تا مجموعه پیش‌فرض گزینه‌ها (مثلاً برخی سرویس‌ها، برخی ابزارها، بدون FTP) فعال شود\&. سپس به مسیر «World Wide Web Services / Application Development Features» رفته و «CGI» و «ISAPI Extensions» را انتخاب کنید\&. ممکن است برای نصب این موارد نیاز به راه‌اندازی مجدد سیستم باشد\&.
.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
اگر ویژگی‌ها را بعداً اضافه کنید (پس از اینکه برنامهٔ IIS Manager را اجرا کرده‌اید)، باید برنامهٔ IIS Manager را مجدداً باز کنید، در غیر این صورت برای پیکربندی در رابط کاربری نمایش داده نمی‌شوند\&.
.sp .5v
.RE
.sp
برنامهٔ IIS Manager را باز کرده و بررسی کنید که پنل اصلی شامل آیکون‌های «CGI» و «ISAPI and CGI Restrictions» باشد\&.
.sp
در پیکربندی IIS، می‌توانید Default Web Site را ویرایش کرده یا یک وب‌سایت جدید ایجاد کنید (نیاز است نام میزبان در DNS یا دست‌کم از طریق فایل محلی %SystemRoot%\esystem32\edrivers\eetc\ehosts شناخته شود)، و ریشهٔ وب‌سایت را روی محل نصب NUT (شاخه‌ای که از جمله شامل زیرشاخه‌های etc و cgi\-bin است) تنظیم نمایید\&.
.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\-bin و html را در یک مکان جداگانه کپی کنید (برای مثال زیر مسیر c:\einetpub\ewwwroot یا ریشهٔ وب‌سایت غیرپیش‌فرض)، و سپس یک شاخهٔ etc اختصاصی را با فایل‌های پیکربندی و الگوها برای برنامه‌های CGI پر کنید، یا به نحوی متغیر محیطی NUT_CONFPATH را از کارساز وب صادر نمایید تا به مکانی که «نزدیک» برنامه‌های اجرایی نیست اشاره کند\&. متناوباً، می‌توانید استفاده از یک ریشهٔ خالی و «شاخه‌های مجازی» (virtual directories) در IIS را بررسی کنید تا صرفاً به cgi\-bin و html در محل نصب NUT ارجاع داده شود \(em و در نتیجه افشای هر فایل دیگری به حداقل برسد\&.
.sp .5v
.RE
.sp
پس از اینکه وب‌سایت را به هر نحوی تعریف کردید، ریشهٔ آن را در پنل «Connections» انتخاب کرده و روی آیکون «ISAPI and CGI Restrictions» دوبار کلیک کنید\&. در آنجا از «Actions / Add» مسیرهای کامل برنامه‌های upsimage\&.cgi\&.exe، upsset\&.cgi\&.exe و upsstats\&.cgi\&.exe را (در کل ۳ بار) مشخص کنید، همگی با علامت زدن گزینهٔ «Allow extension path to execute»\&.
.sp
بخش «Handler Mappings» را برای زیرشاخهٔ cgi\-bin بازبینی کنید تا شامل «CGI\-exe» با «Path *\&.exe» و «State Enabled» باشد (اگر نبود، ورودی را ویرایش کرده، «Request Restrictions» را فشار دهید و در آنجا «Access/Execute» را علامت بزنید)\&.
.sp
اگر کارساز (مجازی) به برنامه‌های CGI در NUT اختصاص یافته است، ممکن است بخواهید به آیکون «CGI» نیز رفته و Behavior/Timeout را به چند دقیقه یا حتی چند ثانیه تغییر دهید (و تغییرات را Apply کنید)، تا در صورت بروز هرگونه خرابی در برنامه‌های CGI مربوط به NUT، به یک صفحهٔ خالی خیره نشوید و ندانید که کارساز زنده است یا خیر\&. مقدار پیش‌فرض IIS برابر با ۱۵ دقیقه است\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
با این حال، ممکن است بخواهید زمان کافی برای یک سری از وقایع مهلت زمانی (timeouts) تابع
upscli_tryconnect()
در NUT (به‌طور پیش‌فرض ۱۰ ثانیه برای هرکدام) در نظر بگیرید، مثلاً برای دریافت پیام‌های خطا زمانی که کارسازهای دادهٔ NUT از کار افتاده‌اند\&. در حالی که برای هر بار اجرای کارخواه‌های CGI مربوط به
upsset
یا
upsimage
ممکن است یک اتصال وجود داشته باشد، برای
upsstats
بسته به تعداد دستگاه‌هایی که در
\fBhosts.conf\fR(5)
با
MONITOR
تعریف کرده‌اید، ممکن است تعداد اتصالات بیشتری وجود داشته باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
این توصیه ممکن است بعداً در صورت پیاده‌سازی پشتیبانی از «ردیابی» تکمیل دستورات یا تنظیمات ارسال‌شده در سمت دستگاه تغییر کند؛ در حال حاضر کارخواه CGI مربوط به
\fBupsset\fR(8)
تنها تأییدیهٔ دریافت درخواست توسط کارساز دادهٔ NUT یعنی
\fBupsd\fR(8)
را دریافت و بازپخش می‌کند\&.
.RE
.sp
در شاخهٔ پیکربندی NUT، فایل‌های \fBhosts.conf\fR(5) و upsset\&.conf را بر حسب نیاز به‌روزرسانی کنید، و (در صورت تمایل پس از اعمال تغییرات) نام فایل‌های upsstats\&.html\&.sample و upsstates\-single\&.html\&.sample را طوری تغییر دهید که پسوند \&.sample را نداشته باشند\&.
.sp
در نهایت، با فرض پیکربندی پیش‌فرض وب‌سایت، به نشانی http://localhost/html/ بروید؛ صفحه‌ای دو بخشی با یک بنر NUT و پیوندهایی به دو ابزار در بالا، و جدول‌های داده در پایین به شما نمایش داده می‌شود\&. اگر پایش دستگاه را از قبل راه‌اندازی کرده‌اید، صفحات جزئیات را بررسی کنید: اگر نمایش داده نشدند، مطمئن شوید که فایل‌های upsstats\&.html و upsstats\-single\&.html نام‌های URI برنامه برای UPSSTATSPATH و UPSIMAGEPATH را با پسوند \&.exe تعریف کرده باشند\&.
.SS "تکمیل راه‌اندازی CGI (Completing the CGI setup)"
.sp
اگر این موارد برایتان مفهوم نیست، خواندن را متوقف کرده و این برنامه را به حال خود رها کنید\&. به هر حال این برنامه‌ای نیست که حتماً به آن نیاز داشته باشید\&.
.sp
با فرض اینکه تمام مراحل فوق را انجام داده‌اید و واقعاً کار می‌کند (آن را آزمایش کنید!)، تبریک می‌گوییم \(em شما یک کارساز وب فقط‌خواندنی دارید که اطلاعات NUT را در قالبی مناسب گزارش می‌دهد\&.
.sp
اگر علاوه بر این می‌خواهید دستگاه‌ها را مدیریت کنید (و باز هم تأکید می‌شود، در صورتی که محدودیت‌های امنیتی مناسب را تنظیم کرده‌اید)، می‌توانید دستورالعمل زیر را به این فایل اضافه کنید تا دسترسی بالقوه خطرناک از طریق کارساز باز شود:
.sp
.if n \{\
.RS 4
.\}
.nf
I_HAVE_SECURED_MY_CGI_DIRECTORY
.fi
.if n \{\
.RE
.\}
.sp
اگر به برنامه دروغ بگویید و شخصی از طریق کارساز وب شما به upsd آسیب بزند، مرا سرزنش نکنید\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupsset.cgi\fR(8)
.SS "منابع اینترنتی:"
.sp
صفحهٔ خانگی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5/