آموزش نصب Elasticsearch

نحوه نصب Elasticsearch در اوبونتو ۲۴.۰۴

نصب و ایمن‌سازی Elasticsearch روی اوبونتو ۲۴.۰۴ با پروکسی معکوس Nginx، SSL از طریق Let’s Encrypt و محدودیت‌های دسترسی محلی.

Elasticsearch یک موتور جستجوی توزیع‌ شده و متن‌باز است که بر روی Apache Lucene ساخته شده است. این موتور حجم زیادی از داده‌های ساختاریافته، بدون ساختار و برداری را با سرعت و مقیاس‌پذیری بالا ذخیره و بازیابی می‌کند. این موتور معمولاً به عنوان بخشی از Elastic Stack در کنار Logstash و Kibana برای ثبت وقایع، تجزیه و تحلیل و جستجوی متن کامل استفاده می‌شود.

در این مقاله، شما Elasticsearch را روی اوبونتو ۲۴.۰۴ نصب خواهید کرد، آن را برای دسترسی محلی امن پیکربندی خواهید کرد، عملکرد آن را آزمایش خواهید کرد و آن را با گواهی‌های SSL Let’s Encrypt و Nginx به عنوان یک پروکسی معکوس ایمن خواهید کرد.

پیش‌نیازها

قبل از شروع، شما نیاز دارید:

• به عنوان یک کاربر غیر root با دسترسی sudo به یک سرور اوبونتو ۲۴.۰۴ دسترسی داشته باشید .


• یک رکورد DNS که به آدرس IP سرور شما پوینت داده شده باشد ، مانند www.example.com.

نصب وابستگی‌ ها

برای آماده‌سازی جهت ایمن‌سازی Elasticsearch با SSL، Certbot و Nginx را نصب کنید.

1. لیست بسته‌های سیستم خود را به‌روزرسانی کنید.
   
   کنسولکپی
   
   
   $ sudo apt update
   
   
   
   


2. Certbot، Nginx و افزونه Nginx را نصب کنید.
   
   کنسولکپی
   
   
   $ sudo apt install -y certbot nginx python3-certbot-nginx
   
   
   
   

نصب الاستیک‌سرچ

Elasticsearch در مخازن بسته پیش‌فرض اوبونتو موجود نیست. مخزن رسمی Elastic APT را اضافه کنید و آن را به صورت زیر نصب کنید:

1. کلید امضای Elasticsearch GPG را وارد کنید.
   
   کنسولکپی
   
   
   $ curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | \
   sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg
   
   
   
   


2. لیست منبع APT الاستیک‌سرچ را اضافه کنید.
   
   کنسولکپی
   
   
   $ echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | \
   sudo tee /etc/apt/sources.list.d/elastic-8.x.list
   
   
   
   


3. لیست بسته‌های خود را دوباره به‌روزرسانی کنید تا مخزن جدید را شامل شود.
   
   کنسولکپی
   
   
   $ sudo apt update
   
   
   
   


4. الاستیک‌سرچ را نصب کنید.
   
   کنسولکپی
   
   
   $ sudo apt install -y elasticsearch
   
   
   
   

پیکربندی الاستیک‌ سرچ

localhostبرای جلوگیری از دسترسی خارجی، Elasticsearch را به حالت فقط شنود (listening only) محدود کنید .

1. فایل پیکربندی Elasticsearch را باز کنید.
   
   کنسولکپی
   
   
   $ sudo nano /etc/elasticsearch/elasticsearch.yml
   
   
   
   


2. خط زیر را پیدا کنید (معمولاً نزدیک به پایین) و آن را جایگزین یا اضافه کنید تا دسترسی به موارد زیر محدود شود localhost:
   
   یاملکپی
   
   
   network.host: 127.0.0.1
   
   
   
   

   تنظیم network.hostروی 127.0.0.1تضمین می‌کند که Elasticsearch در معرض شبکه‌های خارجی قرار نمی‌گیرد.

   
   

   فایل را ذخیره کنید و خارج شوید.

مدیریت سرویس Elasticsearch

سرویس Elasticsearch را مجدداً راه‌اندازی و فعال کنید تا تغییرات اعمال شود و مطمئن شوید که هنگام بوت شدن سیستم شروع به کار می‌کند.

1. برای ثبت تغییرات سرویس، systemd را مجدداً بارگذاری کنید.
   
   کنسولکپی
   
   
   $ sudo systemctl daemon-reload
   
   
   
   


2. سرویس Elasticsearch را مجدداً راه اندازی کنید.
   
   کنسولکپی
   
   
   $ sudo systemctl restart elasticsearch
   
   
   
   


3. فعال کردن شروع خودکار Elasticsearch پس از راه‌اندازی مجدد سیستم
   
   کنسولکپی
   
   
   $ sudo systemctl enable elasticsearch
   
   
   
   


4. تأیید کنید که سرویس فعال و در حال اجرا است.
   
   کنسولکپی
   
   
   $ sudo systemctl status elasticsearch
   
   
   
   

تست الاستیک‌ سرچ

با فعال کردن پورت‌های فایروال مورد نیاز، تنظیم مجدد رمز عبور پیش‌فرض کاربر و پرس‌وجو از API، تأیید کنید که Elasticsearch کار می‌کند.

1. پورت‌های HTTP و HTTPS را مجاز کنید.
   
   کنسولکپی
   
   
   $ sudo ufw allow 80/tcp
   $ sudo ufw allow 443/tcp
   
   
   
   


2. فایروال را فعال کنید.
   
   کنسولکپی
   
   
   $ sudo ufw enable
   
   
   
   


3. تأیید کنید که قوانین فعال هستند.
   
   کنسولکپی
   
   
   $ sudo ufw status
   
   
   
   

   خروجی:

   
   Status: active
   
   To Action From
   -- ------ ----
   22/tcp ALLOW Anywhere
   80/tcp ALLOW Anywhere
   443/tcp ALLOW Anywhere
   22/tcp (v6) ALLOW Anywhere (v6)
   80/tcp (v6) ALLOW Anywhere (v6)
   443/tcp (v6) ALLOW Anywhere (v6)
   


4. رمز عبور کاربر را بازنشانی کنید elastic.
   
   کنسولکپی
   
   
   $ sudo /usr/share/elasticsearch/bin/elasticsearch-reset-password -u elastic
   
   
   
   

   دستور بالا یک رمز عبور جدید برای elasticکاربر ایجاد و نمایش می‌دهد که در مرحله بعدی از آن استفاده خواهید کرد.



5. API الاستیک‌سرچ را با رمز عبور تولید شده آزمایش کنید.
   
   کنسولکپی
   
   
   $ curl -u elastic:<password> -k https://127.0.0.1:9200
   
   
   
   

   <password>برای تأیید اعتبار درخواست، مقدار تولید شده در مرحله قبل را جایگزین کنید . این -kگزینه از اعتبارسنجی گواهی SSL صرف نظر می‌کند.

   
   
   
   توجه داشته باشید
   
   

   Elasticsearch از نسخه ۸.۰ به بعد به صورت پیش‌فرض احراز هویت را فعال می‌کند. elasticبرای دسترسی به API، تنظیم مجدد رمز عبور کاربر الزامی است.

   
   
   

   پاسخ باید شبیه به این باشد:

   
   {
   "name": "negarnovin",
   "cluster_name": "elasticsearch",
   "cluster_uuid": "495uUfkmREWsiiHmXwoY5Q",
   "version": {
   "number": "8.18.2",
   "build_flavor": "default",
   "build_type": "deb",
   "build_hash": "c6b8d8d951c631db715485edc1a74190cdce4189",
   "build_date": "2025-05-23T10:07:06.210694702Z",
   "build_snapshot": false,
   "lucene_version": "9.12.1",
   "minimum_wire_compatibility_version": "7.17.0",
   "minimum_index_compatibility_version": "7.0.0"
   },
   "tagline": "You Know, for Search"
   }
   

   این تأیید می‌کند که Elasticsearch از طریق یک API امن کار می‌کند و قابل دسترسی است.

الاستیک‌ سرچ امن

برای فعال کردن دسترسی امن از راه دور، از گواهی‌های SSL رمزگذاری‌شده‌ی Let’s Encrypt به همراه پروکسی معکوس Nginx استفاده کنید.

1. یک پیکربندی پروکسی معکوس جدید برای Nginx ایجاد کنید.
   
   کنسولکپی
   
   
   $ sudo nano /etc/nginx/sites-available/elasticsearch
   
   
   
   


2. پیکربندی زیر را اضافه کنید و www.example.comبه طور مناسب جایگزین کنید.
   
   iniکپی
   
   
   server {
   listen 80;
   server_name www.example.com;
   
   location / {
   proxy_pass https://localhost:9200;
   proxy_ssl_verify off;
   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   proxy_set_header X-Forwarded-Proto $scheme;
   }
   }
   
   
   
   


3. پروکسی معکوس جدید Elasticsearch را فعال کنید.
   
   کنسولکپی
   
   
   $ sudo ln -s /etc/nginx/sites-available/elasticsearch /etc/nginx/sites-enabled/
   
   
   
   


4. Nginx را مجدداً راه اندازی کنید.
   
   کنسولکپی
   
   
   $ sudo systemctl restart nginx
   
   
   
   


5. با استفاده از Certbot درخواست گواهی TLS دهید.
   
   consoleکپی
   
   
   $ sudo certbot --nginx -d www.example.com
   
   
   
   

   پس از تکمیل درخواست، Certbot گواهی‌ها را در آدرس زیر ذخیره می‌کند:

   
   
   
   
   • /etc/letsencrypt/live/www.example.com/fullchain.pem
   
   
   • /etc/letsencrypt/live/www.example.com/privkey.pem
   
   
   
   


6. سایت پیش‌فرض Nginx را حذف کنید.
   
   کنسولکپی
   
   
   $ sudo rm /etc/nginx/sites-enabled/default
   
   
   
   


7. مرورگر خود را باز کنید و بازدید کنید https://www.example.com.شما باید یک اعلان ورود به سیستم را ببینید:
   
   

   

   
   
   
   


8. برای دسترسی به صفحه اصلی، با استفاده از نام کاربری و رمز عبور وارد شوید elastic.
   
   

   

   
   
   
   
   

   این تأیید می‌کند که Elasticsearch به طور ایمن از طریق HTTPS قابل دسترسی است.

نتیجه‌گیری

در این مقاله، شما Elasticsearch را روی اوبونتو ۲۴.۰۴ نصب کردید، دسترسی آن را به localhost محدود کردید، elasticرمز عبور کاربر را بازنشانی کردید، عملکرد API آن را تأیید کردید و با استفاده از گواهی‌های SSL Let’s Encrypt با یک پروکسی معکوس Nginx، دسترسی از راه دور را ایمن کردید. این تنظیمات، یک محیط Elasticsearch امن و آماده برای اجرا را فراهم می‌کند.

برای موارد استفاده پیشرفته و مدیریت کلاستر، به مستندات رسمی Elasticsearch مراجعه کنید .