نکات کلیدی
- “`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
- نصب پیشنیازها
“`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 “`
- نصب PostgreSQL
“`bash sudo apt install -y postgresql sudo -u postgres createuser -s odoo “`
- دانلود و نصب بستهٔ Odoo 20
“`bash wget sudo dpkg -i odoo_20.0.0_all.deb “`
- پیکربندی فایل `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 “`
- راهاندازی سرویس
“`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 را باز بگذارید.
ایجاد رمز عبور اصلی و دیتابیس اولیه
- قبل از راهاندازی سرور، از خط فرمان اقدام کنید.
- یک رشته تصادفی بسازید و آن را در بخش `admin_passwd` (در قالب `b’…’`) قرار دهید؛ اجازهی دسترسی فایل را 0640 نگه دارید.
- فرمان `db init` دیتابیس اولیه و کاربر `admin` را با رمز عبور دلخواه شما ایجاد میکند.
- مسیر `/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 و فایروال باید اولین تنظیمات باشند.
- سه تصمیم متصل به هم:
- workers غیر صفر → ورکر WebSocket فعال میشود.
- Nginx مسیر /websocket را به ورکر هدایت میکند.
- proxy_mode دامنه واقعی را به Odoo میدهد.
- رمز اصلی قبل از اولین پایگاه داده تصادفی میشود؛ پس از آن list_db خاموش میماند.
- برای بکاپ، حتماً filestore را هم همراه با دیتابیس ذخیره کنید و آن را روی سرور دیگری نگهدارید.
راهکارهای انتقال به ERP
- اگر به ERP در سال آینده مهاجرت میکنید، اتصال شعبهها به یک دیتابیس حسابداری گام کوچکتری است.
- در حسابداری چند شعبه، ابتدا باید تصمیم بگیرید که کدام ماژول (Invoicing یا Inventory) را در Odoo تازهتان فعال کنید.

کمپین ابتکار نو
کمپین ایده های نو
کمپین آینده روشن
کمپین طراحی مدرن