Django部署香港服务器：Nginx+Gunicorn配置指南

在Python开发中，Django框架凭借全栈特性广受欢迎。当需要将Django应用上线时，选择香港服务器既能覆盖亚太用户低延迟访问，又需掌握Nginx+Gunicorn的部署技巧。本文将从新手视角拆解这一过程，帮你快速完成生产环境搭建。

前置准备：确保环境就绪

部署前需确认香港服务器已安装必要工具：Python（建议3.8+）、Django框架、Nginx（高性能Web服务器）及Gunicorn（WSGI服务器，用于衔接Web服务器与Python应用）。若未安装Gunicorn，可通过命令行执行：

pip install gunicorn  # 基于Python包管理工具安装

同时需确保本地Django项目已完成开发测试，执行`python manage.py runserver`能在本地8000端口正常访问页面。

Gunicorn核心配置：启动Django应用

Gunicorn作为WSGI（Web Server Gateway Interface，Python应用与Web服务器通信的标准接口）服务器，负责直接处理Django应用的请求响应。进入项目根目录后，创建配置文件`gunicorn_config.py`：

bind = '127.0.0.1:8000'  # 监听本地8000端口，仅内部通信
workers = 3  # 工作进程数，建议按CPU核心数×2+1调整（如2核设为5）
timeout = 30  # 超时时间，防止长时间无响应

通过命令启动Gunicorn：

gunicorn -c gunicorn_config.py your_project.wsgi:application

（注：`your_project`替换为实际项目名，`wsgi:application`是Django自动生成的WSGI入口对象）
启动后可通过`curl 127.0.0.1:8000`测试，若返回页面内容则Gunicorn运行正常。

Nginx反向代理：对外提供服务

Nginx作为反向代理服务器，负责接收用户的HTTP请求，转发给Gunicorn处理，并承担静态文件托管、负载均衡等职责。在`/etc/nginx/sites-available/`目录下创建配置文件`your_project.conf`：

server {
    listen 80;  # 监听HTTP默认端口
    server_name example.com;  # 替换为你的域名或服务器公网IP

    location / {  # 所有动态请求转发至Gunicorn
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;  # 传递原始请求头信息
        proxy_set_header X-Real-IP $remote_addr;  # 记录真实客户端IP
    }

    location /static/ {  # 静态文件直接由Nginx处理
        root /path/to/your/project;  # 替换为项目静态文件绝对路径
    }
}

完成配置后需激活并验证：
1. 创建软链接到`sites-enabled`目录：

ln -s /etc/nginx/sites-available/your_project.conf /etc/nginx/sites-enabled/

2. 检查配置语法：

nginx -t  # 输出"test is successful"表示配置正确

3. 重载Nginx服务：

systemctl reload nginx

部署测试与常见问题

通过浏览器访问`http://example.com`（或服务器公网IP），若能正常显示Django页面则部署成功。若遇到问题可通过以下方式排查：
- 502 Bad Gateway：检查Gunicorn是否运行（`ps aux | grep gunicorn`），或查看Nginx错误日志`/var/log/nginx/error.log`。
- 静态文件加载失败：确认`location /static/`中的`root`路径与项目实际静态文件路径一致，可通过`python manage.py collectstatic`收集静态文件到指定目录。

通过Nginx+Gunicorn组合部署香港服务器，既能利用Nginx的高并发处理能力，又能发挥Gunicorn对Django的原生支持，是亚太地区Django应用上线的经典方案。掌握这一流程后，你可以更高效地将本地开发的Django项目推向生产环境。