zrlog

ZrLog

中文 | English

ZrLog 是一款基于 Java 的开源博客系统。它提供文章、分类、标签、评论、主题、插件、静态化和在线升级等功能，内置 Markdown 编辑器，管理界面基于 React 和 Ant Design 构建。

程序主页

https://www.zrlog.com

界面预览

文章详情页

文章编辑页

文章编辑页【暗黑模式】

文章编辑页【PWA全屏】

文章编辑页【PWA全屏-打开设置抽屉】

功能特性

1. 内容管理: 支持文章、分类、标签和评论管理。
2. 插件扩展: 支持通过插件扩展功能（如何编写一个插件），也可以接入第三方评论服务。
3. 主题系统: 支持自定义和切换博客主题（如何制作一套主题）。
4. 文章编辑: 内置 Markdown 编辑器，支持常用写作和预览流程。
5. 访问优化: 支持页面静态化和公共数据缓存。
6. 部署形态: 支持 Docker、Zip、War、Native Image 和 Serverless / D1 相关部署方式。
7. 运维能力: 支持数据库定时备份和在线升级。

快速开始（针对开发者）

• 在 IDE 中运行 com.zrlog.web.Application 的 main() 方法进行调试。
• 通过 Maven 脚本启动（不依赖 IDE）：
  • Windows 环境执行 bin\mvn-run.cmd
  • Unix 平台执行 sh bin/mvn-run.sh

程序安装部署

• 环境前置要求

  • JDK 版本： >= 11（注：若选择 GraalVM Native Image 发行包免装环境，则不受此限制）。
  • 数据库支持：MySQL >= 5.7，或者 Cloudflare D1（通过 Web API 方式代理访问）。

• 方式一：Docker 部署 使用容器启动服务：

  docker run -p 8080:8080 -v $(pwd)/conf:/opt/zrlog/conf zrlog/zrlog

• 方式二：Zip 包部署

  • 下载 最新 Zip 安装包 并解压。
  • 在解压目录运行 bin/start.sh，或者在 Windows 中执行 bin/start.bat。
  • 访问 http://host:port/install。
  • 按页面提示填写数据库和管理员信息。

变更日志

查看完整的 ChangeLog

示例网站

• 演示站点: https://demo.zrlog.com
• 后台管理地址: admin/login
• 演示账号: admin
• 演示密码: 123456

获得支持与帮助

• 微信号: hibegin
• 邮件支持: [email protected]
• 缺陷反馈与建议: 欢迎在 反馈页面 或 GitHub Issues 中提交

常见问题

Docker 模式下，输入正确的数据库信息，仍无法完成安装

• 先检查容器网络、数据库地址和挂载目录。更多排查步骤见：排查配置文档。

其它问题检索

更多问题可查看：FAQ。

鸣谢

感谢以下优秀开源项目及服务的支持：

• JFinal
• Editor.md
• SheShui.me
• Gentelella
• AntD
• Jetbrains
• e-lionel
• Cloudflare

协议声明

ZrLog is Open Source software released under the Apache 2.0 license.