'\" t .\" Title: upsd.users .\" 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 "UPSD\&.USERS" "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)" upsd.users \- تعاریف کاربران مدیریتی برای سرور داده upsd در NUT .SH "توضیحات (DESCRIPTION)" .sp دستورات مدیریتی مانند تنظیم متغیرها و دستورات آنی (instant commands) قدرتمند هستند و دسترسی به آن‌ها باید محدود شود\&. این فایل مشخص می‌کند چه کسانی مجاز به دسترسی به آن‌ها هستند و چه مواردی در دسترس است\&. .SH "نکات مهم (IMPORTANT NOTES)" .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} محتوای این فایل باید صرفاً کد اسکی (pure ASCII) باشد (کدهای کاراکتری خارج از این محدوده با یک پیام هشدار نادیده گرفته خواهند شد)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مجوزهای دسترسی کاربر زمان اجرا به این فایل (و احتمالاً پوشه‌ای که در آن قرار دارد) را به گونه‌ای متوازن تنظیم کنید که تنها upsd بتواند آن را بخواند؛ دسترسی نوشتن لازم نیست\&. معمولاً از chown root:nut و chmod 640 برای تنظیم مجوزهای قابل قبول فایل استفاده می‌شود\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} بسته‌ها (و دستورالعمل‌های ساخت) معمولاً یک مجموعه از حساب‌های کاربری و گروهی را برای NUT آماده می‌کنند\&. ساخت‌های سفارشی با حداقل پیکربندی ممکن است حتی از nobody:nogroup یا مشابه آن استفاده کنند که ذاتاً ناامن است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} در سیستم‌هایی با ملاحظات امنیتی بیشتر، درایورهای NUT و سرور داده باید تحت حساب‌های کاربری جداگانه‌ای اجرا شوند که برای دسترسی مشترک به فایل‌های سوکت یونیکس محلی و پوشه‌ای که در آن قرار دارند، عضو یک گروه یکسان باشند، اما برای دسترسی به فایل‌های پیکربندی در گروه‌های متفاوتی قرار گیرند\&. این کار نیازمند آن است که برخی دیمن‌ها از تنظیمات سفارشی user, group, RUN_AS_USER و/یا RUN_AS_GROUP برای بازنویسی مقدار منفرد توکار استفاده کنند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} توجه داشته باشید که کلاینت‌های مانیتورینگ، ثبت لاگ و غیره صرفاً تحت شبکه هستند\&. آن‌ها نیازی به دسترسی به این فایل‌ها و پوشه‌ها ندارند و می‌توانند کاملاً به عنوان یک کاربر و گروه مستقل اجرا شوند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} امنیت هرگونه نسخه پشتیبان از این فایل را نیز در نظر داشته باشید، مانند فایل‌های آرشیوی که ممکن است در آن‌ها قرار گیرد\&. .RE .RE .SH "بخش‌ها (SECTIONS)" .sp هر کاربر بخش مختص به خود را دارد\&. فیلدهای موجود در آن بخش، پارامترهای مرتبط با امتیازات آن کاربر را تنظیم می‌کنند\&. این بخش با نام کاربر درون براکت آغاز می‌شود و تا نام کاربر بعدی درون براکت یا انتهای فایل (EOF) ادامه می‌یابد\&. این کاربران مستقل از /etc/passwd یا سایر پایگاه‌های داده حساب کاربری سیستم‌عامل هستند\&. .sp در اینجا چند مثال برای شروع آورده شده است: .sp .if n \{\ .RS 4 .\} .nf [admin] password = mypass actions = set actions = fsd instcmds = all .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf [pfy] password = duh instcmds = test\&.panel\&.start instcmds = test\&.panel\&.stop .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf [upswired] password = blah upsmon primary .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf [observer] password = abcd upsmon secondary .fi .if n \{\ .RE .\} .SH "فیلدها (FIELDS)" .PP \fBpassword\fR .RS 4 رمز عبور این کاربر را تنظیم می‌کند\&. .RE .PP \fBactions\fR .RS 4 به کاربر اجازه می‌دهد کارهای مشخصی را با upsd انجام دهد\&. برای مشخص کردن چندین عمل، از چندین نمونه از فیلد \fBactions\fR استفاده کنید\&. عمل‌های معتبر عبارتند از: .PP SET .RS 4 تغییر مقدار برخی متغیرها در UPS .RE .PP FSD .RS 4 تنظیم پرچم خاموش‌سازی اجباری (forced shutdown) در UPS\&. این عمل برای اهداف مانیتورینگ معادل وضعیت «روی باتری + باتری ضعیف» است\&. .RE .sp انتظار می‌رود فهرست عمل‌ها در آینده گسترش یابد\&. .RE .PP \fBinstcmds\fR .RS 4 به کاربر امکان می‌دهد دستورات آنی (instant commands) خاصی را اجرا کند\&. برای اعطای خودکار تمامی دستورات، از "ALL" استفاده کنید\&. برای مشخص کردن چندین دستور، از چندین نمونه از فیلد \fBinstcmds\fR استفاده کنید\&. برای مشاهده فهرست کامل مواردی که UPS شما پشتیبانی می‌کند، از دستور زیر استفاده کنید: upscmd \-l\&. .sp فایل cmdvartab که همراه با توزیع NUT ارائه می‌شود، حاوی فهرستی از بیشتر نام‌های دستوری شناخته‌شده عمومی است\&. .RE .PP \fBupsmon\fR .RS 4 عمل‌های لازم را برای یک فرآیند upsmon اضافه می‌کند، و می‌توان آن را به عنوان نقش یک نمونه کلاینت خاص برای کار با این نمونه سرور داده در نظر گرفت\&. این فیلد روی یکی از مقادیر \fIprimary\fR (ممکن است درخواست FSD دهد) یا \fIsecondary\fR (وضعیت‌های بحرانی را دنبال می‌کند تا در صورت نیاز خاموش شود) تنظیم می‌شود\&. .sp تلاش نکنید عمل‌ها را به صورت دستی به upsmon اختصاص دهید، زیرا ممکن است موارد مهمی را از قلم بیندازید\&. این روش تعیین یک «کاربر upsmon» ایجاد شد تا قابلیت‌های داخلی بتوانند بعداً بدون شکستن نصب‌های موجود تغییر کنند (احتمالاً با استفاده از عمل‌هایی که برای انتساب مستقیم در دسترس نیستند)\&. .RE .SH "همچنین ببینید (SEE ALSO)" .sp \fBupsd\fR(8), \fBupsd.conf\fR(5) .SS "منابع اینترنتی (Internet resources):" .sp صفحه اصلی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5