Django结合xadmin搭建后台管理系统的完整流程

周末不加班

发布时间：2026-10-13 | 6人浏览过

原创

本文详细讲解如何使用Django框架结合xadmin插件构建后台管理系统。内容涵盖项目创建、服务器运行、语言时区设置、MySQL数据库配置、管理员账号创建以及xadmin的安装与集成步骤，帮助开发者快速搭建可管理的Web应用后台。

Django部分

Django基础项目构建与配置

首先进行项目创建。


django-admin startproject mysite #创建一个mysite项目

接着启动简易服务器以验证环境。


python manage.py runserver #欢迎页面http://127.0.0.1:8000

随后配置系统的语言偏好与时间区域设置。


//文件名：settings.py
*********************
LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

接下来需要设定MySQL数据库连接参数。

在执行数据库迁移前，务必确保已在MySQL中预先创建好对应的数据库实例。


********项目目录下的__init__.py文件添加如下代码********
import pymysql
pymysql.install_as_MySQLdb()
*******************END****************************

***************settings.py文件*********************
DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.mysql',
    'HOST': 'localhost',
    'PORT': '3306',
    'NAME': 'dadi',
    'USER': 'root',
    'PASSWORD': 'root',
  }
}
****************END********************************

执行数据库迁移命令以生成数据表结构。


python manage.py migrate #根据setting.py文件创建数据库表

创建具有超级权限的管理员账号以便后续登录。


python manage.py createsuperuser

至此，基础的Django项目结构已构建完毕。通过浏览器访问 http://127.0.0.1:8000/admin 并使用刚才创建的管理员账号即可登录管理后台。若需开发具体功能模块，可在项目根目录下执行命令 py manage.py startapp app_name 来创建新的APP。

集成xadmin后台管理系统

接下来引入xadmin组件以增强后台管理功能。

通过包管理工具安装xadmin依赖库。


pip install git+git://github.com/sshwsfc/xadmin.git@django2

修改 urls.py 文件以配置xadmin的路由规则。


import xadmin //添加此行
from django.conf import settings //添加此行
from django.conf.urls.static import static //添加此行
from django.urls import path

urlpatterns = [
  path('admin/', xadmin.site.urls), //修改此行
]

同步调整 settings.py 文件以注册xadmin应用及相关依赖。


import xadmin //添加此行

INSTALLED_APPS = [
  'xadmin', //添加此行
  'django.contrib.admin',
  'django.contrib.auth',
  'django.contrib.contenttypes',
  'django.contrib.sessions',
  'django.contrib.messages',
  'django.contrib.staticfiles',
  'crispy_forms' //添加此行
]

再次执行数据库迁移命令以应用xadmin所需的表结构变更。