Cách thiết lập Django với Postgres, Nginx và Gunicorn trên Ubuntu 16.04

Django là một khung công tác web mạnh mẽ có thể giúp bạn khởi động ứng dụng Python hoặc trang web của bạn . Django bao gồm một server phát triển được đơn giản hóa để kiểm tra mã local của bạn, nhưng đối với bất kỳ thứ gì thậm chí liên quan đến production một chút, cần phải có một web server mạnh mẽ và an toàn hơn.

---

Trong hướng dẫn này, ta sẽ trình bày cách cài đặt và cấu hình một số thành phần trên Ubuntu 16.04 để hỗ trợ và phục vụ các ứng dụng Django. Ta sẽ cài đặt database PostgreSQL thay vì sử dụng database SQLite mặc định. Ta sẽ cấu hình server ứng dụng Gunicorn để giao diện với các ứng dụng của ta . Sau đó, ta sẽ cài đặt Nginx để đảo ngược proxy cho Gunicorn, cấp cho ta quyền truy cập vào các tính năng bảo mật và hiệu suất của nó để phục vụ các ứng dụng của ta .

Yêu cầu và Mục tiêu

Để hoàn thành hướng dẫn này, bạn nên có version server Ubuntu 16.04 mới với user không phải root có quyền sudo cấu hình . Bạn có thể tìm hiểu cách cài đặt điều này bằng cách chạy qua hướng dẫn cài đặt server ban đầu của ta .

Ta sẽ cài đặt Django trong môi trường ảo. Việc cài đặt Django vào một môi trường dành riêng cho dự án của bạn sẽ cho phép các dự án của bạn và các yêu cầu của chúng được xử lý riêng biệt.

Khi ta đã cài đặt và chạy database và ứng dụng của bạn , ta sẽ cài đặt và cấu hình server ứng dụng Gunicorn. Điều này sẽ đóng role như một giao diện cho ứng dụng của ta , dịch các yêu cầu của khách hàng trong các cuộc gọi HTTP sang Python mà ứng dụng của ta có thể xử lý. Sau đó, ta sẽ cài đặt Nginx trước Gunicorn để tận dụng các cơ chế xử lý kết nối hiệu suất cao và các tính năng bảo mật dễ triển khai của nó.

Bắt đầu nào.

Cài đặt các Gói từ Kho lưu trữ Ubuntu

Để bắt đầu quá trình, ta sẽ download và cài đặt tất cả các mục ta cần từ repository Ubuntu. Ta sẽ sử dụng pip quản lý gói Python để cài đặt các thành phần bổ sung sau một chút.

Ta cần cập nhật index gói apt local , sau đó download và cài đặt các gói. Các gói ta cài đặt phụ thuộc vào version Python nào mà dự án của bạn sẽ sử dụng.

Nếu bạn đang sử dụng Python 2 , hãy nhập:

sudo apt-get update 
sudo apt-get install python-pip python-dev libpq-dev postgresql postgresql-contrib nginx 

Nếu bạn đang sử dụng Django với Python 3 , hãy nhập:

sudo apt-get update 
sudo apt-get install python3-pip python3-dev libpq-dev postgresql postgresql-contrib nginx 

Điều này sẽ cài đặt pip , các file phát triển Python cần thiết để xây dựng Gunicorn sau này, hệ thống database Postgres và các thư viện cần thiết để tương tác với nó và web server Nginx.

Tạo Database và User PostgreSQL

Ta sẽ bắt đầu ngay lập tức và tạo database và user database cho ứng dụng Django của ta .

Theo mặc định, Postgres sử dụng một schemas xác thực được gọi là “xác thực ngang hàng” cho các kết nối local . Về cơ bản, điều này nghĩa là nếu tên user hệ điều hành của user trùng với tên user Postgres hợp lệ, user đó có thể đăng nhập mà không cần xác thực thêm.

Trong quá trình cài đặt Postgres, user hệ điều hành có tên là postgres đã được tạo để tương ứng với admin-user PostgreSQL của postgres . Ta cần sử dụng user này để thực hiện các việc quản trị. Ta có thể sử dụng sudo và nhập tên user với tùy chọn -u.

Đăng nhập vào một phiên Postgres tương tác bằng lệnh :

sudo -u postgres psql 

Bạn sẽ nhận được dấu nhắc PostgreSQL để ta có thể cài đặt các yêu cầu của bạn .

Đầu tiên, tạo database cho dự án của bạn:

CREATE DATABASE myproject; 

Mọi câu lệnh Postgres phải kết thúc bằng dấu chấm phẩy, vì vậy hãy đảm bảo lệnh của bạn kết thúc bằng một câu lệnh nếu bạn đang gặp sự cố.

Tiếp theo, tạo một user database cho dự án của ta . Đảm bảo chọn một password an toàn:

CREATE USER myprojectuser WITH PASSWORD 'password'; 

Sau đó, ta sẽ sửa đổi một vài thông số kết nối cho user mà ta vừa tạo. Điều này sẽ tăng tốc hoạt động database để các giá trị chính xác không phải được truy vấn và đặt mỗi khi kết nối được cài đặt .

Ta đang đặt mã hóa mặc định thành UTF-8, mà Django mong đợi. Ta cũng đang đặt schemas cách ly giao dịch mặc định thành “đọc được commit ”, ngăn chặn việc đọc từ các giao dịch không được commit . Cuối cùng, ta đang đặt múi giờ. Theo mặc định, các dự án Django của ta sẽ được đặt để sử dụng UTC . Đây là tất cả các khuyến nghị từ chính dự án Django :

ALTER ROLE myprojectuser SET client_encoding TO 'utf8'; 
ALTER ROLE myprojectuser SET default_transaction_isolation TO 'read committed'; 
ALTER ROLE myprojectuser SET timezone TO 'UTC'; 

Bây giờ, ta có thể cấp cho user mới quyền truy cập để quản lý database mới của ta :

GRANT ALL PRIVILEGES ON DATABASE myproject TO myprojectuser; 

Khi bạn hoàn tất, hãy thoát khỏi dấu nhắc PostgreSQL bằng lệnh :

\q 

Tạo môi trường ảo Python cho dự án của bạn

Bây giờ ta đã có database của bạn , ta có thể bắt đầu chuẩn bị sẵn sàng phần còn lại của các yêu cầu dự án. Ta sẽ cài đặt các yêu cầu Python của bạn trong môi trường ảo để quản lý dễ dàng hơn.

Để làm điều này, trước tiên ta cần truy cập vào lệnh virtualenv . Ta có thể cài đặt cái này bằng pip .

Nếu bạn đang sử dụng Python 2 , hãy nâng cấp pip và cài đặt gói bằng lệnh :

sudo -H pip install --upgrade pip 
sudo -H pip install virtualenv 

Nếu bạn đang sử dụng Python 3 , hãy nâng cấp pip và cài đặt gói bằng lệnh :

sudo -H pip3 install --upgrade pip 
sudo -H pip3 install virtualenv 

Với virtualenv được cài đặt, ta có thể bắt đầu hình thành dự án của bạn . Tạo và di chuyển vào một folder nơi ta có thể giữ các file dự án của bạn :

mkdir ~/myproject 
cd ~/myproject 

Trong folder dự án, hãy tạo một môi trường ảo Python bằng lệnh :

virtualenv myprojectenv 

Thao tác này sẽ tạo một folder có tên myprojectenv trong folder myproject của bạn. Bên trong, nó sẽ cài đặt version local của Python và version local của pip . Ta có thể sử dụng điều này để cài đặt và cấu hình một môi trường Python riêng biệt cho dự án của bạn .

Trước khi cài đặt các yêu cầu Python của dự án, ta cần kích hoạt môi trường ảo. Bạn có thể thực hiện bằng cách gõ:

source myprojectenv/bin/activate 

Dấu nhắc của bạn sẽ thay đổi để cho biết rằng bạn hiện đang hoạt động trong môi trường ảo Python. Nó trông giống như sau : ( myprojectenv ) user @ host :~/ myproject $ .

Với môi trường ảo của bạn đang hoạt động, hãy cài đặt Django, Gunicorn và bộ điều hợp psycopg2 PostgreSQL với version local của pip :

Dù bạn đang sử dụng version Python nào, khi môi trường ảo được kích hoạt, bạn nên sử dụng lệnh pip (không phải pip3 ).

pip install django gunicorn psycopg2 

Đến đây bạn sẽ có tất cả phần mềm cần thiết để bắt đầu một dự án Django.

Tạo và cấu hình một dự án Django mới

Với các thành phần Python được cài đặt, ta có thể tạo các file dự án Django thực tế.

Tạo Dự án Django

Vì ta đã có folder dự án, ta sẽ yêu cầu Django cài đặt các file ở đây. Nó sẽ tạo một folder cấp hai với mã thực, điều này bình thường và đặt một tập lệnh quản lý vào folder này. Key của điều này là ta đang xác định folder một cách rõ ràng thay vì cho phép Django đưa ra quyết định liên quan đến folder hiện tại của ta :

django-admin.py startproject myproject ~/myproject 

Đến đây, folder dự án của bạn ( ~/ myproject trong trường hợp của ta ) sẽ có nội dung sau:

• ~/myproject/manage.py : Một tập lệnh quản lý dự án Django.
• ~/myproject/myproject/ : Gói dự án Django. Điều này phải chứa các file __init__.py , settings.py , urls.py và wsgi.py
• ~/myproject/myprojectenv/ : Thư mục môi trường ảo mà ta đã tạo trước đó.

Điều chỉnh cài đặt dự án

Điều đầu tiên ta nên làm với các file dự án mới tạo của bạn là điều chỉnh cài đặt. Mở file cài đặt trong editor của bạn:

nano ~/myproject/myproject/settings.py 

Bắt đầu bằng cách định vị chỉ thị ALLOWED_HOSTS . Điều này xác định danh sách các địa chỉ của server hoặc domain được dùng để kết nối với version Django. Bất kỳ yêu cầu nào đến có tiêu đề Server lưu trữ không có trong danh sách này sẽ dẫn đến một ngoại lệ. Django yêu cầu bạn cài đặt điều này để ngăn chặn một lớp lỗ hổng bảo mật nhất định.

Trong dấu ngoặc vuông, liệt kê các địa chỉ IP hoặc domain được liên kết với server Django của bạn. Mỗi mục nên được liệt kê trong phần trích dẫn với các mục được phân tách bằng dấu phẩy. Nếu bạn muốn có yêu cầu cho toàn bộ domain và bất kỳ domain phụ nào, hãy thêm một khoảng thời gian vào đầu mục nhập. Trong đoạn mã dưới đây, có một vài ví dụ được comment được sử dụng để chứng minh:

. . . # The simplest case: just add the domain name(s) and IP addresses of your Django server # ALLOWED_HOSTS = [ 'example.com', '203.0.113.5'] # To respond to 'example.com' and any subdomains, start the domain with a dot # ALLOWED_HOSTS = ['.example.com', '203.0.113.5'] ALLOWED_HOSTS = ['your_server_domain_or_IP', 'second_domain_or_IP', . . .] 

Tiếp theo, tìm phần cấu hình quyền truy cập database . Nó sẽ bắt đầu với DATABASES . Cấu hình trong file dành cho database SQLite. Ta đã tạo database PostgreSQL cho dự án của bạn , vì vậy ta cần điều chỉnh cài đặt.

Thay đổi cài đặt với thông tin database PostgreSQL của bạn. Ta yêu cầu Django sử dụng bộ điều hợp psycopg2 mà ta đã cài đặt bằng pip . Ta cần cung cấp tên database , tên user database , password của user database và sau đó chỉ định rằng database được đặt trên máy tính local . Bạn có thể để cài đặt PORT dưới dạng một chuỗi trống:

. . .  DATABASES = {     'default': {         'ENGINE': 'django.db.backends.postgresql_psycopg2',         'NAME': 'myproject',         'USER': 'myprojectuser',         'PASSWORD': 'password',         'HOST': 'localhost',         'PORT': '',     } }  . . . 

Tiếp theo, di chuyển xuống cuối file và thêm cài đặt cho biết vị trí các file tĩnh sẽ được đặt. Điều này là cần thiết để Nginx có thể xử lý các yêu cầu cho các mục này. Dòng sau yêu cầu Django đặt chúng vào một folder được gọi là static trong folder dự án cơ sở:

. . .  STATIC_URL = '/static/' STATIC_ROOT = os.path.join(BASE_DIR, 'static/') 

Lưu file khi bạn hoàn tất.

Hoàn thành cài đặt dự án ban đầu

Bây giờ, ta có thể di chuyển schemas database ban đầu sang database PostgreSQL của ta bằng cách sử dụng tập lệnh quản lý:

~/myproject/manage.py makemigrations 
~/myproject/manage.py migrate 

Tạo admin-user cho dự án bằng lệnh :

~/myproject/manage.py createsuperuser 

Bạn sẽ phải chọn tên user , cung cấp địa chỉ email, chọn và xác nhận password .

Ta có thể thu thập tất cả nội dung tĩnh vào vị trí folder mà ta đã cấu hình bằng lệnh :

~/myproject/manage.py collectstatic 

Bạn sẽ phải xác nhận hoạt động. Các file tĩnh sau đó sẽ được đặt trong một folder được gọi là static trong folder dự án của bạn.

Nếu bạn đã làm theo hướng dẫn cài đặt server ban đầu, bạn phải có firewall UFW bảo vệ server của bạn . Để kiểm tra server phát triển, ta sẽ phải cho phép truy cập vào cổng mà ta sẽ sử dụng.

Tạo một ngoại lệ cho cổng 8000 bằng lệnh :

sudo ufw allow 8000 

Cuối cùng, bạn có thể kiểm tra dự án của ta bằng cách khởi động server phát triển Django bằng lệnh sau:

~/myproject/manage.py runserver 0.0.0.0:8000 

Trong trình duyệt web , hãy truy cập vào domain hoặc địa chỉ IP của server , sau đó là :8000 :

http://server_domain_or_IP:8000 

Bạn sẽ thấy trang index Django mặc định:

Nếu bạn thêm /admin vào cuối URL trong thanh địa chỉ, bạn sẽ được yêu cầu nhập tên user và password quản trị mà bạn đã tạo bằng lệnh createsuperuser :

Sau khi xác thực, bạn có thể truy cập giao diện quản trị Django mặc định:

Khi bạn khám phá xong, hãy nhấn CTRL-C trong cửa sổ terminal để tắt server phát triển.

Kiểm tra khả năng phục vụ dự án của Gunicorn

Điều cuối cùng ta muốn làm trước khi rời khỏi môi trường ảo của bạn là kiểm tra Gunicorn đảm bảo rằng nó có thể phục vụ ứng dụng. Ta có thể làm điều này bằng lệnh folder dự án của bạn và sử dụng gunicorn để tải module WSGI của dự án:

cd ~/myproject 
gunicorn --bind 0.0.0.0:8000 myproject.wsgi 

Thao tác này sẽ khởi động Gunicorn trên cùng giao diện mà server phát triển Django đang chạy. Bạn có thể quay lại và kiểm tra lại ứng dụng.

Lưu ý: Giao diện administrator sẽ không có bất kỳ kiểu nào được áp dụng vì Gunicorn không biết về nội dung CSS tĩnh chịu trách nhiệm cho việc này.

Ta đã chuyển cho Gunicorn một module bằng cách chỉ định đường dẫn folder tương đối đến file wsgi.py của Django, là điểm vào ứng dụng của ta , sử dụng cú pháp module của Python. Bên trong file này, một chức năng được gọi là application được định nghĩa, được sử dụng để giao tiếp với ứng dụng. Để tìm hiểu thêm về đặc điểm kỹ thuật WSGI, hãy nhấp vào đây .

Khi bạn kiểm tra xong, nhấn CTRL-C trong cửa sổ dòng lệnh để dừng Gunicorn.

Bây giờ ta đã hoàn tất việc cấu hình ứng dụng Django của bạn . Ta có thể thoát khỏi môi trường ảo của bạn bằng lệnh :

deactivate 

Chỉ báo môi trường ảo trong dấu nhắc của bạn sẽ bị xóa.

Tạo file dịch vụ hệ thống Gunicorn

Ta đã kiểm tra rằng Gunicorn có thể tương tác với ứng dụng Django của ta , nhưng ta nên triển khai một cách khởi động và dừng server ứng dụng mạnh mẽ hơn. Để thực hiện điều này, ta sẽ tạo một file dịch vụ systemd.

Tạo và mở file dịch vụ systemd cho Gunicorn với các quyền sudo trong editor của bạn:

sudo nano /etc/systemd/system/gunicorn.service 

Bắt đầu với phần [Unit] , được sử dụng để chỉ định metadata và phần phụ thuộc. Ta sẽ đặt mô tả về dịch vụ của bạn ở đây và yêu cầu hệ thống init chỉ bắt đầu điều này sau khi đã đạt được mục tiêu mạng:

[Unit] Description=gunicorn daemon After=network.target 

Tiếp theo, ta sẽ mở phần [Service] . Ta sẽ chỉ định user và group mà ta muốn xử lý để chạy. Ta sẽ cấp cho account regular user quyền sở hữu quy trình vì nó sở hữu tất cả các file có liên quan. Ta sẽ cấp quyền sở hữu group cho www-data group để Nginx có thể giao tiếp dễ dàng với Gunicorn.

Sau đó, ta sẽ vạch ra folder làm việc và chỉ định lệnh sử dụng để bắt đầu dịch vụ. Trong trường hợp này, ta sẽ phải chỉ định đường dẫn đầy đủ đến file thực thi Gunicorn, được cài đặt trong môi trường ảo của ta . Ta sẽ liên kết nó với một socket Unix trong folder dự án vì Nginx được cài đặt trên cùng một máy tính. Điều này an toàn hơn và nhanh hơn so với sử dụng cổng mạng. Ta cũng có thể chỉ định bất kỳ chỉnh sửa Gunicorn tùy chọn nào tại đây. Ví dụ: ta đã chỉ định 3 quy trình công nhân trong trường hợp này:

[Unit] Description=gunicorn daemon After=network.target  [Service] User=sammy Group=www-data WorkingDirectory=/home/sammy/myproject ExecStart=/home/sammy/myproject/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/home/sammy/myproject/myproject.sock myproject.wsgi:application 

Cuối cùng, ta sẽ thêm phần [Install] . Điều này sẽ cho systemd biết những gì để liên kết dịch vụ này nếu ta cho phép nó khởi động khi server khởi động . Ta muốn dịch vụ này bắt đầu khi hệ thống nhiều regular user được cài đặt và chạy:

[Unit] Description=gunicorn daemon After=network.target  [Service] User=sammy Group=www-data WorkingDirectory=/home/sammy/myproject ExecStart=/home/sammy/myproject/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/home/sammy/myproject/myproject.sock myproject.wsgi:application  [Install] WantedBy=multi-user.target 

Như vậy, file dịch vụ systemd của ta đã hoàn tất. Lưu và đóng nó ngay bây giờ.

Bây giờ ta có thể bắt đầu dịch vụ Gunicorn mà ta đã tạo và kích hoạt nó để nó bắt đầu khi server khởi động :

sudo systemctl start gunicorn 
sudo systemctl enable gunicorn 

Ta có thể xác nhận thao tác đã thành công bằng cách kiểm tra file socket.

Kiểm tra file Gunicorn Socket

Kiểm tra trạng thái của quá trình để tìm hiểu xem nó có thể bắt đầu hay không:

sudo systemctl status gunicorn 

Tiếp theo, kiểm tra sự tồn tại của file myproject .sock trong folder dự án của bạn:

ls /home/sammy/myproject 

Output
manage.py  myproject  myprojectenv  myproject.sock  static 

Nếu lệnh systemctl status cho biết rằng đã xảy ra lỗi hoặc nếu bạn không tìm thấy file myproject .sock trong folder , thì đó là dấu hiệu cho thấy Gunicorn không thể khởi động chính xác. Kiểm tra log quy trình Gunicorn bằng lệnh :

sudo journalctl -u gunicorn 

Hãy xem các thông báo trong log để tìm hiểu xem Gunicorn đã gặp vấn đề ở đâu. Có nhiều lý do mà bạn có thể gặp phải sự cố, nhưng thông thường, nếu Gunicorn không thể tạo file socket, đó là vì một trong những lý do sau:

• Các file dự án thuộc sở hữu của user root thay vì user sudo
• Đường dẫn WorkingDirectory trong file /etc/systemd/system/gunicorn.service không trỏ đến folder dự án
• Các tùy chọn cấu hình được cung cấp cho quy trình gunicorn trong chỉ thị ExecStart không đúng. Kiểm tra các mục sau:
  • Đường dẫn đến binary gunicorn trỏ đến vị trí thực của binary trong môi trường ảo
  • Lệnh --bind xác định file để tạo trong folder mà Gunicorn có thể truy cập
  • myproject .wsgi:application là một đường dẫn chính xác đến WSGI có thể gọi được. Điều này nghĩa là khi bạn đang ở trong WorkingDirectory , bạn có thể truy cập vào application có tên có thể gọi được bằng cách tìm trong module myproject .wsgi (được dịch thành một file có tên ./myproject/wsgi.py )

Nếu bạn thực hiện thay đổi đối với file /etc/systemd/system/gunicorn.service , hãy reload daemon để đọc lại định nghĩa dịch vụ và khởi động lại quy trình Gunicorn bằng lệnh :

sudo systemctl daemon-reload 
sudo systemctl restart gunicorn 

Đảm bảo bạn khắc phục sự cố nào ở trên trước khi tiếp tục.

Cấu hình Nginx thành Proxy Pass tới Gunicorn

Bây giờ Gunicorn đã được cài đặt , ta cần cấu hình Nginx để chuyển lưu lượng truy cập vào quy trình.

Bắt đầu bằng cách tạo và mở một khối server mới trong folder sites-available của Nginx:

sudo nano /etc/nginx/sites-available/myproject 

Bên trong, mở một khối server mới. Ta sẽ bắt đầu bằng cách chỉ định rằng khối này sẽ lắng nghe trên cổng thông thường 80 và nó sẽ phản hồi với domain hoặc địa chỉ IP của server của ta :

server {     listen 80;     server_name server_domain_or_IP; } 

Tiếp theo, ta sẽ yêu cầu Nginx bỏ qua bất kỳ vấn đề nào với việc tìm biểu tượng yêu thích. Ta cũng sẽ cho nó biết nơi tìm các tài sản tĩnh mà ta đã thu thập trong folder ~/ myproject /static của ta . Tất cả các file này đều có tiền tố URI tiêu chuẩn là “/ static”, vì vậy ta có thể tạo khối vị trí để trùng với các yêu cầu đó:

server {     listen 80;     server_name server_domain_or_IP;      location = /favicon.ico { access_log off; log_not_found off; }     location /static/ {         root /home/sammy/myproject;     } } 

Cuối cùng, ta sẽ tạo khối location / {} để trùng với tất cả các yêu cầu khác. Bên trong vị trí này, ta sẽ bao gồm file proxy_params tiêu chuẩn có trong cài đặt Nginx và sau đó ta sẽ chuyển lưu lượng truy cập đến socket mà quy trình Gunicorn của ta đã tạo:

server {     listen 80;     server_name server_domain_or_IP;      location = /favicon.ico { access_log off; log_not_found off; }     location /static/ {         root /home/sammy/myproject;     }      location / {         include proxy_params;         proxy_pass http://unix:/home/sammy/myproject/myproject.sock;     } } 

Lưu file khi bạn hoàn tất. Bây giờ, ta có thể kích hoạt file bằng cách liên kết file với folder sites-enabled :

sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled 

Kiểm tra cấu hình Nginx của bạn để tìm lỗi cú pháp bằng lệnh :

sudo nginx -t 

Nếu không có lỗi nào được báo cáo, hãy tiếp tục và khởi động lại Nginx bằng lệnh :

sudo systemctl restart nginx 

Cuối cùng, ta cần mở firewall của bạn để lưu lượng truy cập bình thường trên cổng 80. Vì ta không cần truy cập vào server phát triển nữa, ta cũng có thể loại bỏ luật để mở cổng 8000:

sudo ufw delete allow 8000 
sudo ufw allow 'Nginx Full' 

Đến đây bạn có thể truy cập domain hoặc địa chỉ IP của server để xem ứng dụng của bạn .

Sau khi cấu hình Nginx, bước tiếp theo phải đảm bảo lưu lượng truy cập vào server bằng SSL / TLS. Điều này rất quan trọng vì không có nó, tất cả thông tin, bao gồm cả password được gửi qua mạng ở dạng văn bản thuần túy.

Nếu bạn có domain , cách dễ nhất để có được certificate SSL đảm bảo lưu lượng truy cập của bạn là sử dụng Let's Encrypt. Làm theo hướng dẫn này để cài đặt Let's Encrypt with Nginx trên Ubuntu 16.04.

Nếu bạn không có domain , bạn vẫn có thể bảo mật trang web của bạn để thử nghiệm và học hỏi bằng chứng chỉ SSL tự ký .

Khắc phục sự cố Nginx và Gunicorn

Nếu bước cuối cùng này không hiển thị ứng dụng của bạn, bạn cần khắc phục sự cố cài đặt của bạn .

Nginx đang hiển thị trang mặc định thay vì ứng dụng Django

Nếu Nginx hiển thị các trang mặc định thay vì proxy để ứng dụng của bạn, nó thường nghĩa là bạn cần phải điều chỉnh server_name trong /etc/nginx/sites-available/ myproject file để trỏ đến địa chỉ hoặc domain tên IP của server .

Nginx sử dụng server_name để xác định khối server nào sẽ sử dụng để phản hồi các yêu cầu. Nếu bạn nhìn thấy trang Nginx mặc định, đó là dấu hiệu cho thấy Nginx không thể khớp yêu cầu với khối server một cách rõ ràng, vì vậy nó đang rơi trở lại khối mặc định được xác định trong /etc/nginx/sites-available/default .

server_name trong khối server của dự án của bạn phải cụ thể hơn tên trong khối server mặc định được chọn.

Nginx đang hiển thị lỗi 502 Bad Gateway thay vì ứng dụng Django

Lỗi 502 cho biết Nginx không thể ủy quyền thành công yêu cầu. Một loạt các sự cố cấu hình tự biểu hiện bằng lỗi 502, vì vậy cần có thêm thông tin để khắc phục sự cố đúng cách.

Nơi chính để tìm kiếm thêm thông tin là trong log lỗi của Nginx. Nói chung, điều này sẽ cho bạn biết những điều kiện nào gây ra sự cố trong sự kiện ủy quyền. Theo dõi log lỗi Nginx bằng lệnh :

sudo tail -F /var/log/nginx/error.log 

Bây giờ, hãy thực hiện một yêu cầu khác trong trình duyệt của bạn để tạo ra một lỗi mới (thử làm mới trang). Bạn sẽ thấy một thông báo lỗi mới được ghi vào log . Nếu bạn nhìn vào thông báo, nó sẽ giúp bạn thu hẹp vấn đề.

Bạn có thể thấy một số thông báo sau:

kết nối () với unix: /home/sammy/myproject/myproject.sock không thành công (2: Không có file hoặc folder như vậy)

Điều này cho thấy rằng Nginx không thể tìm thấy file myproject.sock tại vị trí đã cho. Bạn nên so sánh vị trí proxy_pass được xác định trong proxy_pass /etc/nginx/sites-available/myproject với vị trí thực của file myproject.sock được tạo trong folder dự án của bạn.

Nếu bạn không thể tìm thấy file myproject.sock trong folder dự án của bạn , điều đó thường nghĩa là quá trình gunicorn không thể tạo nó. Quay lại phần kiểm tra file socket Gunicorn để thực hiện các bước khắc phục sự cố cho Gunicorn.

connect () với unix: /home/sammy/myproject/myproject.sock không thành công (13: Quyền bị từ chối)

Điều này cho thấy rằng Nginx không thể kết nối với socket Gunicorn do các vấn đề về quyền. Thông thường, điều này xảy ra khi quy trình được tuân theo bằng cách sử dụng user root thay vì user sudo . Mặc dù quy trình Gunicorn có thể tạo file socket, nhưng Nginx không thể truy cập nó.

Điều này có thể xảy ra nếu có các quyền hạn chế tại bất kỳ điểm nào giữa folder root ( / ) file myproject.sock . Ta có thể thấy các quyền và giá trị quyền sở hữu của file socket và từng folder mẹ của nó bằng cách chuyển đường dẫn tuyệt đối đến file socket của ta tới lệnh namei :

namei -nom /home/sammy/myproject/myproject.sock 

Output
f: /home/sammy/myproject/myproject.sock  drwxr-xr-x root  root     /  drwxr-xr-x root  root     home  drwxr-xr-x sammy sammy    sammy  drwxrwxr-x sammy sammy    myproject  srwxrwxrwx sammy www-data myproject.sock 

Đầu ra hiển thị các quyền của từng thành phần folder . Bằng cách xem xét các quyền (cột đầu tiên), chủ sở hữu (cột thứ hai) và chủ sở hữu group (cột thứ ba), ta có thể tìm ra loại quyền truy cập nào được phép đối với file socket.

Trong ví dụ trên, file socket và mỗi folder dẫn đến file socket có quyền đọc và thực thi thế giới (cột quyền cho các folder kết thúc bằng rx thay vì --- ). Quá trình Nginx sẽ có thể truy cập thành công socket .

Nếu bất kỳ folder nào dẫn đến socket không có quyền đọc và thực thi thế giới, Nginx sẽ không thể truy cập vào socket mà không cho phép quyền đọc và thực thi thế giới hoặc đảm bảo quyền sở hữu group được trao cho một group mà Nginx là một phần của. Đối với các vị trí nhạy cảm như folder /root , cả hai tùy chọn trên đều nguy hiểm. Tốt hơn là di chuyển các file dự án ra bên ngoài folder , nơi bạn có thể kiểm soát quyền truy cập một cách an toàn mà không ảnh hưởng đến bảo mật.

Django đang hiển thị: "không thể kết nối với server : Kết nối bị từ chối"

Một thông báo mà bạn có thể thấy từ Django khi cố gắng truy cập các phần của ứng dụng trong trình duyệt web là:

OperationalError at /admin/login/ could not connect to server: Connection refused     Is the server running on host "localhost" (127.0.0.1) and accepting     TCP/IP connections on port 5432? 

Điều này cho biết Django không thể kết nối với database Postgres. Đảm bảo rằng version Postgres đang chạy bằng lệnh :

sudo systemctl status postgresql 

Nếu không, bạn có thể khởi động nó và cho phép nó tự động khởi động khi server khởi động (nếu nó chưa được cấu hình để thực hiện ) bằng lệnh :

sudo systemctl start postgresql 
sudo systemctl enable postgresql 

Nếu bạn vẫn gặp sự cố, hãy đảm bảo cài đặt database được xác định trong file ~/myproject/myproject/settings.py là chính xác.

Khắc phục sự cố thêm

Để khắc phục sự cố bổ sung, log có thể giúp thu hẹp các nguyên nhân root rễ. Lần lượt kiểm tra từng cái và tìm kiếm thông báo chỉ ra các khu vực có vấn đề.

Các bản ghi sau đây có thể hữu ích:

• Kiểm tra log tiến trình Nginx bằng lệnh : sudo journalctl -u nginx
• Kiểm tra log truy cập Nginx bằng lệnh : sudo less /var/log/nginx/access.log
• Kiểm tra log lỗi Nginx bằng lệnh : sudo less /var/log/nginx/error.log
• Kiểm tra log ứng dụng Gunicorn bằng lệnh : sudo journalctl -u gunicorn

Khi cập nhật cấu hình hoặc ứng dụng của bạn , bạn có thể cần phải khởi động lại các quy trình để điều chỉnh các thay đổi của bạn .

Nếu cập nhật ứng dụng Django của bạn , bạn có thể khởi động lại quy trình Gunicorn để nhận các thay đổi bằng lệnh :

sudo systemctl restart gunicorn 

Nếu bạn thay đổi file dịch vụ gunicorn systemd, hãy reload daemon và khởi động lại quá trình bằng lệnh :

sudo systemctl daemon-reload 
sudo systemctl restart gunicorn 

Nếu bạn thay đổi cấu hình khối server Nginx, hãy kiểm tra cấu hình rồi đến Nginx bằng lệnh :

sudo nginx -t && sudo systemctl restart nginx 

Các lệnh này hữu ích để chọn các thay đổi khi bạn điều chỉnh cấu hình của bạn .

Kết luận

Trong hướng dẫn này, ta đã cài đặt một dự án Django trong môi trường ảo của riêng nó. Ta đã cấu hình Gunicorn để dịch các yêu cầu của khách hàng để Django có thể xử lý chúng. Sau đó, ta cài đặt Nginx hoạt động như một Reverse Proxy để xử lý các kết nối của client và phục vụ đúng dự án tùy thuộc vào yêu cầu của khách hàng.

Django làm cho việc tạo các dự án và ứng dụng trở nên đơn giản bằng cách cung cấp nhiều phần chung, cho phép bạn tập trung vào các yếu tố độc đáo. Bằng cách tận dụng chuỗi công cụ chung được mô tả trong bài viết này, bạn có thể dễ dàng phục vụ các ứng dụng bạn tạo từ một server duy nhất.

---

---

Các tin liên quan

Cách cung cấp các ứng dụng Django với uWSGI và Nginx trên Ubuntu 16.04
2016-05-16
Cách cài đặt Nginx trên Ubuntu 16.04
2016-04-21
Cách tạo chứng chỉ SSL tự ký cho Nginx trong Ubuntu 16.04
2016-04-21
Cách cài đặt Discourse Behind Nginx trên Ubuntu 14.04
2016-04-19
Cách thiết lập Nginx với Hỗ trợ HTTP / 2 trên Ubuntu 16.04
2016-04-12
Cách thêm module gzip vào Nginx trên CentOS 7
2016-03-15
Cách thêm module gzip vào Nginx trên Ubuntu 14.04
2016-03-09
Cách thiết lập xác thực HTTP cơ bản với Nginx trên Ubuntu 14.04
2016-02-22
Cách thiết lập xác thực HTTP cơ bản với Nginx trên CentOS 7
2016-02-22
Cách bảo mật Nginx trên Ubuntu 14.04
2016-02-12