在你的 Django 项目中安装 Vanta Admin

添加包，将主题放在Django admin之前，收集静态资源，并继续使用你已经知道的admin。

PyPI 包

Django admin

套餐 vanta-admin

Django 应用程序 vanta_admin

软件包范围 Python 3.12+ / Django 6.0–6.1

1. 安装包

对于普通项目，请使用 PyPI。包名称为 vanta-admin。

uv add vanta-admin

pip

pip install vanta-admin

2. 添加 Django 应用程序

将 vanta_admin 添加到 INSTALLED_APPS 的 django.contrib.admin 之前。该顺序允许 Vanta 的 admin 模板 override Django 的默认值。

settings.py

INSTALLED_APPS = [
    "vanta_admin",
    "django.contrib.admin",
    # ...
]

3. 收集静态文件

部署之前运行常用的 Django collectstatic 命令。这样，打包的 CSS、JavaScript 和 favicon 文件就能在您的静态文件配置中使用。

紫外线项目

uv run python manage.py collectstatic

标准 Python

python manage.py collectstatic

4. 更新 Vanta Admin

从项目根目录，解析最新的 Vanta Admin 版本并同步环境。这适用于 uv add vanta-admin 的正常约束。

uv lock --upgrade-package vanta-admin
uv sync

pip

pip install --upgrade vanta-admin

5. 保留您的品牌

Vanta 样式 admin；您的项目仍然拥有浏览器选项卡、标题和 admin 索引中显示的文本。

admin.py

from django.contrib import admin

admin.site.site_header = "Your Admin"
admin.site.site_title = "Your Admin"
admin.site.index_title = "Your Admin"

6. 可选 2FA 模板

如果您的项目已使用 django-two-factor-auth，则 Vanta 也可以为这些可见屏幕设置主题。它不会为您安装、启用或配置双因素身份验证。

settings.py

INSTALLED_APPS = [
    "vanta_admin",
    "django_otp",
    "django_otp.plugins.otp_static",
    "django_otp.plugins.otp_totp",
    "two_factor",
    "django.contrib.admin",
    # ...
]

安装后检查admin

启动您的 Django 项目，打开 admin，并验证登录屏幕、侧边栏、更改列表、表单、消息和移动布局。主题保持服务器渲染，不会替换 Django admin 行为、权限、URL 或数据库模型。

查看源码