راهاندازی OpenBao روی سرور مجازی و اختصاصی: جایگزین متنباز HashiCorp Vault برای مدیریت امن رمزها
سال ۲۰۲۳ وقتی HashiCorp مجوز Vault را از MPL به BUSL تغییر داد، بخشی از جامعه کاربران آن یک نسخه کاملا متنباز را زیر نظر Linux Foundation فورک کردند و اسمش را OpenBao گذاشتند. نتیجه، ابزاری است که تقریبا همان API و همان دستورها را دارد، اما بدون قید و بند لایسنس تجاری. اگر دنبال یک صندوق رمز هستید که رمز پایگاه داده، کلید API و گواهی TLS را رمزنگاریشده نگه دارد و دسترسی به آنها را با Policy کنترل کند، OpenBao گزینهای است که میتوانید همین حالا روی سرور خودتان نصب کنید.
در این آموزش نصب OpenBao را از پکیج رسمی تا initialize کردن و ذخیره اولین رمز روی لینوکس پیش میرویم. نمونهها روی Ubuntu 24.04 تست شدهاند؛ روی Debian هم همین دستورها کار میکنند.

OpenBao چیست و چه فرقی با Vault دارد
OpenBao یک پروژه Sandbox زیر نظر Linux Foundation است، نه محصول یک شرکت. کد اولیه همان کدبیس Vault بود، برای همین دستورها، فرمت Policy و اغلب موتورهای secrets تا حد زیادی یکسان ماندهاند؛ تفاوت اصلی در نام باینری (bao بهجای vault) و متغیرهای محیطی است. طبق داکیومنت رسمی OpenBao، پیشوند BAO_ برای متغیرهایی مثل آدرس سرور ترجیح داده میشود، اما اگر VAULT_ADDR از قبل تنظیم باشد همان را هم میپذیرد — همین نکته جابهجایی از Vault را راحت میکند.
چیزی که در عمل بیشترین اهمیت را دارد مجوز است: Vault از نسخههای جدید زیر BUSL قرار دارد و قابلیتهای enterprise را پشت لایسنس تجاری میگذارد. OpenBao با مجوز MPL 2.0 کاملا متنباز است و تصمیمگیری دربارهٔ نقشه راه آن در یک کمیتهٔ فنی باز انجام میشود، نه داخل یک شرکت.
پیشنیازهای نصب OpenBao روی سرور
برای تست، یک سرور مجازی با یک هسته پردازنده و ۲ گیگابایت RAM کافی است. برای محیط عملیاتی با چند سرویس مصرفکننده، منابع بیشتر و دیسک پایدار (ترجیحا SSD) لازم است. پیشنیازها:
- Ubuntu یا Debian بهروز با دسترسی sudo
- دامنه و گواهی TLS معتبر
- ساعت سیستم همگام با NTP
- فایروال با دسترسی کنترلشده به پورت ۸۲۰۰
- یک دسترسی SSH امنسازیشده جدا برای مدیران سیستم
OpenBao را روی همان سروری که برنامه اصلی اجرا میشود نصب نکنید، مگر در محیط توسعه. برای بار کاری حساس یا چند تیم که همزمان به صندوق رمز نیاز دارند، یک سرور اختصاصی با دیسک و شبکه مجزا کنترل بیشتری روی I/O و تماسهای شبکه میدهد؛ برای تیمهای کوچک یا محیط staging، یک سرور مجازی معمولی کفایت میکند.
نصب OpenBao روی لینوکس
برخلاف Vault، OpenBao هنوز مخزن apt رسمی خودش ندارد؛ نصب از همان فایل .deb منتشرشده در GitHub Releases انجام میشود. آخرین نسخه را بررسی و دانلود کنید:
VERSION=$(curl -s https://api.github.com/repos/openbao/openbao/releases/latest | grep -o '"tag_name": *"v[^"]*"' | cut -d'"' -f4 | tr -d v)
curl -LO "https://github.com/openbao/openbao/releases/download/v${VERSION}/openbao_${VERSION}_linux_amd64.deb"
پیش از نصب، چکسام فایل را با checksums.txt منتشرشده در همان ریلیز مقایسه کنید؛ OpenBao این فایلها را با GPG و sigstore هم امضا میکند. سپس بسته را نصب کنید:
sudo dpkg -i openbao_${VERSION}_linux_amd64.deb
نسخه نصبشده را بررسی کنید:
bao version
پکیج رسمی بهصورت پیشفرض کاربر سیستمی openbao، فایل سرویس openbao.service و مسیر پیکربندی /etc/openbao/openbao.hcl را میسازد؛ کاری که در Vault باید دستی انجام میشد، اینجا همراه پکیج میآید.
پیکربندی Storage و Listener
فایل پیشفرض /etc/openbao/openbao.hcl یک backend به اسم pebbledb دارد — موتور ذخیرهسازی embedded خود OpenBao، مناسب یک نود تنها:
ui = true
storage "pebbledb" {
path = "/opt/openbao/data"
}
listener "tcp" {
address = "0.0.0.0:8200"
tls_cert_file = "/opt/openbao/tls/tls.crt"
tls_key_file = "/opt/openbao/tls/tls.key"
}
برای یک نود تنها همین کافی است. اگر بعدا به چند نود و دسترسپذیری بالا نیاز شد، به storage backend نوع Raft مهاجرت کنید:
storage "raft" {
path = "/opt/openbao/data"
node_id = "openbao-1"
}
cluster_addr = "https://openbao.example.com:8201"
Raft در OpenBao از همان نسخههای جدید برای HA و مقیاسپذیری افقی production-ready اعلام شده و از paginated list و تراکنشهای storage هم پشتیبانی میکند. برای نصب یکسان همین تنظیمات روی چند نود، اتوماسیون پیکربندی چند سرور با Ansible زمان زیادی صرفهجویی میکند.
مسیر داده را فقط برای کاربر openbao و مدیران مورد اعتماد قابلخواندن کنید:
sudo chown -R openbao:openbao /opt/openbao
sudo chmod 750 /opt/openbao/data
فعالسازی HTTPS و فایروال
گواهی TLS را از Let's Encrypt یا یک مرجع داخلی تهیه و در مسیر مشخصشده در تنظیمات قرار دهید:
sudo mkdir -p /opt/openbao/tls
sudo cp fullchain.pem /opt/openbao/tls/tls.crt
sudo cp privkey.pem /opt/openbao/tls/tls.key
sudo chown -R openbao:openbao /opt/openbao/tls
sudo chmod 600 /opt/openbao/tls/tls.key
اگر پشت Nginx قرار میگیرد، TLS را همانجا خاتمه ندهید و اتصال Nginx تا OpenBao را هم HTTPS نگه دارید؛ فرستادن توکن روی HTTP داخلی در شبکهای با چند سرویس انتخاب امنی نیست. فایروال را محدود کنید؛ پورت ۸۲۰۰ فقط از شبکه مدیریت و سرویسهای مصرفکننده و پورت ۸۲۰۱ (در حالت Raft) فقط میان نودهای OpenBao باز بماند:
sudo ufw allow from 203.0.113.10 to any port 8200 proto tcp
sudo ufw allow from 10.10.0.0/16 to any port 8200 proto tcp
sudo ufw enable
برای قوانین دقیقتر یا مهاجرت از iptables، راهاندازی فایروال nftables نقطه شروع خوبی است.
اجرا و Initialize کردن OpenBao
سرویس را فعال کنید:
sudo systemctl enable openbao
sudo systemctl start openbao
sudo systemctl status openbao
واحد سرویس همراه پکیج از قبل MemorySwapMax=0 دارد، یعنی حافظهٔ فرآیند OpenBao روی دیسک swap نمیشود — بدون تنظیم دستی اضافه.
آدرس سرور را برای CLI تنظیم کنید:
export BAO_ADDR="https://openbao.example.com:8200"
bao status
در اولین اجرا OpenBao initialize نیست. دستور زیر ساختار رمزنگاری را میسازد:
bao operator init -key-shares=5 -key-threshold=3
خروجی پنج کلید Unseal و یک توکن root اولیه میدهد. اینها را در چت یا فایل متنی ذخیره نکنید؛ هر کلید را نزد یک فرد یا سامانهٔ جدا نگه دارید. برای باز کردن قفل، دستور زیر را سه بار با سه کلید متفاوت اجرا کنید:
bao operator unseal
سپس با توکن اولیه وارد شوید:
bao login
توکن root را فقط برای bootstrap نگه دارید؛ برای کارهای روزمره Policy محدود بسازید.
ذخیره رمزها با KV Secrets Engine
موتور KV نسخه ۲ را فعال کنید:
bao secrets enable -path=secret kv-v2
یک مقدار آزمایشی ذخیره کنید:
bao kv put secret/shop \
db_username="shop_app" \
db_password="رمز-طولانی-و-تصادفی" \
payment_api_key="کلید-درگاه"
و برای خواندن آن:
bao kv get secret/shop
KV v2 نسخههای قبلی مقدار را نگه میدارد و بازگردانی یا حذف نرم را ممکن میکند. اسرار را بر اساس برنامه و محیط جدا کنید، مثلا secret/shop/production و secret/shop/staging؛ رمزها را در خروجی CI یا لاگ برنامه چاپ نکنید.
تعریف Policy با کمترین سطح دسترسی
فایل shop-read.hcl را بسازید:
path "secret/data/shop" {
capabilities = ["read"]
}
path "secret/metadata/shop" {
capabilities = ["read", "list"]
}
Policy را بارگذاری کنید:
bao policy write shop-read shop-read.hcl
از اعطای sudo، create یا delete به برنامهای که فقط باید رمز را بخواند خودداری کنید. برای یک اتصال سریع میتوانید یک توکن محدود بسازید:
bao token create -policy=shop-read -ttl=24h -renewable=true
در محیط عملیاتی، روش احراز هویت ماشینی مثل AppRole معمولا بهتر از توکن ثابت است؛ شناسه نقش و secret جدا دارد و هر دو را میتوان با چرخهٔ عمر کوتاه مدیریت کرد.
OpenBao در برابر HashiCorp Vault
| ویژگی | OpenBao | HashiCorp Vault |
|---|---|---|
| مجوز | متنباز، MPL 2.0 | هسته BSL/BUSL، enterprise تجاری |
| حاکمیت | پروژهٔ Linux Foundation، کمیتهٔ فنی باز | شرکت HashiCorp (اکنون زیر IBM) |
| باینری و دستورها | bao، همان ساختار دستورهای Vault | vault |
| متغیر آدرس | BAO_ADDR، با عقبگرد به VAULT_ADDR | VAULT_ADDR |
| نصب روی Ubuntu/Debian | دانلود مستقیم .deb از ریلیز | مخزن apt رسمی |
| Storage backend | Raft (HA) یا PebbleDB (تکنود) | Raft یا Integrated/خارجی متعدد |
برای یک پروژه تازه که فقط به KV، Policy و Raft نیاز دارد، تفاوت عملی کم است. تصمیم معمولا به مجوز و این برمیگردد که میخواهید روی کد یک پروژهٔ تجاری یا یک پروژهٔ community-governed شرط ببندید.
پشتیبانگیری، مانیتورینگ و عملیات روزانه
اگر از Raft استفاده میکنید، snapshot زمانبندیشده بگیرید:
export BAO_TOKEN="توکن-مدیریتی-محدود"
bao operator raft snapshot save /var/backups/openbao-$(date +%F).snap
فایل را به مقصدی جدا از سرور اصلی منتقل کنید و بازیابی را دورهای در یک محیط آزمایشی تست کنید. Audit log را هم فعال کنید:
bao audit enable file file_path=/var/log/openbao_audit.log
دسترسی این فایل را محدود و چرخش آن را با logrotate تنظیم کنید، چون مسیرها و شناسههای حساس در آن ثبت میشوند. وضعیت سرویس، فضای دیسک، زمان پاسخ API و وضعیت Seal را مانیتور کنید؛ راهاندازی مانیتورینگ سرور با Prometheus و Grafana نقطهٔ شروع مناسبی برای این بخش است و برای جمعآوری متمرکز لاگ از چند نود میتوانید راهاندازی لاگ متمرکز با Grafana Loki و Alloy را هم ببینید.
خطاهای رایج در نصب OpenBao
فرض وجود مخزن apt: کسانی که از Vault میآیند انتظار apt install openbao را دارند؛ تا امروز باید .deb را مستقیم از GitHub Releases دانلود کرد.
رد شدن از چکسام: چون نصب از فایل دانلودی انجام میشود، نادیده گرفتن تطبیق checksums.txt ریسک نصب یک باینری دستکاریشده را بالا میبرد.
تصور HA با PebbleDB: backend پیشفرض پکیج تکنود است؛ برای خوشه و دسترسپذیری بالا باید صریحا به Raft تغییر کنید.
نگهداری همهٔ کلیدهای Unseal در یک مکان: هدف تقسیم کلید را از بین میبرد و ریسک سرقت را بالا میبرد.
باز گذاشتن پورت ۸۲۰۰ برای اینترنت: رمز عبور قوی جایگزین محدودسازی شبکه نیست.
جمعبندی
نصب OpenBao با دانلود پکیج تمام نمیشود؛ باید Storage مناسب (PebbleDB یا Raft)، HTTPS، فایروال، فرآیند Unseal، Policy حداقلی و audit log را کنار هم بچینید. برای شروع یک نود تنها را در محیط آزمایشی راه بیندازید، بعد با توجه به نیاز HA به Raft و چند نود مهاجرت کنید.
اگر OpenBao را برای بار کاری حساس با چند سرویس مصرفکننده راهاندازی میکنید و به دیسک پرسرعت و شبکهٔ پایدار روی یک زیرساخت اختصاصی نیاز دارید، مشخصات سرورهای اختصاصی آریانت را بررسی کنید؛ برای تست یا تیمهای کوچک، یک سرور مجازی معمولی هم کافی است.
سؤالات متداول
آیا OpenBao رایگان است؟ بله، کاملا متنباز با مجوز MPL 2.0 و زیر نظر Linux Foundation. برخلاف Vault که قابلیتهای enterprise را پشت لایسنس تجاری میگذارد، در OpenBao همه قابلیتها بدون هزینه لایسنس در دسترس است.
آیا دستورهای Vault مستقیم روی OpenBao کار میکنند؟
تا حد زیادی بله، چون API مشترک است؛ فقط باینری bao را بهجای vault صدا میزنید. متغیر BAO_ADDR ترجیح دارد، ولی اگر VAULT_ADDR تنظیم باشد همان را هم میپذیرد.
برای شروع به سرور اختصاصی نیاز دارم یا سرور مجازی کافی است؟ برای تست و تیمهای کوچک یک سرور مجازی با چند گیگابایت RAM کافی است. برای بار کاری حساس یا خوشهٔ Raft چندنودی، سرور اختصاصی با دیسک و شبکهٔ مجزا کنترل بیشتری میدهد.
جابهجایی رمزها از Vault به OpenBao چقدر سخت است؟ بسته به نسخه و نوع storage متفاوت است. پیش از هر اقدام، یک snapshot کامل بگیرید و مهاجرت را اول در یک محیط آزمایشی جدا تست کنید، نه مستقیم روی سرویس عملیاتی.




