# آموزش نصب Hashicorp Vault

- پیوند: https://negarnovin.com/docs/how-to-install-hashicorp-vault-on-ubuntu/
- منتشرشده: 2025-11-22T15:24:58+00:00
- نویسنده: نگارنوین

# نحوه نصب Hashicorp Vault در اوبونتو ۲۴.۰۴

HashiCorp Vault را روی اوبونتو ۲۴.۰۴ مستقر کنید تا بتوانید اطلاعات محرمانه را با
HTTPS و پیکربندی آماده برای تولید، به طور ایمن ذخیره، مدیریت و رمزگذاری کنید.

برنامه های مدرن به اطلاعات محرمانه، از جمله کلیدهای API، رمزهای عبور پایگاه داده،
گواهی های TLS و کلیدهای رمزگذاری متکی هستند. این اطلاعات محرمانه وقتی به صورت کدنویسی
شده، در فایل های ساده ذخیره شده یا به صورت ناامن توزیع می شوند، خطرات امنیتی جدی
ایجاد می کنند. HashiCorp Vault با ارائه یک راه حل امن و متمرکز برای مدیریت اطلاعات
حساس، این چالش را برطرف می کند. این نرم افزار ذخیره سازی اطلاعات محرمانه، تولید 
پویای اعتبارنامه، رمزگذاری به عنوان یک سرویس و کنترل دسترسی دقیق را ارائه می دهد.

[سرور مجازی فرانسه](https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D9%81%D8%B1%D8%A7%D9%86%D8%B3%D9%87/)

این مقاله نحوه راه اندازی یک سرور Vault آماده برای اجرا در اوبونتو ۲۴.۰۴ را نشان
می دهد. این مقاله نصب Vault از مخزن رسمی HashiCorp، تولید گواهی های TLS با Let’s
Encrypt، پیکربندی Vault برای عملکرد ایمن، مقداردهی اولیه آن با کلیدهای unseal و 
دسترسی به CLI و رابط کاربری وب را پوشش می دهد.

## پیش نیازها

قبل از شروع، مطمئن شوید که:

 * به عنوان یک کاربر sudo غیر ریشه به سرور اوبونتو ۲۴.۰۴ دسترسی داشته باشید.
 * یک رکورد دامنه A که به آدرس IP سرور شما اشاره می کند، پیکربندی کنید.

## نصب Vault از مخزن HashiCorp

این بخش به اضافه کردن مخزن رسمی APT شرکت HashiCorp به سیستم شما و نصب Vault می پردازد.
HashiCorp مخزن مخصوص به خود را دارد که به شما امکان دسترسی به آخرین نسخه های پایدار
را مستقیماً از فروشنده می دهد.

 1.  لیست بسته های خود را به روزرسانی کنید.
 2.  console
 3.      ```
         $ sudo apt update
         ```
     
 4.  بسته های مورد نیاز را نصب کنید.
 5.  console
 6.      ```
         $ sudo apt install gnupg curl lsb-release -y
         ```
     
 7.  کلید GPG شرکت HashiCorp را اضافه کنید. این کلید تأیید می کند که بسته ها واقعاً
     از شرکت HashiCorp می آیند.
 8.  console
 9.      ```
         $ curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
         ```
     
 10. مخزن HashiCorp را به منابع سیستم خود اضافه کنید.
 11. console
 12.     ```
         $ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
         ```
     
 13. شاخص بسته را به روزرسانی کنید.
 14. console
 15.     ```
         $ sudo apt update
         ```
     
 16. والت را نصب کنید.
 17. console
 18.     ```
         $ sudo apt install vault -y
         ```
     
 19. نصب را تأیید کنید.
 20. console
 21.     ```
         $ vault --version
         ```
     
 22. خروجی:
 23.     ```
         Vault v1.20.4 (55bd8f18c6c84aa89fdede4850a622c57f03bd7e), built 2025-09-23T13:22:38Z
         ```
     
 24. تکمیل خودکار پوسته را برای گاوصندوق فعال کنید.
 25. console
 26.     ```
         $ vault -autocomplete-install
         ```
     
 27. برای اعمال تکمیل خودکار، پوسته خود را مجدداً بارگذاری کنید.
 28. console
 29.     ```
         $ exec $SHELL
         ```
     

## پیکربندی دسترسی فایروال

در این بخش، پورت های لازم را در فایروال باز کنید تا Vault قابل دسترسی باشد. مراحل
پیکربندی UFW برای دسترسی HTTPS به Vault به شرح زیر است.

 1.  دسترسی HTTPS را روی پورت ۸۲۰۰ که رابط کاربری وب Vault در آن اجرا می شود، مجاز 
     کنید.
 2.  console
 3.      ```
         $ sudo ufw allow 8200/tcp
         ```
     
 4.  پورت ۸۰ را موقتاً باز کنید تا Certbot بتواند گواهی های TLS صادر کند.
 5.  console
 6.      ```
         $ sudo ufw allow 80/tcp
         ```
     
 7.  فایروال را دوباره بارگذاری کنید.
 8.  console
 9.      ```
         $ sudo ufw reload
         ```
     

## تولید گواهی های TLS با Let’s Encrypt

این بخش به دریافت گواهینامه های TLS با استفاده از Certbot می پردازد. برای دریافت
گواهینامه های رایگان از Let’s Encrypt، Certbot را نصب و استفاده کنید.

 1.  Certbot را نصب کنید.
 2.  console
 3.      ```
         $ sudo apt install certbot -y
         ```
     
 4.  برای دامنه خود یک گواهی دریافت کنید. به جای  `vault.example.com`  دامنه واقعی 
     خود و به جای your- `your-email@example.com`  آدرس ایمیل خود را قرار دهید.
 5.  console
 6.      ```
         $ sudo certbot certonly --standalone -d vault.example.com --non-interactive --agree-tos --email your-email@example.com
         ```
     
 7.  پس از دریافت گواهینامه های TLS، قانون پورت ۸۰ را از فایروال خود حذف کنید.
 8.  console
 9.      ```
         $ sudo ufw delete allow 80/tcp
         ```
     
 10. فایروال را دوباره بارگذاری کنید.
 11. console
 12.     ```
         $ sudo ufw reload
         ```
     
 13. یک دایرکتوری برای گواهی های Vault ایجاد کنید.
 14. console
 15.     ```
         $ sudo mkdir -p /opt/vault/tls
         ```
     
 16. گواهی های Let’s Encrypt را در دایرکتوری Vault کپی کنید. به جای  `vault.example.
     com` ، نام دامنه خود را قرار دهید.
 17. console
 18.     ```
         $ sudo cp /etc/letsencrypt/live/vault.example.com/fullchain.pem /opt/vault/tls/cert.pem
         ```
     
 19. کلید خصوصی را کپی کنید.  `vault.example.com` را با نام دامنه خود جایگزین کنید.
 20. console
 21.     ```
         $ sudo cp /etc/letsencrypt/live/vault.example.com/privkey.pem /opt/vault/tls/key.pem
         ```
     
 22. مالکیت صحیح را برای گواهی ها تعیین کنید.
 23. console
 24.     ```
         $ sudo chown -R vault:vault /opt/vault/tls
         ```
     
 25. مجوزهای محدودکننده ای را روی فایل های گواهی تنظیم کنید.
 26. console
 27.     ```
         $ sudo chmod 600 /opt/vault/tls/cert.pem /opt/vault/tls/key.pem
         ```
     
 28. یک اسکریپت تمدید خودکار گواهینامه ایجاد کنید.
 29. console
 30.     ```
         $ sudo tee /etc/letsencrypt/renewal-hooks/deploy/vault.sh > /dev/null << 'EOF'
         #!/bin/bash
         cp /etc/letsencrypt/live/vault.example.com/fullchain.pem /opt/vault/tls/cert.pem
         cp /etc/letsencrypt/live/vault.example.com/privkey.pem /opt/vault/tls/key.pem
         chown -R vault:vault /opt/vault/tls
         chmod 600 /opt/vault/tls/*
         systemctl reload vault
         EOF
         ```
     
 31. اسکریپت تمدید را قابل اجرا کنید.
 32. console
 33.     ```
         $ sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/vault.sh
         ```
     

## پیکربندی Vault برای محیط عملیاتی

🇫🇷 [**سرور فرانسه**](https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D9%81%D8%B1%D8%A7%D9%86%D8%B3%D9%87/)
🇫🇷

این بخش پیکربندی Vault برای استفاده در محیط عملیاتی را پوشش می دهد. فایل پیکربندی،
نحوه عملکرد Vault، از جمله backend ذخیره سازی، شنودکنندگان شبکه و تنظیمات امنیتی
را کنترل می کند.

 1.  از فایل پیکربندی اصلی پشتیبان تهیه کنید.
 2.  console
 3.      ```
         $ sudo cp /etc/vault.d/vault.hcl /etc/vault.d/vault.hcl.backup
         ```
     
 4.  یک پیکربندی عملیاتی ایجاد کنید.  `vault.example.com`  را با دامنه واقعی خود جایگزین
     کنید.
 5.  console
 6.      ```
         $ sudo tee /etc/vault.d/vault.hcl > /dev/null << 'EOF'
         # Vault production configuration
     
         # Enable the web UI
         ui = true
     
         # Disable memory locking (set to false if you have limited RAM)
         disable_mlock = true
     
         # Storage backend - uses local filesystem
         storage "file" {
          path = "/opt/vault/data"
         }
     
         # HTTPS listener
         listener "tcp" {
          address = "0.0.0.0:8200"
          tls_cert_file = "/opt/vault/tls/cert.pem"
          tls_key_file = "/opt/vault/tls/key.pem"
     
          # Enforce minimum TLS version
          tls_min_version = "tls12"
     
          # Use secure cipher suites
          tls_cipher_suites = "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"
     
          # Do NOT require client certificates
          tls_require_and_verify_client_cert = "false"
          tls_disable_client_certs = "true"
         }
     
         # Advertise the correct address to other Vault nodes
         api_addr = "https://vault.example.com:8200"
         cluster_addr = "https://vault.example.com:8201"
         EOF
         ```
     
 7.  سرویس Vault را طوری فعال کنید که هنگام بوت شدن سیستم شروع به کار کند.
 8.  console
 9.      ```
         $ sudo systemctl enable vault
         ```
     
 10. سرویس Vault را با پیکربندی جدید مجدداً راه اندازی کنید.
 11. console
 12.     ```
         $ sudo systemctl restart vault
         ```
     
 13. بررسی کنید که Vault با موفقیت شروع به کار کرده باشد.
 14. console
 15.     ```
         $ sudo systemctl status vault
         ```
     
 16. خروجی باید نشان دهد:
 17.     ```
         ● vault.service - "HashiCorp Vault - A tool for managing secrets"
          Loaded: loaded (/usr/lib/systemd/system/vault.service; enabled; preset: enabled)
          Active: active (running) since Thu 2025-10-02 22:15:08 UTC; 3s ago
         ...
         ```
     

## محیط Vault را تنظیم کنید

این بخش نحوه پیکربندی متغیرهای محیطی را نشان می دهد که به رابط خط فرمان (CLI) می
گویند سرور Vault شما را کجا پیدا کند.

 1.  متغیر محیطی آدرس Vault را تنظیم کنید.  `vault.example.com`  را با دامنه خود جایگزین
     کنید.
 2.  console
 3.      ```
         $ echo 'export VAULT_ADDR="https://vault.example.com:8200"' >> ~/.bashrc
         ```
     
 4.  پیکربندی پوسته خود را مجدداً بارگذاری کنید.
 5.  console
 6.      ```
         $ source ~/.bashrc
         ```
     
 7.  بررسی کنید که متغیر به درستی تنظیم شده باشد.
 8.  console
 9.      ```
         $ echo $VAULT_ADDR
         ```
     
 10. خروجی:
 11.     ```
         https://vault.example.com:8200
         ```
     
 12. اتصال به Vault را آزمایش کنید.
 13. console
 14.     ```
         $ vault status
         ```
     
 15. خروجی:
 16.     ```
         Key Value
         --- -----
         Seal Type shamir
         Initialized false
         Sealed true
         ```
     

## مقداردهی اولیه و باز کردن مهر و موم گاوصندوق

این بخش به مقداردهی اولیه Vault برای تولید کلیدهای رمزگذاری و باز کردن قفل آن برای
عملیاتی شدن می پردازد. Vault در حالت قفل شده شروع به کار می کند، جایی که می داند
داده هایش کجا ذخیره شده اند اما نمی تواند آنها را رمزگشایی کند.

### درک فرآیند

وقتی Vault را مقداردهی اولیه می کنید، موارد زیر را ایجاد می کند:

 * **Master key**: تمام اسرار شما را رمزگذاری می کند
 * **Unseal keys**: بخش هایی از کلید اصلی با استفاده از الگوریتم اشتراک گذاری مخفی
   شمیر جدا می شوند
 * **Root token**: دسترسی اولیه شما به عنوان مدیر

تنظیمات پیش فرض ۵ کلید با آستانه ۳ ایجاد می کند. این یعنی برای باز کردن قفل Vault
به ۳ کلید از ۵ کلید نیاز دارید. این کار مانع از دسترسی کامل هر فرد به آن می شود.

 1.  Vault را با پیکربندی پیش فرض راه اندازی کنید.
 2.  console
 3.      ```
         $ vault operator init
         ```
     
 4.  خروجی:
 5.      ```
         Unseal Key 1: nk+b+gZRPzUcTx5yDaY7Rxv26m/JqPuuhlYKVLxqvcLV
         Unseal Key 2: kXi4dk1pDpTj0efjPekMMEnqMFIGVbbIECyAbYXu4XIi
         Unseal Key 3: jPyTlTCeKAMHu16+EYHc6FcmqW+hQ8B9ZN02vQ8VnOmd
         Unseal Key 4: 5rvMMnEvcIQdcAtKd+UxQX7FqsDbMEtuHqRijFlyjR9l
         Unseal Key 5: igcpq67F04IhxzAFQ/i+VbC5+vPSRNY5Zsg/xHu+qgID
     
         Initial Root Token: hvs.4H1RRGrHO8cbu2QumVuXUfOV
         ...
         ```
     
 6.  نکته
 7.  این کلیدها را در مکان های جداگانه و امن ذخیره کنید، زیرا دیگر هرگز آنها را نخواهید
     دید.
 8.  با اولین کلید، شروع به باز کردن قفل Vault کنید. شما باید این دستور را ۳ بار با
     ۳ کلید مختلف اجرا کنید.
 9.  console
 10.     ```
         $ vault operator unseal
         ```
     
 11. وقتی از شما خواسته شد، اولین کلید را وارد کنید. خروجی، پیشرفت کار را نشان می دهد:
 12.     ```
         ...
         Unseal Progress 1/3
         ...
         ```
     
 13. با کلید دوم ادامه دهید.
 14. console
 15.     ```
         $ vault operator unseal
         ```
     
 16. خروجی:
 17.     ```
         ...
         Unseal Progress 2/3
         ...
         ```
     
 18. برای تکمیل باز کردن قفل از کلید سوم استفاده کنید.
 19. console
 20.     ```
         $ vault operator unseal
         ```
     
 21. وقتی موفق شدید، خواهید دید:
 22.     ```
         ...
         Sealed false
         ...
         ```
     
 23. نکته
 24. اگر باز کردن قفل ناموفق بود، مطمئن شوید که از ۳ کلید مختلف استفاده می کنید و نه
     کلیدهای یکسان.
 25. با توکن ریشه وارد شوید.
 26. console
 27.     ```
         $ vault login
         ```
     
 28. در صورت درخواست، توکن ریشه اولیه (Initial Root Token) را وارد کنید.

## به رابط کاربری وب Vault دسترسی پیدا کنید

این بخش نحوه دسترسی به رابط وب Vault را نشان می دهد که روشی بصری و شهودی برای مدیریت
اسرار در کنار رابط خط فرمان (CLI) فراهم می کند.

 1. این بخش نحوه دسترسی به رابط وب Vault را نشان می دهد که روشی بصری و شهودی برای مدیریت
    اسرار در کنار رابط خط فرمان (CLI) فراهم می کند.
 2.     ```
        https://vault.example.com:8200
        ```
    
 3. صفحه ورود به سیستم Vault را مشاهده خواهید کرد. **Token** را به عنوان روش انتخاب
    کنید.
 4. توکن ریشه خود را وارد کنید و روی **Sign In **کلیک کنید.
 5. داشبورد، وضعیت گنجینه شما و موتورهای اسرار موجود را نشان می دهد.

## در نهایت

اکنون شما یک نصب آماده برای تولید Vault روی اوبونتو ۲۴.۰۴ با رمزگذاری مناسب TLS 
و دسترسی به رابط خط فرمان (CLI) و وب دارید. سرور Vault شما آماده است تا اطلاعات 
محرمانه زیرساخت شما را به طور ایمن ذخیره و مدیریت کند. برای اطلاعات بیشتر به مستندات
Vault مراجعه کنید.
