خدمات IT هزاره سوم

مشاوره، طراحی، توسعه شبکه، سایت، سئوی خود را به ما بسپارید.

WebDev📅 ۲۹ آبان ۱۴۰۵⏱ 8 دقیقه مطالعه💬 0 دیدگاه
راهنما
۲۹ آبان ۱۴۰۵سرور و میزبانی7 دقیقه مطالعه

نکات کلیدی

  • “`ini [options] db_host = False db_port = False db_user = odoo db_password = False addons_path = /usr/lib/python3/dist-packages/odoo/addons logfile = /var/log/odoo/odoo.log admin_passwd = <رمز_تصادفی> list_db = False “`
  • location /websocket { proxy_pass proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection “upgrade”; proxy_set_header Host $host; proxy_read_timeout 86400; } } “`
  • دستور `odoo -d <db_name> -u all –dump` به صورت پیش فرض فایل ZIP شامل دیتابیس و filestore تولید می کند؛ با گزینه `–no-filestore` فقط دیتابیس را بکاپ می گیرد.

مقدمه

نصب Odoo بر روی اوبونتو 24.04 با استفاده از مخزن رسمی فقط چهار دستور است، اما نکات کلیدی امنیتی و پیکربندی می‌تواند تجربهٔ شما را بهبود بخشد. در این راهنما به‌صورت مرجع، مراحل نصب، تنظیمات ضروری و نکات مهم را مرور می‌کنیم.


نکات امنیتی اولیه

  • غیرفعال کردن مدیر دیتابیس (`list_db = False`) در فایل `odoo.conf` توصیه می‌شود.
  • رمز عبور پیش‌فرض `admin_passwd` باید به‌صورت تصادفی و قوی تعیین شود.
  • دسترسی مستقیم به پورت‌های پیش‌فرض Odoo (8069) از طریق فایروال محدود گردد.

مراحل نصب با بستهٔ deb

  1. نصب پیش‌نیازها

“`bash sudo apt update sudo apt install -y python3 python3-pip python3-dev build-essential \ libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev libssl-dev \ libffi-dev libjpeg-dev libpq-dev libmysqlclient-dev “`

  1. نصب PostgreSQL

“`bash sudo apt install -y postgresql sudo -u postgres createuser -s odoo “`

  1. دانلود و نصب بستهٔ Odoo 20

“`bash wget sudo dpkg -i odoo_20.0.0_all.deb “`

  1. پیکربندی فایل `odoo.conf`

“`ini [options] db_host = False db_port = False db_user = odoo db_password = False addons_path = /usr/lib/python3/dist-packages/odoo/addons logfile = /var/log/odoo/odoo.log admin_passwd = <رمز_تصادفی> list_db = False “`

  1. راه‌اندازی سرویس

“`bash sudo systemctl enable –now odoo “`


پیکربندی Nginx برای WebSocket

  • مسیر `/websocket` را به پورت 8072 هدایت کنید.
  • مثال تنظیمات Nginx:

“`nginx upstream odoo { server 127.0.0.1:8069; }

server { listen 80; server_name yourdomain.com;

location / { proxy_pass 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; }

location /websocket { proxy_pass proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection “upgrade”; proxy_set_header Host $host; proxy_read_timeout 86400; } } “`


انتخاب نسخهٔ مناسب

ویژگی Community Enterprise
حسابداری (دفتر کل، تطبیق بانکی) ❌ ✅
فروش، انبار، فاکتور ✅ ✅
مجوز LGPLv3 Enterprise License

برای شرکت‌های کوچک و متوسط، نسخهٔ Community با امکانات فروش، انبار و فاکتور کافی است. اگر نیاز به حسابداری پیشرفته دارید، نسخهٔ Enterprise را در نظر بگیرید.


تولید فاکتور PDF

  • نصب `wkhtmltopdf` نسخهٔ 0.12.6.1-3 (برای اوبونتو 24.04)

“`bash sudo apt install -y wkhtmltopdf “`

  • پیکربندی قالب فاکتور در Odoo برای افزودن سربرگ و پانویس.

نکات کلیدی

  • پشتیبان‌گیری: بکاپ دیتابیس همراه با `filestore` را به‌صورت منظم انجام دهید.
  • محدودیت کاربران: تعداد ورکرها را بر اساس هسته‌های CPU و تعداد کاربران تنظیم کنید.
  • به‌روزرسانی: نسخهٔ Odoo را بر اساس مستندات رسمی (۲۰.۰) به‌روزرسانی کنید.

جمع‌بندی

نصب Odoo 20 بر روی اوبونتو 24.04 با بستهٔ deb ساده است، اما رعایت نکات امنیتی، پیکربندی صحیح Nginx و انتخاب نسخهٔ مناسب برای کسب‌وکار شما از اهمیت بالایی برخوردار است. با دنبال کردن این راهنما، می‌توانید یک ERP تحت وب پایدار و امن راه‌اندازی کنید.


بررسی خطاهای احتمالی در زمان به‌روزرسانی

  • اگر سرور دسترسی به `nightly.odoo.com` نداشته باشد، دستور `apt-get update` خطا می‌دهد؛ برای تشخیص مشکل، ابتدا خروجی

`curl -I را مشاهده کنید.


نقش‌های کاربران در پایگاه‌داده Odoo

  • کاربر پایگاه‌داده باید امکان ایجاد دیتابیس را داشته باشد، اما نباید دسترسی `superuser` داشته باشد.
  • در فایل پیکربندی، نقش `createdb` برای مدیر دیتابیس تعیین می‌شود؛ اگر این نقش حذف شود یا دیتابیس مالک دیگری باشد، صفحه مدیریت دیتابیس بی‌اثر می‌شود.
  • پیش‌فرض بسته‌ی Odoo شامل کاربر `odoo` با نام‌کاربری `db_user` است.

دسترسی به پورت‌های پیش‌فرض

  • Odoo به صورت پیش‌فرض بر روی همه آدرس‌های شبکه گوش می‌دهد؛ پورت‌های 8069 و 8072 از اینترنت بسته نیستند.
  • در فایل پیکربندی، `http_interface` به `0.0.0.0` تنظیم می‌شود و ورکرهای WebSocket نیز همان آدرس را می‌گیرند.
  • برای محدود کردن دسترسی، می‌توانید Odoo را به `127.0.0.1` ببندید و در فایروال (مثلاً `ufw`) فقط پورت‌های SSH، 80 و 443 را باز بگذارید.

ایجاد رمز عبور اصلی و دیتابیس اولیه

  1. قبل از راه‌اندازی سرور، از خط فرمان اقدام کنید.
  2. یک رشته تصادفی بسازید و آن را در بخش `admin_passwd` (در قالب `b’…’`) قرار دهید؛ اجازه‌ی دسترسی فایل را 0640 نگه دارید.
  3. فرمان `db init` دیتابیس اولیه و کاربر `admin` را با رمز عبور دلخواه شما ایجاد می‌کند.
  4. مسیر `/web/database/manager` برای ساخت و حذف دیتابیس با رمز عبور اصلی محافظت می‌شود؛ در صورت نیاز به دسترسی محدود، مسیرهای `/web/database` را در Nginx مسدود کنید.

تنظیم ورکرها و پورت WebSocket

  • پس از نصب، Odoo به صورت چندنخی اجرا می‌شود؛ با مقدار `workers` غیر صفر، ورکر جداگانه‌ای برای اعلان‌های زنده روی پورت `gevent_port` (پیش‌فرض 8072) فعال می‌شود.
  • دسترسی به این ورکر فقط از طریق Nginx امکان‌پذیر است.

تعیین تعداد مناسب ورکر

  • تعداد ورکر را بر اساس هسته‌های CPU و کاربران همزمان محاسبه کنید.
  • قانون مستندات:

\[ \text{تعداد ورکر} = (\text{تعداد هسته} \times 2) + 1 \] هر ورکر حدود 6 کاربر همزمان را پاسخ می‌دهد.

  • مثال: سرور 4 هسته‌ای با 60 کاربر → 8 ورکر، یک cron و 3 GB RAM.
  • سرور 2 هسته‌ای: 4 ورکر و یک cron.
  • افزایش تعداد ورکر بر روی سرور مجازی نیازمند ارتقای منابع از طریق پنل مدیریتی است.

پیکربندی Nginx به عنوان وب‌سرور پیش‌نیاز

  • ابتدا گواهی SSL را نصب کنید.
  • سپس فایل پیکربندی Nginx را طوری تنظیم کنید که ترافیک HTTP/HTTPS را به پورت 8069 (Odoo) هدایت کند و از ورکرهای WebSocket (پورت 8072) نیز پشتیبانی نماید.
  • با این تنظیمات، دسترسی مستقیم به Odoo از بیرون محدود می‌شود و فقط از طریق Nginx امکان‌پذیر است.

راه‌اندازی HTTPS برای Odoo

  • گواهی Let’s Encrypt با certbot در مسیر `/etc/letsencrypt/live/` ذخیره می‌شود.
  • فایل تنظیمات Nginx برای Odoo را در `/etc/nginx/sites-enabled/odoo.conf` ایجاد کنید.
  • در بخش `options`، خط `proxy_mode` را فعال کنید تا هدرهای `X-Forwarded-*` معتبر شوند.
  • پس از افزودن خطوط، سرویس Nginx را ریستارت کرده و گواهی را با `certbot renew –dry-run` آزمایش کنید.

بکاپ‌گیری بدون filestore

  • فایل‌های پیوست (PDF، تصاویر) در پوشه `filestore` ذخیره می‌شوند؛ این پوشه در کنار پایگاه‌داده قرار دارد.
  • در نصب‌های Odoo، پوشه `filestore` همان وزن پایگاه‌داده را دارد؛ `pg_dump` فقط دیتابیس را بکاپ می‌گیرد.
  • برای بکاپ کامل، پوشه `filestore` را نیز به‌صورت جداگانه ذخیره کنید؛ معمولاً در `/var/lib/odoo/.local/share/Odoo/filestore` قرار دارد.
  • دستور `odoo -d <db_name> -u all –dump` به‌صورت پیش‌فرض فایل ZIP شامل دیتابیس و filestore تولید می‌کند؛ با گزینه `–no-filestore` فقط دیتابیس را بکاپ می‌گیرد.

برنامه‌ریزی بکاپ روزانه

  • در فایل کران (`/etc/cron.d/odoo-backup`) دستور زیر را اضافه کنید:

“`bash 0 2 * * * odoo /usr/bin/odoo -d <db_name> -u all –dump –output /backups/odoo_$(date +\%F).zip “`

  • سرور بایگانی می‌تواند با `rsync` فایل‌های خروجی را به‌صورت امن منتقل کند و نسخه‌های قدیمی را پاک‌سازی نماید.

تست بازگردانی

  • یک ماشین مجزا با دیتابیس خالی راه‌اندازی کنید.
  • فایل بکاپ را با دستور `odoo -d <new_db> –load /backups/odoo_2024-11-13.zip -n` بارگذاری کنید؛ گزینه `-n` کارهای زمان‌بندی و ایمیل را غیرفعال می‌کند.
  • پس از اطمینان از صحت داده‌ها، می‌توانید در محیط تولید به‌روزرسانی کنید.

نکات کلیدی

  • نسخه Community تحت مجوز LGPLv3 است؛ هزینه مجوز ندارد ولی سرور و نیروی فنی لازم است.
  • اپلیکیشن موبایل و امکانات کامل حسابداری فقط در نسخه Enterprise موجود است.
  • نصب Odoo بر روی ویندوز برای استفاده تک‌کاربره مناسب است؛ حالت worker روی ویندوز پشتیبانی نمی‌شود.
  • برای Odoo 20، فقط Ubuntu 24.04 (با PostgreSQL 16 و Python 3.12) پشتیبانی می‌شود.
  • در صورت گم کردن رمز عبور، از دستور `odoo -d <db_name> -u all –reset-password` برای بازنشانی استفاده کنید.

تغییر رمز عبور موقت و راه‌اندازی مجدد سرویس

  • مقدار admin_passwd را با یک رمز عبور موقتی جایگزین کنید.
  • خط مربوط به آن را با «;» غیرفعال نکنید.
  • سرویس را مجدداً راه‌اندازی کنید.
  • در مسیر /web/database/manager با گزینه Set Master Password رمز جدید را وارد کنید؛ در این مرحله list_db باید موقتا فعال باشد.

دلایل عدم نمایش اعلان‌ها پشت Nginx

  • اگر تعداد workers صفر باشد، ورکر WebSocket بر روی پورت 8072 فعال نمی‌شود.
  • در صورتی که workers به درستی تنظیم شده باشد، مسیر location /websocket باید به پورت 8072 هدایت شود و هدرهای Upgrade و Connection را ارسال کند.

تأثیر بروزرسانی با apt بر نسخه اصلی

  • مخزن به شاخه‌ی 20.0 اشاره دارد؛ بنابراین دستور apt-get upgrade فقط نسخه‌های همان شاخه را نصب می‌کند.
  • پیش از اجرای هر بروزرسانی، یک dump کامل از پایگاه داده تهیه کنید.

نکات کلیدی پیش از نصب Odoo

  • نسخه‌ی Community برای فروش و انبار کافی است؛ در حالی که Enterprise برای دفتر کل و تطبیق بانکی لازم است.
  • Odoo پس از نصب بر روی تمام آدرس‌ها گوش می‌دهد؛ بنابراین http_interface و فایروال باید اولین تنظیمات باشند.
  • سه تصمیم متصل به هم:
  1. workers غیر صفر → ورکر WebSocket فعال می‌شود.
  2. Nginx مسیر /websocket را به ورکر هدایت می‌کند.
  3. proxy_mode دامنه واقعی را به Odoo می‌دهد.
  • رمز اصلی قبل از اولین پایگاه داده تصادفی می‌شود؛ پس از آن list_db خاموش می‌ماند.
  • برای بکاپ، حتماً filestore را هم همراه با دیتابیس ذخیره کنید و آن را روی سرور دیگری نگهدارید.

راهکارهای انتقال به ERP

  • اگر به ERP در سال آینده مهاجرت می‌کنید، اتصال شعبه‌ها به یک دیتابیس حسابداری گام کوچکتری است.
  • در حسابداری چند شعبه، ابتدا باید تصمیم بگیرید که کدام ماژول (Invoicing یا Inventory) را در Odoo تازه‌تان فعال کنید.
امتیازدهی

دیدگاه خود را بنویسید