{"title":"Jak używać Django z uWSGI","version":"6.0","locale":"pl","docname":"howto/deployment/wsgi/uwsgi","url":"/pl/6.0/howto/deployment/wsgi/uwsgi/","canonical":"https://djangodocs.dev/pl/6.0/howto/deployment/wsgi/uwsgi/","summary":"uWSGI is a fast, self-healing and developer/sysadmin-friendly application container server coded in pure C. Zobacz także The uWSGI docs offer a tutorial covering…","html":"<h1>Jak używać Django z uWSGI<a class=\"heading-anchor\" href=\"#how-to-use-django-with-uwsgi\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p><a class=\"reference external\" href=\"https://uwsgi-docs.readthedocs.io/\">uWSGI</a> is a fast, self-healing and developer/sysadmin-friendly application\ncontainer server coded in pure C.</p>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">Zobacz także</p>\n<p>The uWSGI docs offer a <a class=\"reference external\" href=\"https://uwsgi.readthedocs.io/en/latest/tutorials/Django_and_nginx.html\">tutorial</a> covering Django, nginx, and uWSGI (one\npossible deployment setup of many). The docs below are focused on how to\nintegrate Django with uWSGI.</p>\n</aside>\n<section id=\"prerequisite-uwsgi\">\n<h2>Prerequisite: uWSGI<a class=\"heading-anchor\" href=\"#prerequisite-uwsgi\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>The uWSGI wiki describes several <a class=\"reference external\" href=\"https://uwsgi-docs.readthedocs.io/en/latest/Install.html\">installation procedures</a>. Using pip, the\nPython package manager, you can install any uWSGI version with a single\ncommand. For example:</p>\n<div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"gp\"># </span>Install<span class=\"w\"> </span>current<span class=\"w\"> </span>stable<span class=\"w\"> </span>version.\n<span class=\"gp\">$ </span>python<span class=\"w\"> </span>-m<span class=\"w\"> </span>pip<span class=\"w\"> </span>install<span class=\"w\"> </span>uwsgi\n</code></pre></div>\n<section id=\"uwsgi-model\">\n<h3>Model uWSGI<a class=\"heading-anchor\" href=\"#uwsgi-model\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>uWSGI operates on a client-server model. Your web server (e.g., nginx, Apache)\ncommunicates with a <code class=\"docutils literal notranslate\"><span class=\"pre\">django-uwsgi</span></code> „worker” process to serve dynamic content.</p>\n</section>\n<section id=\"configuring-and-starting-the-uwsgi-server-for-django\">\n<h3>Konfigurowanie i uruchamianie serwera uWSGI dla Django<a class=\"heading-anchor\" href=\"#configuring-and-starting-the-uwsgi-server-for-django\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>uWSGI supports multiple ways to configure the process. See uWSGI’s\n<a class=\"reference external\" href=\"https://uwsgi.readthedocs.io/en/latest/Configuration.html\">configuration documentation</a>.</p>\n<p>Here’s an example command to start a uWSGI server:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>uwsgi<span class=\"w\"> </span>--chdir<span class=\"o\">=</span>/path/to/your/project<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--module<span class=\"o\">=</span>mysite.wsgi:application<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--env<span class=\"w\"> </span><span class=\"nv\">DJANGO_SETTINGS_MODULE</span><span class=\"o\">=</span>mysite.settings<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--master<span class=\"w\"> </span>--pidfile<span class=\"o\">=</span>/tmp/project-master.pid<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--socket<span class=\"o\">=</span><span class=\"m\">127</span>.0.0.1:49152<span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">     </span><span class=\"c1\"># can also be a file</span>\n<span class=\"w\">    </span>--processes<span class=\"o\">=</span><span class=\"m\">5</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">                </span><span class=\"c1\"># number of worker processes</span>\n<span class=\"w\">    </span>--uid<span class=\"o\">=</span><span class=\"m\">1000</span><span class=\"w\"> </span>--gid<span class=\"o\">=</span><span class=\"m\">2000</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">        </span><span class=\"c1\"># if root, uwsgi can drop privileges</span>\n<span class=\"w\">    </span>--harakiri<span class=\"o\">=</span><span class=\"m\">20</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">                </span><span class=\"c1\"># respawn processes taking more than 20 seconds</span>\n<span class=\"w\">    </span>--max-requests<span class=\"o\">=</span><span class=\"m\">5000</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">          </span><span class=\"c1\"># respawn processes after serving 5000 requests</span>\n<span class=\"w\">    </span>--vacuum<span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">                     </span><span class=\"c1\"># clear environment on exit</span>\n<span class=\"w\">    </span>--home<span class=\"o\">=</span>/path/to/virtual/env<span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">  </span><span class=\"c1\"># optional path to a virtual environment</span>\n<span class=\"w\">    </span>--daemonize<span class=\"o\">=</span>/var/log/uwsgi/yourproject.log<span class=\"w\">      </span><span class=\"c1\"># background the process</span>\n</code></pre></div>\n<p>This assumes you have a top-level project package named <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite</span></code>, and\nwithin it a module <code class=\"file docutils literal notranslate\"><span class=\"pre\">mysite/wsgi.py</span></code> that contains a WSGI <code class=\"docutils literal notranslate\"><span class=\"pre\">application</span></code>\nobject. This is the layout you’ll have if you ran <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span>\n<span class=\"pre\">startproject</span> <span class=\"pre\">mysite</span></code> (using your own project name in place of <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite</span></code>) with\na recent version of Django. If this file doesn’t exist, you’ll need to create\nit. See the <a class=\"reference internal\" href=\"/pl/6.0/howto/deployment/wsgi/\"><span class=\"doc\">Jak wdrażać z WSGI</span></a> documentation for the default\ncontents you should put in this file and what else you can add to it.</p>\n<p>The Django-specific options here are:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">chdir</span></code>: The path to the directory that needs to be on Python’s import\npath – i.e., the directory containing the <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite</span></code> package.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">module</span></code>: The WSGI module to use – probably the <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite.wsgi</span></code> module\nthat <a class=\"reference internal\" href=\"/pl/6.0/ref/django-admin/#django-admin-startproject\"><code class=\"xref std std-djadmin docutils literal notranslate\"><span class=\"pre\">startproject</span></code></a> creates.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">env</span></code>: Should probably contain at least <span class=\"target\" id=\"index-0\"></span><a class=\"reference internal\" href=\"/pl/6.0/topics/settings/#envvar-DJANGO_SETTINGS_MODULE\"><code class=\"xref std std-envvar docutils literal notranslate\"><span class=\"pre\">DJANGO_SETTINGS_MODULE</span></code></a>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">home</span></code>: Optional path to your project virtual environment.</p></li>\n</ul>\n<p>Example ini configuration file:</p>\n<div class=\"code-block\" data-language=\"ini\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Ini</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Ini code\"><code><span class=\"k\">[uwsgi]</span>\n<span class=\"na\">chdir</span><span class=\"o\">=</span><span class=\"s\">/path/to/your/project</span>\n<span class=\"na\">module</span><span class=\"o\">=</span><span class=\"s\">mysite.wsgi:application</span>\n<span class=\"na\">master</span><span class=\"o\">=</span><span class=\"s\">True</span>\n<span class=\"na\">pidfile</span><span class=\"o\">=</span><span class=\"s\">/tmp/project-master.pid</span>\n<span class=\"na\">vacuum</span><span class=\"o\">=</span><span class=\"s\">True</span>\n<span class=\"na\">max-requests</span><span class=\"o\">=</span><span class=\"s\">5000</span>\n<span class=\"na\">daemonize</span><span class=\"o\">=</span><span class=\"s\">/var/log/uwsgi/yourproject.log</span>\n</code></pre></div>\n<p>Example ini configuration file usage:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>uwsgi<span class=\"w\"> </span>--ini<span class=\"w\"> </span>uwsgi.ini\n</code></pre></div>\n<aside class=\"admonition-fixing-unicodeencodeerror-for-file-uploads admonition\">\n<p class=\"admonition-title\">Naprawanie <code class=\"docutils literal notranslate\"><span class=\"pre\">UnicodeEncodeError</span></code> dla przesyłania plików</p>\n<p>If you get a <code class=\"docutils literal notranslate\"><span class=\"pre\">UnicodeEncodeError</span></code> when uploading files with file names\nthat contain non-ASCII characters, make sure uWSGI is configured to accept\nnon-ASCII file names by adding this to your <code class=\"docutils literal notranslate\"><span class=\"pre\">uwsgi.ini</span></code>:</p>\n<div class=\"code-block\" data-language=\"ini\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Ini</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Ini code\"><code><span class=\"na\">env</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"s\">LANG=en_US.UTF-8</span>\n</code></pre></div>\n<p>See the <a class=\"reference internal\" href=\"/pl/6.0/ref/unicode/#unicode-files\"><span class=\"std std-ref\">Files</span></a> section of the Unicode reference guide for\ndetails.</p>\n</aside>\n<p>See the uWSGI docs on <a class=\"reference external\" href=\"https://uwsgi-docs.readthedocs.io/en/latest/Management.html\">managing the uWSGI process</a> for information on\nstarting, stopping and reloading the uWSGI workers.</p>\n</section>\n</section>","rootId":"how-to-use-django-with-uwsgi","toc":[{"title":"Prerequisite: uWSGI","anchor":"prerequisite-uwsgi","children":[{"title":"Model uWSGI","anchor":"uwsgi-model","children":[]},{"title":"Konfigurowanie i uruchamianie serwera uWSGI dla Django","anchor":"configuring-and-starting-the-uwsgi-server-for-django","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"How-to guides","url":"/pl/6.0/howto/"},{"docname":"howto/deployment/index","title":"Jak wdrażać Django","url":"/pl/6.0/howto/deployment/"},{"docname":"howto/deployment/wsgi/index","title":"Jak wdrażać z WSGI","url":"/pl/6.0/howto/deployment/wsgi/"}],"prev":{"docname":"howto/deployment/wsgi/gunicorn","title":"Jak używać Django z Gunicornem","url":"/pl/6.0/howto/deployment/wsgi/gunicorn/"},"next":{"docname":"howto/deployment/wsgi/modwsgi","title":"Jak używać Django z Apache i mod_wsgi","url":"/pl/6.0/howto/deployment/wsgi/modwsgi/"},"formats":{"html":"/pl/6.0/howto/deployment/wsgi/uwsgi/","markdown":"/pl/6.0/howto/deployment/wsgi/uwsgi.md","json":"/pl/6.0/howto/deployment/wsgi/uwsgi.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/deployment/wsgi/uwsgi.txt","official":"https://docs.djangoproject.com/pl/6.0/howto/deployment/wsgi/uwsgi/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}