一个现代化的 Django 博客系统,支持文章、标签、分类、友链、响应式设计,支持 Docker 部署和静态导出到 GitHub Pages。
本来是准备用的,但是云服务器到期了,续费还蛮贵的,所以改用基于hexo的博客系统了,而且这个写的也有点草率了,是初学作品,效果肯定不如开源模板
- 文章发布与管理
- 分类、标签系统
- 友链管理
- 响应式美观 UI
- 支持 Markdown
- 支持 Docker 一键部署
- 支持导出静态站点到 GitHub Pages
- 安装依赖
python3 -m venv venv source venv/bin/activate pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 数据库迁移 & 创建超级用户
python manage.py migrate python manage.py createsuperuser
- 启动开发服务器
python manage.py runserver 0.0.0.0:8000
- 访问
- 博客首页: http://localhost:8000
- 管理后台: http://localhost:8000/admin/
- 构建镜像
docker build -t my-django-app . - 运行容器(允许所有主机访问)
docker run -d -p 8000:8000 my-django-app
- 访问
- 安装 django-distill
pip install django-distill
- 配置
INSTALLED_APPS和urls.py,参考 django-distill 文档。 - 生成静态站点
python manage.py distill-local dist/
- 新建仓库
yourusername.github.io,将dist/目录下的内容推送到该仓库。 - 访问
https://yourusername.github.io。
- 端口被占用:换一个端口或释放 8000 端口。
- ALLOWED_HOSTS 报错:已默认设置为
['*'],如需更安全可指定域名/IP。 - 静态文件不显示:确保
collectstatic已执行,模板引用用{% static %}标签。 - Docker 构建慢:已配置 pip 清华源。
- 只想静态博客:用 django-distill 导出静态站点即可。
- 作者:ALe
- 邮箱:[email protected]
- Issues:欢迎在 GitHub 提交 issue
本项目适合学习 Django、个人博客、静态站点部署等场景。欢迎 Star & Fork!