خط فرمان عامل
همه دستورهای namayek-agent: ثبت، اجرا، منابع، کلیدها، پشتیبان‌گیری و بازگردانی محلی و کدهای خروج.
در این صفحه
دستورهای سرویس
این دستورها عامل را به پروژه شما وصل و اجرا می‌کنند. هیچ رازی در آرگومان‌ها نمی‌آید؛ نشانی و رمز فقط از متغیر محیطی یا فایل.
| دستور | نوع / مقدار | توضیح |
|---|---|---|
enroll --token <t> [--name] [--server] | یک بار | ثبت عامل با توکن یک‌بارمصرف پنل؛ کلید عامل روی همین سرور ساخته می‌شود. |
run | سرویس | اجرای دائمی: سلام، دریافت کار، اجرا؛ SIGTERM کار جاری را با نظم تمام یا رها می‌کند. |
source add <id> --engine <e> (--dsn-env | --dsn-file) [--password-env] [--mssql-backup-dir <d> [--mssql-local-dir <d>]] | منبع | افزودن منبع پنل به پیکربندی محلی؛ برای SQL Server پوشه پشتیبان از دید SQL Server و در صورت تفاوت، همان پوشه روی سرور عامل. پنل این خط را آماده می‌دهد. |
source list · source test <id> | منبع | فهرست و آزمایش اتصال منبع. |
status [--json] | وضعیت | اتصال به لبه، نسخه، منابع و آخرین کارها. |
rotate-key | امنیت | چرخش کلید امضای عامل. |
deregister | امنیت | حذف ثبت عامل و پاک کردن کلید محلی. |
trust add-agent <pub> | امنیت | اعتماد به نسخه‌های عامل دیگر برای بازگردانی. |
دستورهای محلی
این دستورها بدون نمایک هم کار می‌کنند؛ مثلا برای باز کردن نسخه‌ای که فقط با کلید شما رمزنگاری شده یا بازگردانی دستی. خروجی --json یک شیء نتیجه چاپ می‌کند.
| دستور | نوع / مقدار | توضیح |
|---|---|---|
keygen --out <file> | کلید | ساخت هویت مشتری (0600) و چاپ کلید عمومی nmkpk1…. |
backup --engine <e> --dsn-env <V> --recipient <nmkpk1…> --out <file> | محلی | پشتیبان‌گیری دستی به فایل NMKB1. |
inspect --in <file> --identity <key> | محلی | احراز کامل همه بایت‌های یک نسخه. |
restore --engine <e> --dsn-env <V> --in <file> --identity <key> --target <name> | محلی | بازگردانی به پایگاه تازه؛ --clean برای جایگزینی. |
decrypt --in <file> --identity <key> --out <file> | محلی | خروجی بومی موتور (0600). |
doctor | عیب‌یابی | ابزارها، نسخه‌ها، zstd و پوشه موقت. |
کدهای خروج
| کد | نوع / مقدار | توضیح |
|---|---|---|
0 | ok | موفق |
1 | INTERNAL | خطای داخلی |
2 | USAGE | دستور یا گزینه نادرست |
3 | TOOL_NOT_FOUND | ابزار موتور نصب نیست |
4 | CONNECTION_FAILED / AUTH_FAILED | اتصال یا احراز هویت پایگاه داده |
5 | TOOL_FAILED / TARGET_EXISTS / PERMISSION_DENIED / VERSION_MISMATCH / POLICY_REFUSED | خطای ابزار، مقصد موجود، دسترسی، نسخه یا سیاست محلی |
6 | INTEGRITY | دستکاری، کلید نادرست یا فایل ناقص |
7 | TIMEOUT | پایان مهلت |
8 | IO | خطای دیسک یا شبکه |
130 | CANCELLED | لغو شد |
آخرین به‌روزرسانی: