Django二级域名路由配置方案django-hosts
最终效果
●http://www.mydomain.cn/api/ --> http://api.mydomain.cn/
●http://www.mydomain.cn/blog/ --> http://blog.mydomain.cn/
●http://www.mydomain.cn/ --> http://www.mydomain.cn/ 保持不变
项目结构
基础配置
# blogs/settings.py
ALLOWED_HOSTS = [
'.mydomain.cn', # 匹配.mydomain.cn的所有域名
]
修改主机的hosts，以支持域名访问本地服务，且服务运行在80端口run server 0.0.0.0:80测试。
127.0.0.1 www.mydomain.cn
127.0.0.1 blog.mydomain.cn
127.0.0.1 api.mydomain.cn
项目主urls
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('blog/', include('blog.urls', namespace='blog')),
path('api/', include('api.urls', namespace='api')),
path('', include('www.urls', namespace='www')),
]
项目 www - url
from django.urls import path
from .views import index
app_name = 'www'
urlpatterns = [
path('', index, name='index'),
]
<!-- apps/www/templates/www/index.html -->
<h2>项目主页</h2>
<h4><a href="{% url 'blog:index' %}">博客</a></h4>
<h4><a href="{% url 'api:index' %}">接口</a></h4>
访问 http://www.mydomain.cn/
博客blog urls apps/blog/urls.py
from django.urls import path
from .views import index, blog_list, blog_detail
app_name = 'blog'
urlpatterns = [
path('', index, name='index'),
path('list/', blog_list, name='list'),
path('detail/<str:blog_id>/', blog_detail, name='detail'),
]
<!-- apps/blog/templates/blog/index.html -->
<h2>BLOG主页</h2>
<a href="{% url 'blog:list' %}">进入BLOG列表</a>
<!-- apps/blog/templates/blog/list.html -->
<h4><a href="{% url 'blog:index' %}">返回BLOG主页</a></h4>
<ul>
<li><a href="{% url 'blog:detail' 1 %}">进入BLOG详情1</a></li>
<li><a href="{% url 'blog:detail' 2 %}">进入BLOG详情2</a></li>
</ul>
<!-- apps/blog/templates/blog/detail.html -->
<h2>BLOG详情</h2>
<h4><a href="{% url 'blog:list' %}">返回BLOG列表</a></h4>
<b>BLOG正文：</b>
当前访问的ID：{{ blog_id }}
django-hosts配置
实现 http://www.mydomain.cn/blog/ --> http://blog.mydomain.cn/
现在如果直接访问 http://blog.mydomain.cn/ 是显示的项目主页，因为没有具体路径的url都由path('', include('www.urls', namespace='www')),去匹配
安装
pip install django-hosts
配置settings.py
添加 django_hosts 到 INSTALLED_APPS
# blogs/settings.py
INSTALLED_APPS = [
......
'django_hosts', # pip install django-hosts 安装，添加app（第1步）
......
]
MIDDLEWARE = [
'django_hosts.middleware.HostsRequestMiddleware', # django-hosts 必须添加到最前面（第2步）
'django.middleware.security.SecurityMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.common.CommonMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
'django_hosts.middleware.HostsResponseMiddleware', # django-hosts 必须添加到最后面（第3步）
]
在主项目下创建hosts.py 文件，创建一个包含默认主机模式的新模块
第4步，在ROOT_URLCONF之后增加，指定hosts.py文件可引用位置，设置 ROOT_HOSTCONF 包含hosts.py文件的模块
# blogs/settings.py
ROOT_HOSTCONF = 'blogs.hosts'
第5步，设置DEFAULT_HOST，没匹配到的就用该模式，django-hosts ROOT_HOSTCONF之后增加，设置默认模式匹配。如果没有其他模式匹配，或者没有为host_url模板标记指定名称，则将使用它。
# blogs/settings.py
DEFAULT_HOST = 'www'
第6步设置PARENT_HOST显示域部分，如果想在呈现的URL的域部分附加一个默认域名，否则就只有“blog/index/”，而不是“blog.domain.cn/index/”
# blogs/settings.py
PARENT_HOST = 'mydomain.cn'
配置hosts.py
# blogs/hosts.py
"""
创建一个包含默认主机模式的新模块的hosts.py文件中。
"""
from django.conf import settings
from django_hosts import patterns, host
host_patterns = patterns('', # 配置模式的正则表达式，如果要使用https，在需要的host中增加 scheme='https://' 属性（第7步）
host(r'www', settings.ROOT_URLCONF, name='www'), # http://www.domain.cn/ 直接请求主urls中配置的路由
host(r'api', 'api.urls', name='api'), # http://api.mydomain.cn/
host(r'blog', 'blog.urls', name='blog'), # http://blog.mydomain.cn/
)
此时刷新 http://blog.mydomain.cn/ 是会报错的
django.urls.exceptions.NoReverseMatch: 'blog' is not a registered namespace
配置html
在模板中，可以使用host_url()template tag来反向使用Django的URL template tag，需要添加{% load hosts %}
●BLOG主页
<!-- apps/blog/templates/blog/index.html -->
{% load hosts %}
<h2>BLOG主页</h2>
{#<a href="{% url 'blog:list' %}">进入BLOG列表</a>#}
<h4><a href="{% host_url 'list' host 'blog' %}">进入BLOG列表（django-hosts）</a></h4>
就不能使用<a href="{% url 'blog:list' %}">进入BLOG列表</a>，这会导致报错。
注意：任何与该App有关的用过host_url的模板中，都不能出现Django中的url，否则会出现问题'app' is not a registered namespace
现在BLOG列表的链接就是http://blog.mydomain.cn/list/
●BLOG列表
<!-- apps/blog/templates/blog/list.html -->
{% load hosts %}
<h4><a href="{% host_url 'index' host 'blog' %}">返回BLOG主页</a></h4>
<ul>
{# <li><a href="{% url 'blog:detail' 1 %}">进入BLOG详情1</a></li>#}
{# <li><a href="{% url 'blog:detail' 2 %}">进入BLOG详情2</a></li>#}
<li><a href="{% host_url 'detail' 1 host 'blog' %}">进入BLOG详情1</a></li>
<li><a href="{% host_url 'detail' 2 host 'blog' %}">进入BLOG详情2</a></li>
</ul>
如果是需要传递参数<li><a href="{% url 'blog:detail' 1 %}">进入BLOG详情1</a></li>，也要做类似的改动<li><a href="{% host_url 'detail' 1 host 'blog' %}">进入BLOG详情1（django-hosts）</a></li>
现在BLOG详情的链接就是http://blog.mydomain.cn/detail/1/
●BLOG详情
<!-- apps/blog/templates/blog/detail.html -->
{% load hosts %}
<h2>BLOG详情</h2>
<h4><a href="{% host_url 'list' host 'blog' %}">返回BLOG列表</a></h4>
<b>BLOG正文：</b>
当前访问的ID：{{ blog_id }}
视图中反向url
在Python方面，比如视图，类似于Django的单向函数。只需使用django_hosts中的reverse()函数
# apps/blog/views.py
from django.shortcuts import render
from django_hosts.resolvers import reverse
def index(request):
blog_99_url = reverse('detail', args=(99,), host='blog')
return render(request, 'blog/index.html', {'blog_99_url': blog_99_url})
在模板中显示该url
<!-- apps/blog/templates/blog/index.html -->
<!DOCTYPE html>
{% load hosts %}
<html lang="en">
<head>
<meta charset="UTF-8">
<title>BLOG主页</title>
</head>
<body>
<h2>BLOG主页</h2>
{#<a href="{% url 'blog:list' %}">进入BLOG列表</a>#}
<h4><a href="{% host_url 'list' host 'blog' %}">进入BLOG列表（django-hosts）</a></h4>
<a href="{{ blog_99_url }}" target="_blank">推荐阅读 {{ blog_99_url }}</a>
</body>
</html>
得到blog_99_url的连接为http://blog.mydomain.cn/detail/99/
点进去就可以得到
media文件加载404问题
修改原App urls.py
# blog urls apps/blog/urls.py
from django.conf import settings
from django.conf.urls.static import static
from django.urls import path
from .views import index, blog_list, blog_detail
app_name = 'blog'
urlpatterns = [
path('', index, name='index'),
path('list/', blog_list, name='list'),
path('detail/<str:blog_id>/', blog_detail, name='detail'),
]
if settings.DEBUG:
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
当DEBUG模式时，增加media的路径，而不用hosts时，media是配置到项目主 urls.py 中的
Nginx的配置只需要将子域名都绑定到对应的启动端口即可，后端根据子域名进行不同的路由。 另外这也会存在跨域问题，比如http://blog.mydomain.cn/登录是在http://www.mydomain.cn/usercenter/login/这个链接。
