基于Django的视频点播系统开发实战：数据建模与转码播放全解析

简介这是一套面向高校计算机及相关专业本科生的毕业设计级视频点播网站实战项目聚焦Django Web开发全流程实践解决学生在课程设计、期末综合实训及毕业课题中缺乏可运行、可演示、可扩展的完整工程案例问题。资源包共156个文件含40个核心Python后端模块含models、views、urls等、48个HTML前端模板覆盖首页、详情页、用户中心等全功能页面、20个JS交互脚本与6类CSS样式文件含semantic.custom.css、dropload.css等响应式组件辅以数据库备份zbak、配置文件ini/md及图标资源整体仅3.89MB轻量易部署。已有82人学习下载所有代码经实测可直接运行无需修改配套教程涵盖环境搭建、数据初始化、视频上传测试及基础UI定制结构清晰、模块解耦特别适合从零掌握Django MTV架构、用户权限管理、视频内容建模与前后端协同开发。1. 项目整体设计思路为什么选 Django 做视频点播每年毕业季都能看到大量“视频点播网站”方向的选题坦白说这是个经典但绝不轻松的方向。经典的版本是 PHPMySQL 搞个站现在更多同学选 PythonDjango原因很直接Django 自带 Admin 后台、ORM 和完整的 MTV 架构能把用户认证、后台管理、数据库操作这些基础工作省掉一大半让你把精力集中到“视频”这个核心业务上。如果你正在做或者准备做这个毕设先想清楚一个问题你做的到底是“能放视频的网站”还是“视频点播系统”。前者随便套个前端播放器就能交差后者要有完整的视频上传、转码、分类、检索、播放、用户体系、播放记录、后台管理闭环。毕业设计的评分逻辑很在意这个区别系统完整度直接决定你的论文有没有东西可写。我建议的系统分层是下面这样层级职责关键技术点前端展示层首页、列表页、播放页、个人中心HTML/CSS/JS、Bootstrap 或 Vue 分离式业务逻辑层视频管理、用户管理、分类管理Django View Form 校验数据访问层ORM 操作 MySQL/SQLiteDjango Model存储层视频文件、封面图、字幕本地 MEDIA 目录或 OSS后台管理视频审核、用户管理、数据统计Django Admin 二次开发这个结构里前端不要过度设计。很多同学一上来就搞 Vue 前后端分离结果半年过去了联调还没完成。毕设项目我强烈建议先用 Django 模板渲染 Bootstrap 搞定页面把核心业务跑通如果后期想加分再拆前后端。你要是时间充裕、想在答辩时拿出来能打的作品那另说。技术选型上还有几个容易被忽略的细节Django 版本建议用 3.2 LTS 或 4.x 稳定版不要用 2.x 老版本Python 环境也尽量 3.8 以上。数据库本地开发用 SQLite 就够了但为了让论文里能写“系统基于 MySQL 设计”建议直接配 MySQLMySQL 8.x pymysql。别用 Django 默认的 SQLite 到答辩前才换库Model 里如果有 JSONField 这类字段从 SQLite 迁到 MySQL 时会踩坑。文件存储视频文件不要直接怼进数据库数据库只存文件路径或 URL文件落在 MEDIA_ROOT 下。这是新手最容易犯的错误我见过有人把视频存成 Blob 塞进 MySQL最后数据库十几个 GB查询慢到怀疑人生。选题方向其实还可以再垂直一点。“视频点播”太泛了你可以加一个限定场景比如“基于 Django 的在线教育视频点播系统”“基于 Django 的影视资源分享与点播平台”场景限定后你的系统功能设计和论文的“研究意义”都好写很多。2. 数据建模与数据集准备把核心表设计到能直接建表视频点播系统的核心数据模型不外乎这几张表用户表、视频信息表、视频分类表、评论表、播放记录表、收藏表。别小看这几张表的设计它直接决定了你后续开发是顺风顺水还是疯狂返工。我先把核心表的字段设计放出来这套结构是经过实际项目验证的可以直接拿来用。2.1 用户表扩展 Django 内置 UserDjango 的 auth.User 已经自带用户名、密码、邮箱、最后登录时间这些基础字段你不需要重写用 OneToOne 扩展一个 Profile 表就行from django.db import models from django.contrib.auth.models import User class Profile(models.Model): user models.OneToOneField(User, on_deletemodels.CASCADE, verbose_name用户) nickname models.CharField(max_length50, blankTrue, verbose_name昵称) avatar models.ImageField(upload_toavatar/%Y/%m/, defaultavatar/default.png, verbose_name头像) created_at models.DateTimeField(auto_now_addTrue, verbose_name注册时间) class Meta: verbose_name 用户扩展信息 verbose_name_plural verbose_name def __str__(self): return self.nickname or self.user.username这里有个很实用的点用 OneToOne 扩展而不是直接改 User 表升级 Django 版本或者换认证方式时不至于动核心表结构。很多教程直接让你在 User 上添加字段那是老版本的做法了现在不建议。2.2 视频表字段设计要防住未来需求视频表是整个系统的核心我见过很多项目把视频表做得极其简陋就 id、title、url 三个字段后面想加功能全部抓瞎。常规的字段设计至少包含这些字段名类型说明titleCharField视频标题descriptionTextField视频简介coverImageField封面图video_fileFileField视频文件categoryForeignKey关联分类表userForeignKey上传用户play_countIntegerField播放次数like_countIntegerField点赞数durationCharField视频时长分钟statusCharField状态审核中/已发布/下架upload_timeDateTimeField上传时间对应的 Model 代码片段class Video(models.Model): STATUS_CHOICES ( (pending, 审核中), (published, 已发布), (offline, 已下架), ) title models.CharField(max_length200, verbose_name标题) description models.TextField(blankTrue, verbose_name简介) cover models.ImageField(upload_tocover/%Y/%m/, blankTrue, verbose_name封面) video_file models.FileField(upload_tovideo/%Y/%m/, verbose_name视频文件) category models.ForeignKey(Category, on_deletemodels.SET_NULL, nullTrue, related_namevideos, verbose_name分类) user models.ForeignKey(User, on_deletemodels.CASCADE, related_namevideos, verbose_name上传者) play_count models.IntegerField(default0, verbose_name播放次数) like_count models.IntegerField(default0, verbose_name点赞数) duration models.CharField(max_length20, blankTrue, verbose_name时长) status models.CharField(max_length20, choicesSTATUS_CHOICES, defaultpublished, verbose_name状态) upload_time models.DateTimeField(auto_now_addTrue, verbose_name上传时间) class Meta: ordering [-upload_time] verbose_name 视频 verbose_name_plural verbose_name几个字段设计的细节经验status 字段千万别省。没有审核状态这个字段你的系统就只能是“谁上传谁立即展示”版权和安全审核方面一句话都写不出来答辩必被问住。cover 和 video_file 建议分开存不同目录后面做缓存和清理时方便。duration 用 CharField 存字符串格式比如“12:30”因为在 Web 端展示时通常要的是格式化字符串存秒数虽然适合计算但前端还要转格式徒增工作量。2.3 数据集怎么凑爬虫、公开数据、还是手动造毕设最尴尬的环节之一是系统做完了但库里没有数据展示效果惨不忍睹。数据集这块有几种方式我按推荐程度排一下手动整理 网络下载封面找几十个公开的演示视频比如一些开源视频网站的演示素材把标题、简介、分类手动录入。数量控制在 50 条左右够用重点是分类分布均匀。公开数据集Kaggle 上有一些视频数据集适合做推荐模块时用。如果只是展示用没必要这么大。自己写爬虫抓公开视频网站的元数据这个方式要慎重。抓标题、简介、封面这些元数据来做演示问题不大但你要注意对方网站的 robots 协议同时绝对不要下载版权视频到本地做分发。不过我不推荐你在这个项目里花太多时间搞爬虫毕设的核心是系统开发不是数据采集。我自己做这个项目时视频文件用的是 FFmpeg 官方提供的测试素材比如 Big Buck Bunny 这类开源影片封面图和分类信息按电影、电视剧、纪录片、动画、音乐等常见视频站分类手动录入总共造了 60 多条数据足够演示了。这里分享一个造数据的技巧写一个 Django management command用脚本一次性批量导入数据不要一条一条在 Admin 后台手点。类似这样# video/management/commands/import_videos.py import os from django.core.management.base import BaseCommand from video.models import Video, Category from django.contrib.auth.models import User class Command(BaseCommand): help 批量导入视频数据 def handle(self, *args, **options): user User.objects.first() categories list(Category.objects.all()) data_dir media/video/ for filename in os.listdir(data_dir): if filename.endswith(.mp4): Video.objects.create( titlefilename.split(.)[0], video_filefvideo/{filename}, categorycategories[0], useruser, statuspublished ) self.stdout.write(f已导入: {filename})这种脚本在写论文时也能写进“系统实现”章节比干巴巴地写“数据是手工录入的”好看多了。3. 视频上传与转码处理毕设项目的技术难点集中营视频点播和普通文章发布最大的区别就在“文件处理”这条链路上上传大文件、格式兼容、播放进度、并发访问。这一块是视频类项目的硬骨头也是你和别人拉开分数差距的地方。3.1 上传表单前端校验 后端双重校验HTML 里直接写一个input typefile acceptvideo/*是最简单的但仅支持单文件。如果你想要点高级感可以用 django-formtools 或者直接引入 LayUI / Bootstrap FileInput 组件做多文件上传。后端的表单校验要注意两点文件大小和扩展名。Django 默认的 FILE_UPLOAD_MAX_MEMORY_SIZE 是 2.5MB大于这个值会写入临时文件不影响功能但你要在视图函数里手动限制文件大小不然用户传一个几个 GB 的视频磁盘直接被打爆。class VideoUploadForm(forms.ModelForm): class Meta: model Video fields [title, description, cover, video_file, category] def clean_video_file(self): video_file self.cleaned_data.get(video_file) if video_file: if video_file.size 500 * 1024 * 1024: # 限制500MB raise forms.ValidationError(视频文件不能超过500MB) ext os.path.splitext(video_file.name)[1].lower() if ext not in [.mp4, .avi, .mov, .mkv, .wmv]: raise forms.ValidationError(不支持的视频格式) return video_file注意后端校验不能省。前端搞了再多限制别人用 curl 直接 POST 绕过照样能传这类系统上线时的安全漏洞十有八九都是这么来的。3.2 转码不做转码的视频站不是好视频站如果你直接把用户上传的 .avi 或 .mkv 文件丢到前端让浏览器播放就会出现一半用户打不开的情况。浏览器原生支持的视频格式有限最稳妥的是 MP4H.264 AAC。所以正规的视频点播系统一定会做转码。FFmpeg 是行业标准方案在 Django 里用 subprocess 调用 FFmpeg 命令行即可。import subprocess def transcode_video(source_path, target_path): cmd [ ffmpeg, -i, source_path, -c:v, libx264, -preset, fast, -c:a, aac, -b:a, 128k, -pix_fmt, yuv420p, -movflags, faststart, target_path ] subprocess.run(cmd, checkTrue)几个参数值得你写论文时展开说一下libx264 编码器输出 H.264 编码视频兼容性最好。yuv420p 像素格式保证视频在老旧浏览器和设备上也能正常解码很多不兼容问题就是这个像素格式引起的。faststart把 moov atom 移到文件头部观众打开视频时不需要等全部下载完成几秒内就能开始播放。这个参数非常关键尤其是对 Web 播放器。转码还可以接一个进阶功能为了适配不同网速的用户可以在转码时生成多清晰度版本流畅/标清/高清类似 B 站的清晰度切换。用 FFmpeg 加-vf scale1280:720之类的方式输出多个分辨率文件然后把不同版本路径存到一个新表。毕设能做到这个程度已经超出 90% 的同类项目了。不过要提醒你转码是 CPU 密集型操作千万不能在请求线程里同步执行否则一个视频传上去整个网站卡十几秒。合理做法是丢到后台队列比如用 Django-Q 或者 Celery。如果你不想引入队列系统也可以用 Python 的 threading 开一个后台线程简单粗暴但能解决并发问题。毕设答辩阶段用 threading 就够了如果时间充足再升级 Celery。3.3 存储路径按日期分目录别学某些教程平铺一坨def video_upload_path(instance, filename): return fvideo/{instance.user.username}/{time.strftime(%Y/%m)}/{uuid.uuid4().hex}{os.path.splitext(filename)[1]}这个 upload_to 函数有几个好处按用户名分目录有人恶意上传同名文件时不会互相覆盖。按年月分目录后面做冷热数据迁移、定期清理时方便。文件名用 uuid 重命名可以防止路径遍历攻击别人也猜不到你的存储路径。4. 视频播放链路与防盗链从页面到播放器完整打通做完了上传和转码接下来就是用户真正打开网站看到的播放页面。这一块的完整链路是列表页点击封面 → 视频详情页 → 播放器加载视频 URL → 播放 → 播放次数加一 → 存储播放记录。4.1 播放页面和播放器选型播放器方案我推荐直接选常用的 Web 播放器比如 Video.js、Plyr、DPlayer 都是不错的选择没必要自己写原生 video 标签的交互逻辑。DPlayer 是很多视频站的选择因为界面好看、支持弹幕插件拿来写论文也算亮点div iddplayer/div script srchttps://cdn.jsdelivr.net/npm/dplayer/dist/DPlayer.min.js/script script const dp new DPlayer({ container: document.getElementById(dplayer), video: { url: {{ video.video_file.url }}, pic: {{ video.cover.url }}, }, danmaku: false, }); /scriptDjango 模板渲染时注意如果模型里 FileField 为空直接取.url会报错所以需要加判断{% if video.video_file %} url: {{ video.video_file.url }}, {% endif %}4.2 播放次数与播放记录用信号或通用视图逻辑实现播放次数不要在播放页面模板渲染时直接累加因为浏览器刷新一次就加一次数据完全失真。正确做法是提供一个接口播放器初始化成功后调一次。# urls.py path(video/int:pk/play/, views.video_play, namevideo_play), # views.py login_required def video_play(request, pk): video get_object_or_404(Video, pkpk) Video.objects.filter(pkpk).update(play_countF(play_count) 1) # 记录播放历史 PlayRecord.objects.update_or_create( userrequest.user, videovideo, defaults{last_play_time: timezone.now()} ) return JsonResponse({status: success})两个细节值得注意用F(play_count) 1做原子自增比先查出来再加一并发安全得多。播放记录用update_or_create保证同一用户同一视频只保留一条最近播放记录。4.3 防盗链媒体文件不能裸奔Django 自带的django.views.static.serve在 DEBUG 模式下可以直接提供媒体文件访问但默认没有做任何权限控制别人拿到文件 URL 就能外链播放。毕设答辩时老师问到安全问题你不能一句“不知道”搪塞过去。一个轻量级解决方案是给视频文件 URL 加签名参数校验通过才允许访问。思路是在生成播放地址时用 token 签名在访问时校验 token 是否有效。import hmac import hashlib import time def generate_video_url(video_file_url, expire_seconds3600): expire int(time.time()) expire_seconds secret_key your-secret-key.encode(utf-8) message f{video_file_url}:{expire}.encode(utf-8) sign hmac.new(secret_key, message, hashlib.sha1).hexdigest() return f/media/protected/?url{video_file_url}expire{expire}sign{sign} def verify_video_url(request): url request.GET.get(url) expire request.GET.get(expire) sign request.GET.get(sign) if int(expire) time.time(): return False message f{url}:{expire}.encode(utf-8) expect_sign hmac.new(your-secret-key.encode(utf-8), message, hashlib.sha1).hexdigest() return hmac.compare_digest(expect_sign, sign)这样即使别人盗走了播放地址过一段时间就失效了。完整实现需要写一个自定义视图来 serve 受保护的文件不能再用 Django 默认的 static serve。这个功能写到论文的“系统安全设计”章节里非常加分。5. 搜索、推荐与个人中心拉开档次的功能模块到了这一步你的网站已经能看、能传、能播了。但距离一个“系统”还差点东西。一个完整的视频点播系统至少还需要搜索、分类导航、个人中心我的上传、我的历史、我的收藏、后台数据统计。这几块里我觉得最值得展开的是搜索和推荐。5.1 搜索Django ORM 实现简单站内搜索很多毕设同学的搜索就是WHERE title LIKE %关键词%勉强能用但效果一般。稍微优化一步把搜索范围扩展到简介和分类名def search(request): keyword request.GET.get(q, ).strip() if keyword: videos Video.objects.filter( Q(title__icontainskeyword) | Q(description__icontainskeyword) | Q(category__name__icontainskeyword) ).filter(statuspublished) else: videos Video.objects.filter(statuspublished) return render(request, video/search_result.html, {videos: videos, keyword: keyword})搜索这块建议再加一个简单的高亮效果和排序条件按最新、最热。用户搜索结果页把播放量和发布时间展示出来体验完全不同。真正上规模的项目会用 Elasticsearch 做搜索但毕设项目引入 ES 太重了也没必要。你可以在论文里提一句“系统当前使用数据库模糊查询后续可扩展为 Elasticsearch”显得你视野开阔。5.2 简单推荐基于分类和播放量非对称的推荐算法写起来复杂但毕设里完全可以做一个基于内容相似度的简单推荐找到同分类下播放量最高的几个视频排除当前正在看的视频展示在播放页下方“相关推荐”区域。def get_recommendations(video, limit6): return Video.objects.filter( categoryvideo.category, statuspublished ).exclude(pkvideo.pk).order_by(-play_count)[:limit]虽然简单但效果直观也好写进论文。如果你想让推荐更“智能”一点可以加上基于用户的协同过滤找到和你播放历史相似的用户推荐他们看过而你没看过的视频。用 Python 写一个简单的相似度计算脚本几十行就能跑通能作为一个独立章节写进论文建议时间充裕的试一下。5.3 个人中心让系统闭环个人中心要包含这几个页面我的上传列出当前用户上传的视频列表支持编辑、下架。我的收藏收藏的视频列表。播放历史最近播放过的视频按时间倒序。编辑资料头像、昵称。技术实现上没有难点主要是页面数量多需要耐心写模板。如果想省事可以看看开源项目里的个人中心是怎么做的参考布局然后改成自己的。6. 常见问题与排查技巧实录踩过的坑全记录最后一章全是这次开发中实打实遇到的坑每一条我都花过不少时间整理成速查表希望你不用再踩一遍。问题原因解决方案图片/视频上传后 404 无法访问MEDIA_URL 没有配置或 urls.py 缺少 media 路由settings.py 配置 MEDIA_URL/MEDIA_ROOTurls.py 增加 static(settings.MEDIA_URL, document_rootsettings.MEDIA_ROOT)播放视频时只有声音没有画面视频编码格式非 H.264浏览器不支持用 FFmpeg 转码为 H.264 AAC 格式上传大视频超时Django 默认的请求时间限制或服务器超时设置过短开发环境可在视图里配合内存/临时目录处理生产环境用队列异步处理视频播放卡顿文件太大没有做多清晰度适配转码生成多分辨率版本提供清晰度切换中文视频标题乱码数据库字符集不是 utf8mb4创建 MySQL 库时指定CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci刷新页面播放次数疯涨播放次数累加逻辑写在模板渲染里改为播放器初始化后调用 /play/ 接口累加Admin 后台无法上传大视频Django 对文件上传大小有限制设置DATA_UPLOAD_MAX_MEMORY_SIZE和FILE_UPLOAD_MAX_MEMORY_SIZE搜索关键词为空时页面崩溃没有做空关键词判断视图里先判断 keyword 是否为空为空则返回全部列表删除视频时硬盘文件没删只删了数据库记录没有调用文件删除覆写 delete 方法同时清理 FileField 对应文件两个额外的干货技巧第一Django 的 Admin 后台默认列表页对 FileField 没有预览。你可以自定义 Admin 类在 list_display 里显示封面缩略图和视频链接答辩演示时给评委看后台会专业很多。class VideoAdmin(admin.ModelAdmin): list_display [title, category, user, play_count, status, upload_time] list_filter [status, category] search_fields [title, user__username] list_per_page 20第二开发阶段 DEBUGTrue 时一切正常但部署到服务器上 DEBUGFalse 后静态文件和媒体文件可能全部失效。这不是代码问题是 Django 生产模式本来就不负责提供静态文件这是 Nginx 或其他服务器的职责。建议从第一天就用 Nginx 反代 Django 提供媒体文件不要等到最后才切环境。这个坑比较经典网上教程也非常多。7. 写在最后源码再全跑起来才算数这套系统从数据建模到播放器接入、防盗链、推荐、后台管理完整实现下来大概需要一个半月到两个月的时间每天 4-6 小时。如果你拿到的源码是别人打包好的我建议你也不要直接交上去就完事而是把核心模块拆开重新过一遍至少把视频上传、转码、播放链路自己实现一次搞懂每一行代码为什么这么写。否则答辩的时候老师只问一句“你的视频转码参数是什么意思”你就卡壳了。根据自己的经验再强调一遍数据集不需要大50 条有分类、有封面、有简介的视频记录足够把功能展示得明明白白。开发时优先跑通核心链路上传 → 转码 → 列表展示 → 播放 → 记录播放历史再补充搜索、推荐、权限控制这些锦上添花的功能。顺序反了的话到后期很容易发现自己把精力耗在了非核心功能上核心链路反而不完整。最后再分享一个小技巧Django 的调试信息页和 Django Debug Toolbar 是排查问题的神器开发阶段把这两个工具用好比什么都强。遇到 500 错误不要慌先看控制台日志和报错堆栈90% 的问题都是字段名写错、模板语法错误、迁移没做这几种低级错误。这个项目做完你对 Django 的理解基本就到就业水平了。本文还有配套的精品资源点击获取