نصب ابردرایو

نصب‌کننده (install.sh) همه‌ی پرسش‌هایش را اول می‌پرسد و بعد بدون وقفه تا پایان کار می‌کند. همه‌ی رمزها و کلیدهای داخلی را خودش می‌سازد و لازم نیست هیچ رمزی جز رمز مدیر را خودتان انتخاب کنید. این صفحه پرسش‌ها را به همان ترتیبی می‌آورد که روی یک سرور تازه دیده می‌شوند.

۱. اجرای نصب‌کننده

cd /opt/abrdrive
sudo bash install.sh

بیشتر پرسش‌ها در پنجره‌های تمام‌صفحه نمایش داده می‌شوند. با کلیدهای جهت یا Tab جابه‌جا شوید، با Space یک گزینه را در فهرست تیک بزنید و با Enter تأیید کنید. اگر پنجره نمایش داده نشود، همان پرسش‌ها به‌صورت یک خط متن می‌آیند و پاسخ پیش‌فرض داخل [ ] نوشته شده است؛ برای پذیرفتن پیش‌فرض فقط Enter بزنید.

نحوه‌ی بررسی: نصب‌کننده با نشان ابردرایو شروع می‌شود و در مرحله‌ی [1/10] Preflight چند خط ok چاپ می‌کند، از جمله bundle integrity verified که یعنی فایل‌های بسته دست‌نخورده‌اند. اگر پیام run server-setup.sh first آمد، آماده‌سازی سرور کامل نشده است.

۲. نقش سرور (Role)

پرسش: What should this server run?

گزینه‌ی اول، single، را انتخاب کنید و Enter بزنید. یعنی همه‌ی بخش‌های ابردرایو روی همین سرور اجرا می‌شوند. دو گزینه‌ی دیگر (global و node) برای نصب چندسروره هستند و در افزودن سرور دوم توضیح داده شده‌اند. نقش سرور پس از نصب قابل تغییر نیست.

۳. دامنه (Domain)

پرسش: Enter the ONE domain this AbrDrive will live on, without https://

دامنه را بدون https:// بنویسید، مثلاً drive.example.com. نصب‌کننده نام همه‌ی سرویس‌ها را از همین یک نام می‌سازد. اگر چیزی بنویسید که شبیه دامنه نباشد، دوباره پرسیده می‌شود.

۴. صفحه‌های حقوقی (Legal pages)

پرسش: Base URL of your Terms of Use and Disclaimer pages.

نشانی https جایی را بنویسید که صفحه‌های شرایط استفاده و سلب مسئولیت شما آنجا هستند، مثلاً https://example.com. ابردرایو به https://example.com/terms و https://example.com/disclaimer پیوند می‌دهد. اگر این صفحه‌ها روی خود دامنه‌ی ابردرایو هستند، پیش‌فرض را با Enter بپذیرید. این پرسش فقط در نصب اول پرسیده می‌شود.

۵. رکوردهای DNS

پنجره‌ی Create these DNS records فهرست شش رکوردی را نشان می‌دهد که باید به این سرور اشاره کنند، همراه با نشانی IP سرور. اگر آن‌ها را در پیش از شروع ساخته‌اید، Enter بزنید.

نحوه‌ی بررسی: نصب‌کننده هر رکورد را بررسی می‌کند و برای هر کدام خطی مثل این چاپ می‌کند:

  ok    app.drive.example.com -> SERVER_IP

اگر رکوردی هنوز ثبت نشده باشد، می‌پرسد Check again?. اگر رکورد را تازه ساخته‌اید، چند دقیقه صبر کنید و Yes را بزنید. با No نصب ادامه پیدا می‌کند و فقط صدور گواهی HTTPS انجام نمی‌شود؛ وقتی DNS درست شد، کافی است sudo bash install.sh را دوباره اجرا کنید.

۶. روش ارسال ایمیل (Email delivery)

پرسش: How should AbrDrive send email (verification, invitations)?

برای حساب SMTP گزینه‌ی Smtp (پیش‌فرض) و برای Mailgun گزینه‌ی Mailgun را انتخاب کنید. پس از آن این پرسش‌ها می‌آیند:

پرسش	پاسخ
From address for all outgoing mail	نشانی فرستنده. پیش‌فرض postmaster@drive.example.com است؛ اگر ارائه‌دهنده‌ی ایمیل فقط از نشانی دیگری اجازه‌ی ارسال می‌دهد، آن را بنویسید.
Cc on every message (blank for none)	معمولاً خالی بگذارید و Enter بزنید.
SMTP host	نام سرور SMTP، مثلاً smtp.example.com. پورت همیشه ۵۸۷ است و پرسیده نمی‌شود.
Use TLS (STARTTLS)?	Yes، مگر اینکه سرور ایمیل شما اصلاً رمزگذاری نداشته باشد.
SMTP username (blank if none)	نام کاربری حساب ایمیل.
SMTP password	رمز حساب ایمیل. هنگام تایپ چیزی نمایش داده نمی‌شود.

با Mailgun به‌جای چهار پرسش آخر، دامنه‌ی ارسال (Mailgun sending domain) و کلید API خصوصی (Mailgun private API key) پرسیده می‌شود.

نحوه‌ی بررسی: پس از رمز SMTP، نصب‌کننده بدون فرستادن هیچ ایمیلی به سرور ایمیل وصل می‌شود و وارد حساب می‌شود. اگر موفق شود، خطی با ok SMTP: چاپ می‌کند. اگر نشود، علت را می‌گوید، مثلاً rejected the username or password (نام کاربری یا رمز اشتباه است) یا does not resolve (نام سرور اشتباه است)، و می‌پرسد Enter them again?. با Yes دوباره وارد کنید. با No نصب ادامه پیدا می‌کند و ایمیل را بعداً با sudo bash configure.sh و گزینه‌ی Email درست می‌کنید.

۷. گواهی HTTPS

پرسش: Issue Let's Encrypt certificates automatically at the end (once DNS is correct)?

Yes را بزنید. نصب‌کننده در پایان کار، برای همه‌ی نام‌ها گواهی رایگان Let's Encrypt می‌گیرد و تمدید خودکار آن را هم بررسی می‌کند.

۸. سرویس‌های اختیاری (Optional integrations)

فهرستی از سرویس‌هایی می‌آید که به کلید جداگانه نیاز دارند: ورود با Google و LinkedIn، دریافت از Google Drive، Dropbox، OneDrive و Box، و گفت‌وگو با PDF. فقط سرویس‌هایی را که کلیدشان را دارید با Space تیک بزنید و Enter بزنید؛ نصب‌کننده سپس کلید هر کدام را می‌پرسد. اگر هیچ کلیدی ندارید، فقط Enter بزنید. همه‌ی بخش‌های اصلی ابردرایو بدون این سرویس‌ها کار می‌کنند و کلیدها را بعداً هم می‌توانید با configure.sh اضافه کنید.

۹. ایمیل مدیر (Administrator)

پرسش: Email of the AbrDrive administrator.

نشانی ایمیل مدیر را بنویسید. اگر در آماده‌سازی سرور نشانی pgAdmin را داده باشید، همان به‌عنوان پیش‌فرض آمده است. حساب مدیر همین حالا ساخته می‌شود و از ابتدا تأییدشده است، پس مدیر حتی پیش از راه افتادن ایمیل هم می‌تواند وارد شود.

۱۰. رمز مدیر

پرسش: Password for ... و سپس Type the password again

رمز را دو بار وارد کنید. رمز باید دست‌کم ۸ نویسه باشد و حرف بزرگ، حرف کوچک، عدد و یک نماد داشته باشد. اگر رمز ضعیف باشد، نصب‌کننده می‌گوید چه چیزی کم دارد و دوباره می‌پرسد. این رمز را جای امنی نگه دارید؛ در فهرست رمزهای ساخته‌شده نمی‌آید، چون خودتان انتخابش کرده‌اید.

نحوه‌ی بررسی: خطی مثل ok administrator: admin@example.com چاپ می‌شود و نصب بدون پرسش دیگری ادامه پیدا می‌کند.

۱۱. بقیه‌ی کار خودکار است

پس از آخرین پاسخ، نصب‌کننده مرحله‌های ۴ تا ۱۰ را انجام می‌دهد: ساخت رمزهای داخلی، بارگذاری و بررسی سرویس‌ها، تنظیم سرویس‌ها برای دامنه‌ی شما، نصب برنامه‌ی وب، تنظیم وب‌سرور، راه‌اندازی سرویس‌ها و گرفتن گواهی HTTPS، و در آخر بررسی نتیجه. این بخش معمولاً حدود ده دقیقه طول می‌کشد. در مرحله‌ی آخر ممکن است پیام waiting for the node balancer to finish booting ببینید؛ این بخش یک دقیقه پس از شروع آماده می‌شود و نصب‌کننده منتظرش می‌ماند.

نحوه‌ی بررسی: مرحله‌ها از [4/10] Secrets تا [10/10] Verification پیش می‌روند. در مرحله‌ی آخر، زیر Endpoint checks برای هر نشانی یک کد پاسخ چاپ می‌شود.

۱۲. خواندن پیام پایانی

اگر نصب موفق باشد، این خط سبز را می‌بینید:

Platform is up on https://app.drive.example.com (role: single)

  Machine Code: XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX

• Machine Code کد دستگاه این سرور است. برای گرفتن مجوز به آن نیاز دارید؛ بعداً هم هر وقت خواستید می‌توانید دوباره ببینیدش (صفحه‌ی لایسنس).
• زیر ADMIN LOGINS رمز ابزارهای مدیریتی آمده است. همین فهرست در /opt/abrdrive/admin-credentials.txt هم ذخیره شده است.
• زیر NEEDS YOU کارهایی آمده که هنوز با شماست، مثل فرستادن کد دستگاه برای گرفتن مجوز و آزمون راه‌اندازی دوباره‌ی سرور. این فهرست را تا آخر بخوانید.

نحوه‌ی بررسی: اگر به‌جای خط سبز، نصب با FAIL متوقف شد، همان پیام را بخوانید؛ معمولاً می‌گوید چه کاری باید کرد. پس از رفع مشکل، sudo bash install.sh را دوباره اجرا کنید. اجرای دوباره بی‌خطر است: تنظیمات و رمزهای قبلی حفظ می‌شوند و فقط چیزهایی که کم است پرسیده می‌شود. جدول رفع اشکال هم مشکلات رایج را آورده است.

فایل .env را هرگز پاک نکنید

نصب‌کننده همه‌ی رمزها و کلیدهای این سرور را در /opt/abrdrive/.env می‌نویسد و این فایل تنها نسخه‌ی آن‌هاست. اگر این فایل را پاک کنید و نصب‌کننده را دوباره اجرا کنید، رمزهای تازه ساخته می‌شوند و داده‌های موجود دیگر خوانده نمی‌شوند. یک نسخه از این فایل را بیرون از سرور، در جای امنی نگه دارید.

پس از این گام، به اولین ورود و بررسی نصب بروید.