نصب و پیکربندی

مباشر با Docker Compose روی سرور خودتان اجرا می‌شود. این صفحه برای مدیران سرور است.

سرویس‌ها#

سرویس	نقش
`dana`	برنامهٔ اصلی (رابط و API)
`dana-db`	PostgreSQL با افزونهٔ pgvector (برای دانش)
`dana-redis`	کش و صف
`dana-runtime`	اجرای برنامه‌های ساخته‌شده
`opensandbox-server`	محیط ایزوله برای دستیار هوشمند
`dana-docs`	همین مرکز راهنما (`docs.mobaasher.it`)
`dana-pdf`	(اختیاری، پروفایل `pdf`) تولید PDF فارسی
`dana-templates`	(اختیاری، پروفایل `templates`) ساخت دستی قالب‌ها

راه‌اندازی#

cp .env.example .env
# مقدارهای محرمانه را بسازید: openssl rand -hex 24  (کلیدهای ذخیره‌سازی: openssl rand -hex 8)
docker compose up -d --build

متغیرهای مهم#

متغیر	معنی
`PUBLIC_ORIGIN`	آدرس عمومی برنامه (برای لینک‌ها و بازگشت از درگاه)
`TENANCY_BASE_DOMAIN`	روشن کردن حالت چندفضایی (`نام.دامنه`)؛ خالی = خاموش
`BACKEND_TRUST_PROXY`	وقتی پشت Caddy/Nginx هستید: `1`
`APPS_DOMAIN`	دامنهٔ برنامه‌های منتشرشده (wildcard DNS لازم است)
`ZARINPAL_MERCHANT_ID`	درگاه فروش اشتراک؛ خالی = پرداخت غیرفعال
`PAYMENT_PUBLIC_ORIGIN`	دامنهٔ بازگشت پرداخت رکوردها
`PDF_RENDERER_URL`	آدرس سرویس PDF، مثلاً `http://dana-pdf:3000`
`PHONE_AUTH_*`	ورود با پیامک
`KNOWLEDGE_EMBEDDING_MODEL`	مدل embedding پیش‌فرض برای دانش
`DANA_HTTP_PROXY`, `DANA_NODE_USE_ENV_PROXY`, `DANA_NO_PROXY`	عبور تماس‌های LLM از پروکسی
`API_DOCS_SCALAR_URL`	نسخهٔ خودمیزبان مستندات API
`COMMERCE_PLANS`	فهرست طرح‌ها (JSON، قیمت به تومان)؛ خالی = پیش‌فرض
`DOCS_PORT`	درگاه میزبان برای مرکز راهنما (پیش‌فرض ۳۱۰۰)

مرکز راهنما (docs.mobaasher.it)#

سرویس dana-docs این سایت را از پوشهٔ docs-site/ می‌سازد و روی درگاه DOCS_PORT سرو می‌کند. کافی است در Caddy/Nginx دامنهٔ docs.mobaasher.it را به آن پروکسی کنید:

docs.mobaasher.it {
    reverse_proxy 127.0.0.1:3100
}

لینک‌های «راهنما» در برنامه به همین دامنه اشاره می‌کنند. برای تغییر دامنه، هنگام ساخت از آرگومان DOCS_ORIGIN استفاده کنید و آدرس‌های راهنما در فایل‌های زبان برنامه را نیز عوض کنید.

پروکسی و TLS#

پروکسی باید هدرهای X-Forwarded-* را بازنویسی کند، نه عبور بدهد.
برای زیردامنه‌های فضاهای کاری، TLS درخواستی (on-demand) Caddy با نقطهٔ بررسی سرور مباشر پیکربندی می‌شود.

پشتیبان‌گیری#

از حجم‌های dana-db-data (پایگاه داده) و dana-assets (پیوست‌ها) و فایل .env نسخهٔ پشتیبان بگیرید. کلیدهای BACKEND_STORAGE_ENCRYPTION_* را گم نکنید؛ بدون آن‌ها پیوست‌ها خوانا نیستند.

برای شرایط تحریم و قطعی: کار در شرایط تحریم و قطعی.