郭智满博客系统 (ZhiMan Blog)

一款基于 PHP + SQLite 的轻量级、高性能个人博客系统，零配置部署，开箱即用。

✨ 功能特性

🚀 零配置部署 —— 上传即可运行，无需 MySQL，SQLite 数据库自动创建
📝 富文本编辑器 —— 集成 wangEditor，支持可视化编辑与 HTML 源码切换
📌 文章置顶 —— 支持不限数量置顶，自定义排序权重
📥 多下载按钮 —— 单篇文章支持添加多个下载链接，自动生成下载按钮组
🖼️ 自动本地化 —— 发布文章时自动下载远程图片到本地服务器
🔗 外链过滤 —— 自动去除正文中的外部超链接（保留站内链接）
📱 响应式布局 —— 完美适配 PC、平板、手机端
🎯 SEO 优化 —— 支持自定义 SEO 标题、关键词、描述
📊 热点推荐 —— 自动按阅读量排序推荐热门文章
🎠 轮播大图 —— 首页轮播展示精选文章
📋 今日精选 —— 侧边栏推荐位，后台自由配置
🔧 广告位管理 —— 工具推荐卡片，支持图标、标题、描述、链接
🏷️ 二级分类 —— 支持无限层级栏目分类
🔒 后台管理 —— 完整的文章/栏目/页面/广告/轮播/推荐管理
📈 浏览统计 —— 自动统计文章阅读量
🔍 全文搜索 —— 支持按标题和内容搜索文章

🖥️ 在线演示

前台: https://www.zhiman.vip

🛠️ 技术栈

技术	说明
PHP 5.6+	后端语言，无需框架，原生轻量
SQLite3	嵌入式数据库，零配置
wangEditor	富文本编辑器
HTML5 + CSS3	响应式前端布局
JavaScript	原生 JS，无前端框架依赖

📋 环境要求

PHP >= 5.6
SQLite3 扩展已启用
支持 URL Rewrite（伪静态）Apache: 确保 mod_rewrite 已开启Nginx: 参考下方配置

🚀 快速安装

1. 下载源码

# 方式一：Git 克隆git clone https://github.com/guozhiman/zhiman-blog.git# 方式二：直接下载 Release# 访问 https://github.com/guozhiman/zhiman-blog/releases 下载最新版

2. 上传至服务器

将代码上传至网站根目录（如 /www/wwwroot/blog/）。

3. 配置伪静态

Apache（已包含 .htaccess，确保 mod_rewrite 开启即可）：

<IfModule mod_rewrite.c> RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]</IfModule>

Nginx：

location / { try_files $uri $uri/ /index.php?$query_string;}

4. 修改配置文件

复制 config.php 中的数据库路径和基础 URL 配置：

// config.phpdefine('BASE_URL', 'https://你的域名'); // 网站访问地址define('DB_PATH', __DIR__ . '/data/blog.db'); // 数据库文件路径（会自动创建）define('UPLOAD_DIR', __DIR__ . '/uploads/'); // 上传文件目录define('ADMIN_USER', 'admin'); // 后台用户名define('ADMIN_PASS_HASH', '你的密码哈希'); // 密码哈希（bcrypt）

💡 生成密码哈希：password_hash('你的密码', PASSWORD_DEFAULT)

5. 访问后台

浏览器打开 https://你的域名/admin/，使用配置的用户名密码登录。默认admin/admin123

6. 开始创作

进入后台 → 发布文章 → 前台即可查看。

📁 目录结构

zhiman-blog/├── admin/ # 后台管理目录│ ├── index.php # 后台路由入口│ ├── header.php # 后台头部模板│ ├── footer.php # 后台底部模板│ ├── dashboard.php # 仪表盘│ ├── post_list.php # 文章列表│ ├── post_edit.php # 文章编辑/发布│ ├── category_list.php # 栏目列表│ ├── category_edit.php # 栏目编辑│ ├── page_list.php # 页面列表│ ├── page_edit.php # 页面编辑│ ├── ads.php # 广告管理│ ├── ad_edit.php # 广告编辑│ ├── banners.php # 轮播管理│ ├── featured.php # 推荐管理│ ├── settings.php # 系统设置│ ├── login.php # 登录页│ └── change_password.php # 修改密码├── templates/ # 前台模板目录│ ├── header.php # 前台头部│ ├── footer.php # 前台底部│ ├── index.php # 首页│ ├── post.php # 文章详情│ ├── category.php # 分类列表│ ├── page.php # 单页面│ ├── search.php # 搜索结果│ └── 404.php # 404页面├── static/ # 静态资源│ └── css/│ └── style.css # 主样式表├── uploads/ # 上传文件目录（需可写）├── data/ # 数据库目录（需可写）├── functions.php # 核心函数库├── config.php # 配置文件├── index.php # 前台路由入口├── migrate.php # 数据库迁移脚本└── README.md # 本文件

📸 截图预览

前台首页

文章详情页

文章详情

后台仪表盘

文章编辑器

⚙️ 核心功能说明

文章置顶

在文章编辑页勾选"置顶文章"并设置排序数字（越小越靠前），前台文章列表会自动将置顶文章排在最前面。

多下载按钮

在文章编辑页底部"下载链接"区域，可以添加多个下载按钮：

每个按钮可自定义显示文字（如：百度网盘、夸克网盘、直链下载）
支持添加任意数量的下载链接
前台文章详情页会自动渲染为美观的下载按钮组
适合软件分享、资源站等场景

自动下载远程图片

发布文章时勾选"自动下载远程图片"，系统会自动将正文中的外部图片下载到本地 uploads/images/ 目录，并替换链接地址。

外链过滤

保存文章时，系统会自动去除正文中的所有外部超链接（保留链接文字），仅保留站内相对链接和当前域名链接，防止权重流失和恶意跳转。

批量操作

文章列表支持批量删除和批量移动分类，勾选文章后点击对应按钮即可。

🔧 常见问题

Q: 安装后访问前台显示 404？

A: 请检查服务器是否开启了 URL 伪静态（Rewrite），Apache 需开启 mod_rewrite，Nginx 需配置 try_files。

Q: 后台登录密码忘了怎么办？

A: 在服务器上执行 PHP 命令生成新密码哈希，然后修改 config.php 中的 ADMIN_PASS_HASH：

php -r "echo password_hash('新密码', PASSWORD_DEFAULT);"

Q: 如何修改网站标题和 SEO 信息？

A: 登录后台 → 系统设置，可修改站点名称、描述、关键词、全局 SEO 模板等。

Q: 数据库文件在哪里？

A: 默认在 data/blog.db，SQLite 单文件数据库，备份时直接复制该文件即可。

Q: 下载按钮支持哪些链接？

A: 支持任意 HTTP/HTTPS 链接，包括百度网盘、阿里云盘、夸克网盘、GitHub、直链等，不限数量。

📝 更新日志

v1.0.0 (2026-06-19)

✅ 初始版本发布
✅ 文章发布、编辑、删除、置顶
✅ 栏目分类管理（支持二级分类）
✅ 单页面管理
✅ 轮播图管理
✅ 广告位/工具推荐管理
✅ 热点推荐与今日精选
✅ 自动下载远程图片
✅ 自动过滤外部链接
✅ 富文本编辑器 + 源码切换
✅ 响应式前端布局
✅ 后台批量操作
✅ 多下载按钮支持
✅ SEO 自定义设置

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

Fork 本仓库
创建你的特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
打开一个 Pull Request

📄 开源协议

👤 关于作者

郭智满 —— 一名专注于 IT/互联网领域的技术博主
博客：https://www.zhiman.vip
邮箱：guozhiman@hotmail.com

如果本项目对你有帮助，请给个 ⭐ Star 支持一下！

zhiman-blog 轻量级、高性能个人博客系统