'\" t
.\"     Title: hosts.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 Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: English
.\"
.TH "HOSTS\&.CONF" "5" "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)"
hosts.conf \- کنترل دسترسی برای برنامه‌های CGI ابزارهای Network UPS Tools
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه‌های CGI (\fBupsset.cgi\fR(8)، \fBupsstats.cgi\fR(8)، \fBupsimage.cgi\fR(8)) از این فایل برای تعیین مجاز بودن برقراری ارتباط با یک میزبان استفاده می‌کنند\&. این امر از سوءاستفاده بازدیدکنندگان تصادفی از وب‌سرور شما برای ایجاد اتصالات خروجی و ایجاد مزاحمت برای دیگران جلوگیری می‌کند\&.
.SH "نکات مهم (IMPORTANT NOTES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
محتوای این فایل باید تماماً اسکی (ASCII) خالص باشد (کدهای نویسه‌ای خارج از این محدوده با یک پیام هشدار نادیده گرفته می‌شوند)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
این فایل حاوی گذرواژه نیست\&. پایش فقط‌خواندنی در NUT به‌صورت ناشناس انجام می‌شود، و برنامهٔ
\fBupsset\fR(8)
هنگام صدور دستور به یک یوپی‌اس خاص، اطلاعات هویتی را در نشست مرورگر درخواست می‌کند (وب‌سرور باید ایمن‌سازی شده باشد، همان‌طور که توسط فایل
\fBupsset.conf\fR(5)
به برنامه گزارش می‌شود)\&.
.RE
.SH "دستورالعمل‌ها (DIRECTIVES)"
.PP
\fBMONITOR\fR \fIups\fR \fIdescription\fR
.RS 4
عنصر
\fIups\fR
به فرم
upsname[@hostname[:port]]
است\&.
.sp
برای مجاز کردن اتصالات به یک یوپی‌اس به نام "snoopy" در سیستمی به نام "doghouse" که
upsd
را روی پورت 7877 اجرا می‌کند، پیکربندی به این شکل خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
MONITOR snoopy@doghouse:7877 "Joe Cool"
.fi
.if n \{\
.RE
.\}
.sp
توضیحات (\fIdescription\fR) باید یک عنصر واحد باشد، بنابراین اگر حاوی فاصله است، باید همان‌طور که در بالا نشان داده شده در علامت نقل‌قول قرار گیرد\&. نام میزبان پیش‌فرض "localhost" است\&.
.RE
.PP
\fBCUSTOM_TEMPLATE_LIST\fR \fIfilename\fR, \fBCUSTOM_TEMPLATE_SINGLE\fR \fIfilename\fR
.RS 4
برنامهٔ
\fBupsstats\fR(8)
امکان استفاده از فایل‌های قالب HTML سفارشی را برای برخی از خروجی‌های خود فراهم می‌کند (نشانه‌گذاری‌های JSON و "treemode" در حال حاضر درون فایل باینری کدگذاری ثابت شده‌اند)، که می‌توانید آن را در بخش رشته پرس‌وجو (query string) از آدرس اینترنتی URI (در
index\&.html
و/یا سلول‌های اضافه‌شدهٔ
header\&.html)
به‌عنوان مثال مشخص کنید:
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
\&.\&.\&./cgi\-bin/upsstats\&.cgi?template_single=custom\-s\&.htm&template_list=custom\-l\&.htm
.fi
.if n \{\
.RE
.\}
.sp
+ نام‌های مشخص فایل برای یک نقش خاص باید با این دستورالعمل‌ها مجاز شوند (می‌توانند تکرار شوند)\&. نام‌های فایل باید حاوی زیررشتهٔ \&.htm باشند و مستقیماً در دایرکتوری پیکربندی NUT قرار داشته باشند (مشابه قالب‌های پیش‌فرض)\&. اگر قالب‌های سفارشی در URI درخواست اولیه استفاده شوند، به‌طور خودکار به پیوندهای تولیدشده افزوده خواهند شد (عمدتاً HOSTLINK، اما همچنین برای احتیاط به TREELINK و TREELINK_JSON اضافه می‌شوند؛ برای جزئیات بیشتر به \fBupsstats.html\fR(5) مراجعه کنید)\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupsset.cgi\fR(8), \fBupsstats.cgi\fR(8), \fBupsimage.cgi\fR(8)
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحهٔ خانگی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5