生产环境用Dokku部署Django时用户上传媒体文件的鉴权访问实现
实现方案
第一步:配置Dokku持久化存储(必须配置)
你当前上传的文件仅存在于容器临时文件系统中,容器重启/重建后文件会丢失,且宿主机无法直接访问,必须配置Dokku持久化存储:
- 宿主机执行命令创建存储目录并配置权限:
mkdir -p /var/lib/dokku/data/storage/backend/mediafiles chown -R 32767:32767 /var/lib/dokku/data/storage/backend/mediafiles
- 挂载目录到容器对应路径,与你settings里的MEDIA_ROOT对齐:
dokku storage:mount backend /var/lib/dokku/data/storage/backend/mediafiles:/app/mediafiles dokku ps:restart backend
配置完成后,新上传的文件会同步存储到宿主机/var/lib/dokku/data/storage/backend/mediafiles路径下,原有容器内的文件可手动拷贝到该目录完成迁移。
第二步:修正Nginx配置
修改你在宿主机创建的/home/dokku/backend/nginx.conf.d/my_conf.conf文件内容为:
# 禁止外部直接访问私有媒体路径 location /protected/ { internal; alias /var/lib/dokku/data/storage/backend/mediafiles/; }
修改后执行dokku nginx:build-config backend重建应用Nginx配置即可生效。
第三步:配置Django鉴权逻辑
方案A:使用django-private-storage(推荐)
- 安装库后修改settings.py配置:
INSTALLED_APPS += [ 'private_storage', ] PRIVATE_STORAGE_ROOT = MEDIA_ROOT PRIVATE_STORAGE_SERVER = 'nginx' PRIVATE_STORAGE_INTERNAL_URL = '/protected/' # 配置默认权限为仅登录用户可访问 PRIVATE_STORAGE_PERMISSION_FUNCTION = lambda request, path: request.user.is_authenticated
- 修改models.py字段定义:
from private_storage.fields import PrivateImageField class User(AbstractUser): profile_image = PrivateImageField(upload_to='testuploads/', null=True)
- 新增urls.py路由:
from private_storage.views import PrivateStorageView from django.urls import path urlpatterns += [ path('media/<path:path>', PrivateStorageView.as_view(), name='serve_private_media'), ]
方案B:自定义鉴权视图
如果不想引入第三方库,可自行实现视图逻辑:
# views.py from django.http import HttpResponse from django.conf import settings from django.contrib.auth.decorators import login_required import os @login_required def serve_private_media(request, path): # 可在这里添加额外权限校验,比如仅允许用户访问自己的上传文件 response = HttpResponse() # 告诉Nginx去读取内部路径的文件 response['X-Accel-Redirect'] = os.path.join('/protected/', path) # 清空Django默认的Content-Type,让Nginx自动识别 del response['Content-Type'] return response
urls.py配置同方案A,将/media/<path:path>指向该视图即可。
验证效果
- 未登录状态下访问
/media/testuploads/xxx.jpg会被重定向到登录页或返回403 - 登录状态下访问上述地址可正常获取文件
- 直接访问
/protected/testuploads/xxx.jpg会返回404错误,无法直接绕过鉴权
内容的提问来源于stack exchange,提问作者Neil
相关产品推荐
相关产品推荐

