الفرق بين venv وpipx وuv على خادم Ubuntu
هل يظهر لك خطأ externally-managed-environment عند استخدام pip؟ اكتشف متى تختار venv أو pipx أو uv لتثبيت حزم بايثون على خادمك وكيفية ربطها بخدمات systemd بشكل صحيح.
سبب فشل pip install على خادم Ubuntu جديد
يعتمد الاختيار بين Python venv وpipx وuv على خادم على سؤال واحد: ماذا ستثبّت؟ تنتمي تبعيات التطبيق إلى بيئة افتراضية داخل مجلد التطبيق نفسه. أما أدوات سطر الأوامر التي تريد تشغيلها بكتابة اسمها فتنتمي إلى pipx. ينفّذ uv المهمتين ويضيف ملف قفل، وتبدأ أهميته بالظهور بمجرد أن تحتاج آلة ثانية إلى إنشاء البيئة نفسها. لكن لا يثبّت أيٌّ منها الحزم في Python النظام، لأن خادم Ubuntu الحالي يرفض ذلك صراحةً.
شغّل sudo pip install requests على Ubuntu 24.04، وسيتوقف pip قبل تنزيل أي ملف.
error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
python3-xyz, where xyz is the package you are trying to
install.
If you wish to install a non-Debian-packaged Python package,
create a virtual environment using python3 -m venv path/to/venv.
Then use path/to/venv/bin/python and path/to/venv/bin/pip.
If you wish to install a non-Debian packaged Python application,
it may be easiest to use pipx install xyz, which will manage a
virtual environment for you.
note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this behaviour by passing --break-system-packages.هذا هو PEP 668 (اقتراح تحسين Python رقم 668، «البيئات المُدارة خارجياً») وهو يؤدي وظيفته. تضع Debian وUbuntu ملف علامة بجانب المفسّر في /usr/lib/python3.12/EXTERNALLY-MANAGED، ويرفض pip الكتابة إلى أي مفسّر يحتوي على هذه العلامة.
توجد هذه القاعدة بسبب ترتيب sys.path. يثبّت apt المكتبات في /usr/lib/python3/dist-packages. وعندما تشغّل pip بصلاحيات root على مفسّر النظام، فإنه يكتب في /usr/local/lib/python3.12/dist-packages، بينما تضع حزم Debian ذلك المجلد في موضع أسبق في مسار البحث. اطبع المسار بنفسك باستخدام python3 -c 'import sys; print(sys.path)' واقرأ الترتيب. بذلك تحجب النسخة التي كتبها pip النسخة التي ثبّتها apt، أمام كل برنامج على الخادم يعمل باستخدام /usr/bin/python3، بما في ذلك أدوات التوزيعة نفسها. يستورد cloud-init كلاً من requests وjinja2 وPyYAML من ذلك المفسّر. إذا حدّثت واحدة منها باستخدام pip وثبّت إصداراً غير متوافق، فسيفشل شيء لم تلمسه عند الإقلاع التالي، مع traceback يذكر حزمة لم تكن تعرف أنها ضمن سلسلة الاعتماديات. يظل apt يسجّل إصداره الخاص على أنه مثبتاً، لذلك لا يظهر أي تحذير. تتمثل عملية الإصلاح في إزالة نسخة pip باستخدام sudo pip uninstall --break-system-packages requests، لأن sudo apt reinstall python3-requests وحده لا يفعل سوى إعادة كتابة نسخة apt التي كانت محجوبة بالفعل.
القاعدة الناتجة قصيرة. يعود Python النظام إلى التوزيعة. لا تثبّت الحزم فيه، ولا تحدّث مكتبته باستخدام pip، ولا تحذف ملف EXTERNALLY-MANAGED لإخفاء الرسالة. المهمة الوحيدة التي ينبغي أن تمنحها إلى /usr/bin/python3 هي إنشاء البيئات الافتراضية.
venv مقابل pipx مقابل uv: قاعدة اتخاذ القرار
اختر الأداة بناءً على ما تقوم بتثبيته، وليس بناءً على الأداة التي قرأت عنها مؤخراً.
- تطبيق تقوم بنشره وتشغيله كخدمة، مثل مشروع Django أو Flask: استخدم بيئة افتراضية واحدة (venv) داخل دليل ذلك التطبيق.
- أداة سطر أوامر تريدها في
PATHالخاص بك، مثلansibleأوhttpie: استخدم pipx، الذي يمنح كل أداة بيئة خاصة ورابطاً واحداً فيPATH. - مشروع يحتاج إلى ملف قفل (lockfile)، أو تثبيت أسرع، أو إصدار Python لا توفره التوزيعة: استخدم uv، الذي ينشئ بيئة venv عادية بالإضافة إلى ملف
uv.lock. - مكتبة تحتاجها أداة تابعة للتوزيعة بدلاً من كودك الخاص: استخدم
sudo apt install python3-<name>، وهي الطريقة الوحيدة المدعومة لإضافة أي شيء إلى مفسر النظام.
يقوم كل من pipx و uv tool install بنفس المهمة، لذا فإن الخادم الذي يحتوي بالفعل على uv لا يحتاج إلى pipx أيضاً. إطار عمل الويب الذي اخترته لا يغير شيئاً هنا: Django و Flask على خادم VPS يختلفان في ما يتم وضعه في requirements.txt، وليس في كيفية بناء البيئة المحيطة به. كل ما يلي يستخدم Ubuntu 24.04 وإصدار Python 3.12 الخاص بها، لذا قم بتعديل الإصدار داخل المسارات إذا كان إصدارك مختلفاً.
إنشاء venv لكل تطبيق
تفصل Ubuntu الوحدة venv عن حزمة Python الأساسية، لذلك يفشل المحاولـة الأولى على صورة مصغّرة برسالة تحدد العنصر المفقود بالضبط.
The virtual environment was not created successfully because ensurepip is not
available. On Debian/Ubuntu systems, you need to install the python3-venv
package using the following command.
apt install python3.12-venvثبّتها، ثم أنشئ البيئة بصفة المستخدم الذي سيمتلك الشيفرة.
sudo apt update
sudo apt install -y python3-venv
sudo install -d -o deploy -g deploy -m 755 /srv/myapp
sudo -u deploy python3 -m venv /srv/myapp/.venv
sudo -u deploy /srv/myapp/.venv/bin/pip install -r /srv/myapp/requirements.txtلاحظ ما هو غير موجود: لا source ولا activate. تُثبّت /srv/myapp/.venv/bin/pip داخل تلك البيئة بسبب موقع الملف التنفيذي، وليس بسبب أي متغير صدّرته إلى shell. تأكد من ذلك قبل المتابعة.
/srv/myapp/.venv/bin/python -c 'import sys; print(sys.prefix)'يعرض ذلك /srv/myapp/.venv. إذا عرض /usr، فأنت تشغّل مفسر النظام، وقد ثبّتت الحزم في مكان غير مقصود.
تحدد خاصيتان في venv ما يمكنك فعله بها لاحقاً. لا يمكن نقل venv، لأن كل script لنقطة الدخول في bin/ يحتوي على سطر shebang مطلقاً: يقرأ head -1 /srv/myapp/.venv/bin/pip القيمة #!/srv/myapp/.venv/bin/python. أعد تسمية الدليل الأب، وستفشل هذه scripts مع bad interpreter: No such file or directory. كما تثبّت venv مفسر Python الذي أنشأها، ويُسجَّل ذلك في سطر home داخل /srv/myapp/.venv/pyvenv.cfg، بينما يكون bin/python3 رابطاً رمزياً إلى /usr/bin/python3. حدّث الإصدار بحيث يشير ذلك المسار الآن إلى Python أحدث، وسيبحث المفسر الجديد عن الحزم في دليل lib/python3.13 لا تملكه venv، لذلك تتوقف الخدمة عند بدء التشغيل مع ModuleNotFoundError. في الحالتين، الحل واحد: احذف venv وأنشئ واحدة جديدة من requirements.txt. يستغرق إعادة الإنشاء ثواني. لا تنسخ venv بين الأجهزة.
مكان وجود venv ومن يمتلكه
ضعه بجانب الكود في /srv/myapp/.venv، واحتفظ ببيئة افتراضية (venv) واحدة لكل تطبيق. يصبح النشر بذلك في دليل واحد، وتحصل وحدة systemd على مسار لا يتغير أبداً، ولا يمكن لتطبيقين أن يعطلا بعضهما البعض من خلال ترقية تبعية مشتركة. لا تضع venv في أي مكان ينشر فيه خادم الويب الملفات مباشرة، لأنه يحتوي على تبعياتك وغالباً على إعداداتك.
تستحق الملكية نصف دقيقة من وقتك. اجعل مستخدماً بـ deploy يمتلك الكود والبيئة، وامنح حساب الخدمة صلاحيات القراءة والتنفيذ فقط.
sudo adduser --system --group --no-create-home myapp
sudo chown -R deploy:myapp /srv/myapp
sudo chmod -R o-rwx /srv/myappيمكن للخدمة الآن استيراد تبعياتها ولكن لا يمكنها إعادة كتابتها، مما يعني أن ثغرة تنفيذ الكود في تطبيق الويب لا يمكنها استبدال مكتبة على القرص سراً والبقاء بعد إعادة التشغيل. المنطق نفسه المطبق على بقية الجهاز مغطى في تشغيل الخدمات بصلاحيات المستخدم الأقل.
pipx لأدوات سطر الأوامر
يثبّت pipx التطبيقات، وليس المكتبات. يحصل كل تطبيق على بيئته الخاصة ضمن ~/.local/share/pipx/venvs/<name>، وتُربط الملفات التنفيذية لذلك التطبيق ضمن ~/.local/bin، لذلك لا تتعارض أداتان تحتاجان إلى إصدارين مختلفين من المكتبة نفسها.
sudo apt update
sudo apt install -y pipx
pipx ensurepath
pipx install httpieيضيف pipx ensurepath المسار ~/.local/bin إلى PATH عبر تعديل ملف بدء تشغيل الصدفة. لا يمكنه تغيير الصدفة التي تعمل فيها حالياً، لذلك تعني نتيجة http: command not found بعد التثبيت مباشرة عادةً أنك لم تسجّل الخروج ثم تسجّل الدخول مجدداً. يضيف ~/.profile الافتراضي في Ubuntu المسار ~/.local/bin فقط عندما يكون هذا المجلد موجوداً عند تسجيل الدخول. لذلك تظهر المشكلة مرة واحدة في الحساب الجديد ولا تتكرر بعد ذلك.
إذا وجّهت pipx إلى مكتبة، فسيرفض ذلك برسالة تبدأ بـ:
No apps associated with package requests.هذه الرسالة تعني أن الأداة غير مناسبة لهذه المهمة. يجب وضع المكتبات في venv الخاصة بالتطبيق.
التفصيل المهم على الخادم هو موقع التثبيت. يضع pipx install العادي كل شيء ضمن الدليل الرئيسي لمستخدم واحد. ولا تستطيع وحدة systemd التي تعمل باسم myapp الوصول إليه، كما لا يستطيع root cron job الوصول إليه، ولن يعثر عليه sudo أيضاً، لأن secure_path في /etc/sudoers يستبدل PATH بقائمة ثابتة. ثبّت الأداة بشكل عام إذا كان ينبغي أن تتوفر للنظام بأكمله.
sudo pipx install --global ansible
sudo pipx ensurepath --globalيضع الخيار --global البيئات ضمن /opt/pipx، ويربط الملفات التنفيذية ضمن /usr/local/bin، وهو موجود في PATH الافتراضي وضمن secure_path. تحقّق من الإصدار أولاً باستخدام pipx --version، لأن Ubuntu 24.04 يوفّر pipx 1.4.3، وهو أقدم من --global، ويرد إصدار pipx الأقدم بالرسالة unrecognized arguments: --global. في ذلك الإصدار، عيّن الدليلين الموثقين بنفسك:
sudo env PIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/local/bin pipx install ansible
command -v ansibleيجب أن يطبع command -v ansible القيمة /usr/local/bin/ansible. إذا طبع مساراً ضمن /home، فقد ثُبّتت الأداة في حساب مستخدم واحد، ولن تتمكن أي خدمة من العثور عليها.
uv عندما تريد ملف قفل
uv هو ملف ثنائي واحد من Astral يوفّر وظائف pip وvenv وpip-tools، ويمكنه أيضاً تنزيل مفسّرات Python. وهو سريع بما يكفي لتظهر فائدته على VPS صغير، كما أنه يكتب ملف قفل فعلياً.
يضع المُثبّت الرسمي uv وuvx في ~/.local/bin:
curl -LsSf https://astral.sh/uv/install.sh | sh
uv --versionيتطلب تمرير script إلى shell على خادم قدراً من الحذر. ثبّت الإصدار في URL واقرأ الملف قبل تشغيله:
curl -LsSf https://astral.sh/uv/0.12.3/install.sh -o uv-install.sh
less uv-install.sh
sh uv-install.shيعمل pipx install uv أيضاً إذا كان pipx موجوداً مسبقاً. uv ملف ثنائي مستقل لا يعتمد على Python، لذلك يُعدّ نسخه إلى /usr/local/bin طريقة صحيحة لمشاركته مع كل مستخدم على الخادم.
بالنسبة إلى مشروع يحتوي على pyproject.toml، يتكون سير العمل من 4 أوامر، ولا يُنفَّذ على الخادم إلا الأمر الأخير.
uv init myapp
uv add flask gunicorn
uv lock
uv sync --frozen --no-devينشئ uv lock ملف uv.lock، وهو ملف قفل متعدد المنصات يحتوي على الإصدارات المحلولة بدقة، وتضعه في المستودع بجانب الشيفرة. ينشئ uv sync ملف .venv في جذر المشروع بما يتوافق معه. على الخادم، يكون الخيار --frozen هو المهم: توثّق الوثائق أنه يستخدم الإصدارات الموجودة في ملف القفل باعتبارها مصدر الحقيقة، بدلاً من التحقق مما إذا كان ملف القفل محدثاً، وهذا هو السلوك المطلوب في النشر. يستبعد --no-dev مجموعة الاعتماديات الخاصة بالتطوير.
لا يحتاج مشروع requirements.txt موجود مسبقاً إلى تحويل، لأن uv يتحدث لغة pip:
uv venv /srv/myapp/.venv
uv pip install --python /srv/myapp/.venv/bin/python -r /srv/myapp/requirements.txtالناتج هو بيئة افتراضية عادية، مع اختلاف واحد: لا يثبّت uv pip داخلها، لذلك لا يعمل .venv/bin/pip و.venv/bin/python -m pip ما لم تنشئ البيئة باستخدام uv venv --seed. استخدم uv pip للتثبيت بدلاً من ذلك. لا ينفّذ أي شيء لاحق في هذا الدليل pip داخل البيئة، لذلك لا يغيّر أي شيء لاحق فيها.
يجدر بك معرفة أحد الإعدادات الافتراضية في uv قبل استخدامه على خادم. يكون إعداد python-preference مضبوطاً افتراضياً على managed، وتوثّقه الوثائق بأنه يختار «المفسّرات التي ينزّلها uv ويثبّتها» بدلاً من المفسّرات الموجودة مسبقاً على النظام. لذلك، عند تنفيذ uv venv --python 3.13 على خادم لا يحتوي إلا على 3.12، يجلب uv الإصدار 3.13 بهدوء إلى ~/.local/share/uv/python بدلاً من الفشل. هذا مناسب على الحاسوب المحمول، لكنه مفاجئ على الخادم، لأن خدمتك ستعتمد عندئذ على مفسّر موجود في مجلد home ولن يقوم apt upgrade بتصحيحه. اضبط python-preference على only-system في uv.toml إذا كنت تريد استخدام مفسّر التوزيعة. وإذا أردت وضع البيئة في مكان غير جذر المشروع، فيحدد UV_PROJECT_ENVIRONMENT الدليل المستخدم للبيئة الافتراضية الخاصة بالمشروع.
وجّه systemd إلى مفسّر venv، وليس إلى activate
هنا تتعطل معظم عمليات نشر Python، والسبب هو سوء فهم وظيفة activate.
bin/activate هو برنامج نصي لـshell. يضيف دليل bin الخاص بـvenv في بداية PATH، ويضبط VIRTUAL_ENV، ويحفظ القيم القديمة حتى يتمكن deactivate من استعادتها، ويغيّر موجه الأوامر. لا يحتوي هذا البرنامج النصي على أي شيء يقرأه المفسّر نفسه. التفعيل مجرد وسيلة مريحة لشخص يكتب python في موجه الأوامر.
الذي يحدد البيئة فعلياً هو ملف المفسّر الذي تنفذه. عند بدء /srv/myapp/.venv/bin/python، تبحث وحدة Python المسماة site عن ملف pyvenv.cfg في الدليل الذي يحتوي على الملف التنفيذي، وفي الدليل الأعلى منه بمستوى واحد. يؤدي العثور على /srv/myapp/.venv/pyvenv.cfg إلى ضبط sys.prefix على venv، ما يضيف site-packages الخاص بـvenv إلى sys.path. هذه هي الآلية كاملة. ولا تحتاج إلى متغير بيئة أو إلى shell.
لذلك لا تبدأ هذه الوحدة:
[Service]
ExecStart=source /srv/myapp/.venv/bin/activate && gunicorn app:appmyapp.service: Failed to locate executable source: No such file or directory
myapp.service: Failed at step EXEC spawning source: No such file or directory
myapp.service: Main process exited, code=exited, status=203/EXECExecStart ليس سطر أوامر لـshell. ينفّذ systemd البرنامج مباشرة، لذلك لا يوجد builtin باسم source، ويُمرَّر && باعتباره وسيطاً حرفياً، ولا تُنفَّذ أي توسعات خاصة بـshell باستثناء القليل الذي يوضحه systemd نفسه.
وتبدأ هذه الوحدة، ثم تتوقف:
[Service]
ExecStart=/usr/bin/python3 /srv/myapp/app.pyModuleNotFoundError: No module named 'flask'/usr/bin/python3 هو مفسّر النظام، ولم يتضمن sys.path الخاص به venv لديك قط. يعمل الأمر نفسه في جلسة SSH لأنك فعّلت venv هناك، ولذلك حلّ shell قيمة python3 عبر PATH إلى .venv/bin/python3 بدلاً من ذلك.
يعمل وضع الأمر داخل /bin/bash -c 'source ... && gunicorn ...'. لكنه يضيف أيضاً shell بين systemd والعملية من دون فائدة، بينما يكفي مسار مطلق واحد:
[Unit]
Description=myapp web service
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/srv/myapp
Environment=PYTHONUNBUFFERED=1
Environment=PATH=/srv/myapp/.venv/bin:/usr/local/bin:/usr/bin:/bin
ExecStart=/srv/myapp/.venv/bin/gunicorn --workers 3 --bind 127.0.0.1:8000 app:app
Restart=on-failure
RestartSec=5
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=full
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now myapp
systemctl status myapp
journalctl -u myapp -n 50 --no-pagerيجب أن يعرض systemctl status myapp قيمة active (running) مع Main PID يشير إلى عملية gunicorn الخاصة بك. إذا عرض شيئاً آخر، فاقرأ journal.
لا يوجد سطر Environment=PATH= من أجل ExecStart، لأنه يحتوي بالفعل على مسار كامل. وُضع هذا السطر من أجل العمليات التي يبدأها تطبيقك. ترث الخدمة قيمة افتراضية مختصرة لـPATH من systemd، لذلك لن يعثر كود Python الذي يستدعي subprocess.run(["ffmpeg", ...])، أو أمر إدارة يستدعي من shell برنامجاً تنفيذياً من venv، على ما يحتاج إليه. إن وضع دليل bin الخاص بـvenv في البداية هو الجزء الوحيد من activate الذي تستخدمه الخدمة فعلياً. تحقّق من القيمة التي تلقتها الوحدة فعلياً باستخدام systemctl show -p Environment myapp.
تنطبق القاعدة نفسها على المهام المجدولة. في Ubuntu، لا يمرر cron إلى المهمة قيمة PATH من shell لديك أو من daemon. وما لم يضبط crontab قيمة PATH بنفسه، تحصل كل مهمة على القيمة الافتراضية المضمّنة /usr/bin:/bin، ولا يتجاوزها /etc/environment. لا تتضمن هذه القيمة venv لديك، لذلك يشغّل سطر crontab الذي يحتوي على python3 /srv/myapp/cleanup.py مفسّر النظام ويفشل بالخطأ ModuleNotFoundError في الثالثة صباحاً. يرسل cron الخطأ بالبريد إلى مالك crontab، أو إلى عنوان MAILTO إذا ضبطت واحداً. وفي معظم الخوادم يعني ذلك صندوق بريد محلياً لا يقرأه أحد. وإذا لم يكن برنامج البريد مثبتاً، يتخلص cron من المخرجات ولا يكتب في سجل النظام إلا No MTA installed, discarding output. اكتب مسار venv المطلق هناك أيضاً. ولإرسال هذه المخرجات إلى journal مع الاحتفاظ بسجل لآخر تشغيل بدلاً من ذلك، يطبّق زوج من خدمة ومؤقت systemd سطر ExecStart نفسه.
هل يستبدل Docker هذا القرار؟
تمتلك الحاوية نظام ملفات خاصاً بها، لذا يتغير شكل السؤال بدلاً من أن يختفي. في صورة رسمية مثل python:3.12-slim، يكون Python مدمجاً في /usr/local ولا يحمل أي علامة EXTERNALLY-MANAGED، لذا فإن استخدام pip install بصلاحيات root هو الطريقة المقصودة لإضافة الحزم، ولا يضيف venv الكثير في هذه الحالة. بدلاً من ذلك، عند بناء FROM ubuntu:24.04 ستواجه externally-managed-environment مجدداً داخل الصورة، ولنفس السبب الموجود على المضيف: فهو مفسّر التوزيعة الذي يحمل ملف العلامة الخاص بها.
لا تزال العديد من الصور تستخدم venv، لأنّه يجعل عملية البناء متعددة المراحل (multi-stage build) بسيطة. تُثبّت مرحلة البناء الحزم في /opt/venv، وتقوم مرحلة التشغيل بنسخ ذلك المجلد فقط وترك المترجمات خلفها. تنتقل مشكلة التفعيل (activate) معها. يؤثر سطر RUN source /opt/venv/bin/activate على shell تلك الطبقة من البناء فقط، لذا عند التشغيل تبدأ الحاوية باستخدام مفسّر النظام وتُظهر خطأ ModuleNotFoundError. اضبط ENV PATH="/opt/venv/bin:$PATH"، أو امنح CMD المسار المطلق /opt/venv/bin/gunicorn. إنه نفس الخطأ الموجود في systemd، ولكن في ملف مختلف.
إذن، تستبدل الحاوية سؤال المفسّر، لأن الصورة تثبّت نسخة المفسّر وكل ما يتبعه. لكنها لا تستبدل سؤال التثبيت (pinning). فالصورة التي تُبنى من ملف requirements.txt غير مُثبّت الإصدارات ستحصل على إصدارات مختلفة الشهر القادم، مما يعني أن وسم الصورة (tag) قابل للتكرار بينما عملية البناء التي أنتجته ليست كذلك. إن ملف القفل (lockfile) مثل uv.lock، أو ملف المتطلبات المُثبّت بالكامل، هو ما يسد هذه الفجوة، سواء استخدمت حاوية أم لا. وعندما يعمل تطبيق واحد على خادم VPS تحت إدارة systemd، فإن الحاوية تنقل هذا القرار في الغالب إلى ملف Dockerfile، حيث أن systemd يقوم بالفعل بإعادة تشغيل العملية الفاشلة ويلتقط مخرجاتها في السجل (journal). إن تشغيل Docker على خادم VPS يثبت جدواه عندما تريد أن تكون الصورة المبنية نفسها هي الشيء الذي تنشره.
FAQ
هل يمكنني استخدام pip install مع --break-system-packages فقط؟
ليس على خادم يجب أن يظل قيد التشغيل. يؤدي الخيار وظيفته كما يدل اسمه: يزيل الحماية، ويكتب pip داخل /usr/local/lib/python3.12/dist-packages، الذي يسبق دليل apt في sys.path. عندها تحجب نسختك نسخة التوزيعة عن كل برنامج نظام يعمل تحت /usr/bin/python3، بينما يظل apt يعتقد أن نسخته الخاصة مثبتة. لذلك لا يكتشف أي شيء التعارض إلى أن يتعطل شيء ما. داخل صورة حاوية تعيد بناءها من الصفر في كل مرة، يقتصر الضرر على تلك الصورة، ولذلك يمكن تبرير استخدامه هناك. أما على جهاز تديره، فأنشئ venv. هذا يتطلب أمراً واحداً.
أين ينبغي أن توجد البيئة الافتراضية على الخادم؟
داخل دليل التطبيق نفسه، في /srv/myapp/.venv، على أن يملكها مستخدم deploy، وأن يملك حساب الخدمة صلاحية القراءة والتنفيذ فقط. استخدم venv واحدة لكل تطبيق، لأن البيئة المشتركة تعني أن ترقية التطبيق الأول قد تعطل التطبيق الثاني. لا تنقل venv أو تنسخها بعد إنشائها: يحتوي كل برنامج entry point في دليل bin/ على هذا المسار المطلق في سطر shebang الخاص به، ولذلك تفشل venv المنقولة مع bad interpreter: No such file or directory. احذفها وأعد بناءها من requirements.txt بدلاً من ذلك.
لماذا تفشل خدمة systemd لدي مع ModuleNotFoundError؟
لأن الوحدة تنفذ مفسراً ليس مفسر venv. شغّل systemctl cat myapp واقرأ ExecStart. يجب أن يحدد /srv/myapp/.venv/bin/python، أو برنامج console script من دليل bin/ نفسه، باستخدام مسار مطلق. لا يمكن أن ينجح تحميل activate مباشرة داخل ExecStart، لأن ExecStart ليس shell، ويبلغ systemd عن Failed to locate executable source مع status=203/EXEC. أضف Environment=PATH=/srv/myapp/.venv/bin:/usr/local/bin:/usr/bin:/bin حتى تتمكن أي عملية فرعية يبدأها برنامجك من العثور على أدوات venv أيضاً.
هل ينبغي أن أستخدم uv بدلاً من venv وpip؟
استخدم uv عندما تريد ملف قفل، أو عندما يصبح وقت التثبيت بطيئاً بما يكفي لإزعاجك، أو عندما تحتاج إلى إصدار Python لا توفره توزيعتك. ينشئ uv venv عادية، لذلك لا تتغير وحدة systemd ولا بنية الملفات، ويثبت uv sync --frozen ما يسجله ملف القفل بالضبط. إذا كان تطبيق واحد يُنشر من git باستخدام requirements.txt مثبت، وكان التثبيت يكتمل خلال ثوانٍ، فإن python3 -m venv يكفي بالفعل، كما أنه binary إضافي واحد أقل تحتاج إلى إبقائه محدثاً على الخادم.