django xadmin 结合 minio

我来为您详细介绍如何在Django中使用MinIO作为存储,并修改xadmin的文件上传部分。

1. 安装必要的依赖

bash 复制代码
pip install django-storages boto3 minio

2. 配置Django设置

在settings.py中添加以下配置:

python 复制代码
# settings.py

INSTALLED_APPS = [
    # ...
    'storages',
]

# MinIO配置
MINIO_ACCESS_KEY = 'your-access-key'
MINIO_SECRET_KEY = 'your-secret-key'
MINIO_BUCKET_NAME = 'your-bucket-name'
MINIO_ENDPOINT = 'your-minio-server:9000'  # MinIO服务器地址
MINIO_USE_HTTPS = False  # 根据你的MinIO配置调整
MINIO_EXTERNAL_ENDPOINT = None  # 可选,用于生成外部URL

# Django存储后端配置
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'

AWS_ACCESS_KEY_ID = MINIO_ACCESS_KEY
AWS_SECRET_ACCESS_KEY = MINIO_SECRET_KEY
AWS_STORAGE_BUCKET_NAME = MINIO_BUCKET_NAME
AWS_S3_ENDPOINT_URL = f'http://{MINIO_ENDPOINT}'  # 或 https
AWS_S3_USE_SSL = MINIO_USE_HTTPS
AWS_S3_FILE_OVERWRITE = False  # 同名文件不覆盖
AWS_DEFAULT_ACL = None  # 根据需求设置ACL
AWS_QUERYSTRING_AUTH = True  # URL是否需要认证

3. 自定义存储类(可选,用于更好的MinIO集成)

python 复制代码
# storage_backends.py
from storages.backends.s3boto3 import S3Boto3Storage
from django.conf import settings

class MinioStorage(S3Boto3Storage):
    def __init__(self, *args, **kwargs):
        kwargs['bucket_name'] = settings.MINIO_BUCKET_NAME
        kwargs['access_key'] = settings.MINIO_ACCESS_KEY
        kwargs['secret_key'] = settings.MINIO_SECRET_KEY
        kwargs['endpoint_url'] = f"http://{settings.MINIO_ENDPOINT}"
        kwargs['use_ssl'] = settings.MINIO_USE_HTTPS
        super().__init__(*args, **kwargs)

# 然后在settings.py中使用自定义存储类
# DEFAULT_FILE_STORAGE = 'your_app.storage_backends.MinioStorage'

4. 修改xadmin的文件上传

方法一:全局替换存储后端

由于xadmin使用Django的FileField,配置了DEFAULT_FILE_STORAGE后,xadmin会自动使用MinIO。

方法二:自定义xadmin的FileWidget

python 复制代码
# adminx.py
import xadmin
from xadmin.views import BaseAdminView
from django import forms
from django.db import models

class MinioFileInput(forms.ClearableFileInput):
    """自定义文件输入组件,显示MinIO文件信息"""
    
    def get_context(self, name, value, attrs):
        context = super().get_context(name, value, attrs)
        if value and hasattr(value, 'url'):
            # 显示文件的MinIO URL
            context['file_url'] = value.url
        return context

class GlobalSettings(BaseAdminView):
    # 全局设置,让xadmin使用自定义的文件widget
    global_models_icon = {
        # 你的模型图标配置
    }
    
    def get_media(self):
        media = super().get_media()
        media.add_css({'screen': [
            # 自定义CSS
        ]})
        return media

# 注册全局设置
xadmin.site.register(BaseAdminView, GlobalSettings)

方法三:为特定模型自定义表单

python 复制代码
# adminx.py
import xadmin
from django import forms
from .models import YourModel

class YourModelForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = '__all__'
        widgets = {
            'file_field': MinioFileInput(),  # 使用自定义的文件输入组件
        }

class YourModelAdmin(object):
    form = YourModelForm
    list_display = ['name', 'file_field']
    
    # 自定义文件上传的字段显示
    def file_field_display(self, obj):
        if obj.file_field:
            return f'<a href="{obj.file_field.url}" target="_blank">下载文件</a>'
        return '无文件'
    
    file_field_display.short_description = '文件'
    file_field_display.allow_tags = True

xadmin.site.register(YourModel, YourModelAdmin)

5. 完整的配置示例

python 复制代码
# settings.py 完整配置

# MinIO配置
MINIO_ACCESS_KEY = 'minioadmin'
MINIO_SECRET_KEY = 'minioadmin'
MINIO_BUCKET_NAME = 'django-media'
MINIO_ENDPOINT = 'localhost:9000'
MINIO_USE_HTTPS = False

# AWS S3兼容配置(MinIO兼容S3 API)
AWS_ACCESS_KEY_ID = MINIO_ACCESS_KEY
AWS_SECRET_ACCESS_KEY = MINIO_SECRET_KEY
AWS_STORAGE_BUCKET_NAME = MINIO_BUCKET_NAME
AWS_S3_ENDPOINT_URL = f'http://{MINIO_ENDPOINT}'
AWS_S3_USE_SSL = MINIO_USE_HTTPS
AWS_S3_FILE_OVERWRITE = False
AWS_DEFAULT_ACL = 'public-read'  # 或者 'private'
AWS_QUERYSTRING_AUTH = False  # 如果希望文件URL可以直接访问
AWS_S3_SIGNATURE_VERSION = 's3v4'

# 媒体文件配置
MEDIA_URL = f'{AWS_S3_ENDPOINT_URL}/{AWS_STORAGE_BUCKET_NAME}/'
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'

6. 创建MinIO桶的初始化脚本

python 复制代码
# minio_init.py
from minio import Minio
from django.conf import settings
import logging

logger = logging.getLogger(__name__)

def create_minio_bucket():
    """创建MinIO桶(如果不存在)"""
    try:
        client = Minio(
            settings.MINIO_ENDPOINT,
            access_key=settings.MINIO_ACCESS_KEY,
            secret_key=settings.MINIO_SECRET_KEY,
            secure=settings.MINIO_USE_HTTPS
        )
        
        if not client.bucket_exists(settings.MINIO_BUCKET_NAME):
            client.make_bucket(settings.MINIO_BUCKET_NAME)
            logger.info(f"MinIO桶 {settings.MINIO_BUCKET_NAME} 创建成功")
        else:
            logger.info(f"MinIO桶 {settings.MINIO_BUCKET_NAME} 已存在")
            
    except Exception as e:
        logger.error(f"MinIO桶创建失败: {e}")

# 在Django启动时运行
# 可以在AppConfig.ready()中调用

7. 验证配置

创建一个测试视图来验证配置:

python 复制代码
# views.py
from django.http import JsonResponse
from django.core.files.storage import default_storage

def test_minio(request):
    """测试MinIO连接"""
    try:
        # 测试文件操作
        test_content = b"Hello MinIO from Django"
        file_name = "test.txt"
        
        # 保存文件
        default_storage.save(file_name, test_content)
        
        # 检查文件是否存在
        exists = default_storage.exists(file_name)
        
        # 获取文件URL
        file_url = default_storage.url(file_name)
        
        return JsonResponse({
            'status': 'success',
            'file_exists': exists,
            'file_url': file_url
        })
        
    except Exception as e:
        return JsonResponse({
            'status': 'error',
            'message': str(e)
        })

注意事项

  1. 权限配置:确保MinIO的访问策略正确设置
  2. CORS设置:如果前端需要直接上传到MinIO,需要配置CORS
  3. URL生成 :根据需求调整AWS_QUERYSTRING_AUTH设置
  4. 备份策略:制定MinIO数据的备份策略

这样配置后,xadmin的文件上传功能就会自动使用MinIO作为存储后端,所有通过FileField和ImageField上传的文件都会保存到MinIO中。

相关推荐
Pocker_Spades_A3 小时前
工业物联网时序数据库选型:一份能直接抄走的技术规格书
数据库·物联网·时序数据库
苜蓿muxu3 小时前
缓存三大问题:穿透、击穿、雪崩
数据库·redis
正在走向自律5 小时前
MySQL兼容性深度实践:建表、增删改查与迁移避坑全记录
数据库·sql·mysql·信创·数据库迁移
JonaHu5 小时前
关键词排名突然消失?用 Python、SQLite 和 SERP API 搭一套可解释的 SEO 监控
python·sqlite·seo·serp api
隔窗听雨眠5 小时前
openGauss开源五年的内核演进与生态工程
数据库·opengauss·国产数据库
Decay__6 小时前
PostgreSQL 体系架构全解 —— 进程模型、共享内存、MVCC 与 WAL 预写日志深入
运维·数据库·sql·mysql·架构
沐知全栈开发7 小时前
基于ClinicalTrials公开数据的临床试验分析系统-毕业设计
数据库·课程设计
半杯咖啡半行码7 小时前
Qt 隐式共享(Implicit Sharing)深度解析:机制、陷阱与 Qt6迁移
开发语言·数据库·qt
Nturmoils8 小时前
空值、日期、字符串:业务 SQL 里的函数先跑一遍
数据库
倔强的石头_11 小时前
数据库选型四步法:我把候选从十几个缩到两个
数据库