izone

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

爱藏

一个以 Django 框架搭建的个人博客系统。

线上地址：https://tendcode.com/

技术栈

页面效果（响应式）

文档索引

功能

• Django 后台管理系统，方便管理文章、用户及其他动态内容
• 文章分类、标签、专题（Subject → Topic → Article）层级结构
• 全文搜索（MySQL FULLTEXT n-gram 中文分词，直接查询实时数据）
• 文章评论系统（二级回复、微博表情、Markdown）、评论通知
• 用户认证（Django 用户系统 + OAuth 微博/GitHub 第三方登录）
• 浏览量统计（爬虫 UA 过滤、按访客 30 分钟去重、每日快照）
• 友链管理（在线申请、定时自动校链，外呼有并发上限）
• RSS 订阅、Sitemap 网站地图、百度 SEO 推送
• RESTful API（条件启用，DRF DefaultRouter；列表接口不返回正文）
• 在线工具（条件启用）、服务监控、导航网站、流程图、脚本工具分享
• 响应式设计（PC / iPad / 手机），暗色主题支持
• Redis 缓存（文章渲染/RSS 正文/站点配置/侧边栏统计/未读计数），Celery 定时任务调度

快速开始

Docker 部署

# 构建镜像
docker build -t hopetree/izone:lts .

# slim 镜像（国内构建）
docker build --build-arg pip_index_url=http://mirrors.aliyun.com/pypi/simple/ \
             --build-arg pip_trusted_host=mirrors.aliyun.com \
             --build-arg debian_host=mirrors.ustc.edu.cn \
             -f Dockerfile-slim -t hopetree/izone:lts .

# 运行（需要预先启动 MySQL 和 Redis）
docker run -d \
  -e IZONE_MYSQL_HOST=mysql_host \
  -e IZONE_MYSQL_PASSWORD=your_password \
  -e IZONE_REDIS_HOST=redis_host \
  -p 8000:8000 \
  hopetree/izone:lts

本地开发

# 安装依赖
python -m venv env
source env/bin/activate
pip install -r requirements.txt

# 数据库迁移
python manage.py migrate

# 创建管理员
python manage.py createsuperuser

# 启动开发服务器
python manage.py runserver

# 启动 Celery（可选，异步任务需要；Worker 与 Beat 单进程）
celery -A izone worker -l info -B --pool=solo

环境变量

关键配置通过环境变量注入，完整列表见 架构设计文档。

项目结构

izone/
├── izone/              # Django 项目配置（settings/urls/wsgi）
├── apps/               # 所有 Django 应用
│   ├── blog/           # 核心博客应用
│   ├── oauth/          # 自定义用户模型 + OAuth 认证
│   ├── comment/        # 评论与通知系统
│   ├── easytask/       # Celery 异步任务
│   ├── api/            # REST API（条件启用）
│   ├── tool/           # 在线工具（条件启用）
│   ├── monitor/        # 服务监控
│   └── ...             # webstack, resume, flow, portinfo, rsshub
├── templates/          # 共享模板
├── utils/              # 共享工具（Markdown 扩展等）
├── docs/design/        # 设计文档
├── Dockerfile
└── manage.py

许可

MIT License

| — | 2026-07-24 | 根据 commit 2ca6b0b 更新：文档索引新增 Code Review 报告，功能列表新增脚本工具分享 |
| — | 2026-09-05 | 搜索切换为 MySQL FULLTEXT（移除 haystack/Whoosh）；Celery Worker 与 Beat 合并单进程；新增 AGENTS.md |
| — | 2026-09-11 | 浏览量改为按访客 30 分钟 Redis 去重；补充缓存清单与列表接口不返回正文；友链校链并发上限 |