Django 每一个App配置独立域名

环境：Python 3.8.1 + Django 2.2.12

为整合流程规范，部署了综合型的项目，包含了 task (需求系统)，doc (文档系统)，sso (单点登陆系统)，

大体的目录结构：

CellMiddle  -- 项目根目录
├─task --- 需求系统
│  ├─migrations
│  ├─static
│  └─templates
├─logs --- 日志目录
├─doc --- 文档系统
│  ├─data
│  ├─migrations
│  ├─static
│  └─templates
├─sso --- 单点登陆，权限控制系统
│  ├─migrations
│  ├─static
│  └─templates
├─upload ---文件资源上传目录
├─static --- 静态资源
├─templates --- 公共模板
└─CellMiddle --- 项目主目录
│    ├─config --- 公共配置
│    ├─helper --- 公共辅助类，ex：时间，日期，字符串，响应等
│    └─loader --- 第三方库的实例化加载，ex：Redis，Memcached等
│    │  settings.py
│    │  urls.py
│    │  wsgi.py
│    │  __init__.py
├─manage.py
└─envConf  -- 部署配置文件：requirement.txt， host.conf, supervisor, gunicorn 等

使用 nginx + gunicorn + supervisor 部署，使用域名 cell.hao456.com 解析指向服务器， nginx 监听 gunicorn 绑定的端口，能够正常访问：

http://cell.hao456.com/task
http://cell.hao456.com/doc
http://cell.hao456.com/sso

虽然同一个域名路由控制来访问，也是能够的。但仍是想像PHP同样只要独立入口文件，每一个app独立使用不一样子域名，如：

http://task.hao456.com 指向task
http://doc.hao456.com  指向doc
http://sso.hao456.com  指向sso

尝试了几种办法：

1. nginx 层转发；

   • 修改proxy指向，location 要加app，static 等。

2. 每一个app独立一个 wsgi.py 文件，使用gunicorn单独起服务；

   • 增长 task_wsgi.py, doc_wsgi.py, sso_wsgi.py，使用 supervisor起三个gunicorn服务。

3. 使用django-hosts；

   • 添加MIDDLEWARE中间件，实现host与urls的namespace关联。nginx的conf配置不用改动，只须要将 全部子域名的监听，一块儿代理指向gunicorn端口，

$ cat hosts.conf
server {
    listen 80;
    server_name task.hao456.com doc.hao456.com sso.hao456.com;
    location / {
        proxy_pass http://127.0.0.1:10888;
        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;
        proxy_read_timeout 120s;
    }
    ... ...
}

django-hosts实现：

1. pip 安装 django-hosts， 这里用到的是 4.0版本：

$ pip install django-hosts==4.0  # root权限

2. 修改settings.py：
   • 将django-hosts添加到app：

INSTALLED_APPS = [
        ...
        'django_hosts',
        'sso',
        'doc',
        'task',
    ]

- 添加Django的hosts配置：

ROOT_HOSTCONF = 'CellMiddle.hosts'  # host配置
    DEFAULT_HOST = 'sso'  # 默认的域名

- 将django_hosts添加到中间件MIDDLEWARE：

MIDDLEWARE = [
    'django_hosts.middleware.HostsRequestMiddleware',  # 首要加
    ...
    'django_hosts.middleware.HostsRequestMiddleware',  # 尾要加
]

3. 在项目主目录下settings.py同级，添加 hosts.py（注意和 settings 里面配置的ROOT_HOSTCONF一致）：

...
└─CellMiddle
    │  hosts.py  --- 新增文件
    │  settings.py
    │  urls.py
    │  wsgi.py
    │  __init__.py

内容为：

# coding=utf8
    """
    django-hosts
    """
    from django.conf import settings
    from django_hosts import patterns, host

    host_patterns = patterns(
        '',
        host('sso', settings.ROOT_URLCONF, name='sso'),
        host('doc', 'doc.urls', name='doc'),
        host('task', 'task.urls', name='task'),
    )

4. 路由配置urls.py，添加路由对应的appname（app名称）, namespace(域名)：

urlpatterns = [
        path('admin/', admin.site.urls),
        path('', include(('sso.urls', 'sso'), namespace='sso')),  # 默认sso
        path('doc', include(('doc.urls', 'doc'), namespace='doc')),  # 文档
        path('task', include(('task.urls', 'task'), namespace='task')),  # 需求
    ]

5. reload 重载服务：

• DNS 确认子域名的解析;
• 检查nginx的配置有效性，重载nginx;
• 动态更新Web服务 或 在 supervisorctl重启Web服务；

$ kill -HUP PID  # root权限
$ supervisorctl restart program_name服务名  # root权限

6. 检查子域名的访问，app对应的路由，静态资源访问等是否正常；