You need to enable JavaScript to run this app. 生产环境用Dokku部署Django时用户上传媒体文件的鉴权访问实现
优惠活动
大模型
产品
解决方案
定价
更多

生产环境用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(推荐)

  1. 安装库后修改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
  1. 修改models.py字段定义:
from private_storage.fields import PrivateImageField

class User(AbstractUser):
    profile_image = PrivateImageField(upload_to='testuploads/', null=True)
  1. 新增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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 04:24:02