信息发布平台微信小程序(MessageShareMiniprogam)服务器后端
项目地址:https://github.com/tanxuekiang/Luntan
基于 Django 框架开发的开源 Web 论坛项目,具备用户体系、发帖交流、头像上传等社区核心能力,代码结构简洁,适合 Django 开发学习,也可用于快速搭建小型团队 / 个人交流站点。
技术栈
后端:Django(Python 为主,占比 97.6%)
前端:原生 HTML + JavaScript + CSS
资源存储:本地文件系统存储用户头像等媒体资源
管理后台:Django 原生 Admin 体系
项目目录结构
plaintext
Luntan/
├── Jzlpalfrom/ # 扩展业务模块目录
├── app/ # 论坛核心应用目录
├── media/
│ └── avatar/ # 用户头像存储目录
├── temp_unzip/ # 临时文件解压工作目录
├── venv/ # Python 虚拟环境目录
├── AUTH # 权限与认证相关说明文件
├── manage.py # Django 项目管理入口脚本
└── README.md
核心功能
用户体系
用户注册、登录、退出
个人资料编辑与自定义头像上传
基础用户权限管控
论坛业务
帖子发布、浏览与回复
板块分类导航
内容基础管理能力
管理能力
内置 Django Admin 后台,支持用户、帖子、板块的可视化管理
可通过后台快速配置站点基础信息
本地运行指南
环境要求
Python 3.x
Django 对应版本(以项目实际依赖为准)
启动步骤
克隆仓库到本地
bash
git clone https://github.com/tanxuekiang/Luntan.git
cd Luntan
激活虚拟环境(项目已内置 venv 环境)
bash
Windows 系统
venv\Scripts\activate
Linux / macOS 系统
source venv/bin/activate
执行数据库迁移
bash
python manage.py makemigrations
python manage.py migrate
创建超级管理员账号
bash
python manage.py createsuperuser
启动开发服务器
bash
python manage.py runserver
启动后访问 http://127.0.0.1:8000 即可进入论坛首页,后台管理地址为 http://127.0.0.1:8000/admin。
目录说明
app/:Django 核心应用,承载论坛主业务逻辑、模型与视图
Jzlpalfrom/:扩展功能模块,存放专项业务代码
media/avatar/:用户上传头像的持久化存储路径,部署时需保证目录读写权限
temp_unzip/:文件处理的临时工作目录,用于解压、中转文件
AUTH:项目权限认证规则、账号体系相关说明
生产部署建议
推荐使用 Nginx + Gunicorn/uWSGI 组合进行生产环境部署
正式上线前需修改配置,关闭 DEBUG 模式,并配置允许访问的域名
建议替换默认 SQLite 数据库,改用 MySQL / PostgreSQL 提升性能
媒体文件可配置独立域名或 CDN 加速,优化访问体验
开源说明
本项目为开源学习项目,可自由用于个人学习、二次开发与非商用场景。