1. 为什么选择ZrLog博客系统ZrLog是一款基于Java开发的轻量级开源博客系统相比WordPress等PHP博客平台它在性能和安全方面有着明显优势。我最初选择ZrLog主要是看中以下几个特点Java生态优势基于Spring Boot框架开发天然具备跨平台特性部署环境要求简单响应式设计默认主题适配各种终端设备移动端体验良好Markdown支持内置完善的Markdown编辑器写作体验流畅插件机制通过插件可以扩展各种功能满足个性化需求不过官方文档中主要提供的是War包部署方式这对于很多开发者来说不够透明。通过Maven直接构建部署可以让我们更清楚地掌握整个项目的依赖关系和构建过程这也是我写这篇指南的初衷。2. 环境准备与工具安装2.1 JDK安装与配置ZrLog需要Java 8或以上版本运行环境。推荐使用OpenJDK# Ubuntu/Debian sudo apt update sudo apt install openjdk-11-jdk # CentOS/RHEL sudo yum install java-11-openjdk-devel安装完成后验证版本java -version注意如果服务器上已有其他Java项目建议使用jenv等工具管理多版本JDK避免冲突。2.2 Maven安装与阿里云镜像配置Maven是Java项目的标准构建工具我们先安装最新版wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz tar -xzf apache-maven-3.8.6-bin.tar.gz sudo mv apache-maven-3.8.6 /opt/配置环境变量~/.bashrc或~/.zshrcexport MAVEN_HOME/opt/apache-maven-3.8.6 export PATH$MAVEN_HOME/bin:$PATH然后配置阿里云镜像加速依赖下载编辑/opt/apache-maven-3.8.6/conf/settings.xmlmirrors mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors验证Maven安装mvn -v2.3 数据库准备ZrLog支持MySQL/MariaDB和H2数据库。生产环境推荐MySQL# Ubuntu/Debian sudo apt install mysql-server # CentOS/RHEL sudo yum install mariadb-server sudo systemctl start mariadb创建数据库和用户CREATE DATABASE zrlog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER zrloglocalhost IDENTIFIED BY your_password; GRANT ALL PRIVILEGES ON zrlog.* TO zrloglocalhost; FLUSH PRIVILEGES;3. 获取ZrLog源码并构建3.1 克隆源码仓库推荐从官方GitHub仓库获取最新代码git clone https://github.com/94fzb/zrlog.git cd zrlog如果网络问题导致克隆缓慢可以使用国内镜像git clone https://gitee.com/mirrors/zrlog.git3.2 Maven构建项目在项目根目录执行构建命令mvn clean package -Dmaven.test.skiptrue构建成功后会在zrlog-admin/target目录生成可运行的jar包文件名类似zrlog-admin-2.2.0.jar。经验分享第一次构建可能会比较慢因为需要下载所有依赖。使用阿里云镜像后我的构建时间从原来的15分钟缩短到3分钟左右。4. 配置与运行ZrLog4.1 基础配置创建配置文件application.properties# 数据库配置 spring.datasource.driver-class-namecom.mysql.jdbc.Driver spring.datasource.urljdbc:mysql://localhost:3306/zrlog?useUnicodetruecharacterEncodingUTF-8 spring.datasource.usernamezrlog spring.datasource.passwordyour_password # 服务器端口 server.port8080 # 上传文件大小限制 spring.servlet.multipart.max-file-size10MB spring.servlet.multipart.max-request-size10MB # 开发模式关闭缓存 spring.thymeleaf.cachefalse4.2 启动应用使用以下命令启动ZrLogjava -jar zrlog-admin/target/zrlog-admin-2.2.0.jar --spring.config.locationapplication.properties启动成功后访问http://服务器IP:8080即可进入安装向导。4.3 安装向导配置按照页面提示完成安装设置管理员账号和密码配置网站基本信息标题、描述等完成安装后进入后台管理界面避坑提示如果安装过程中出现数据库连接错误请检查MySQL服务是否正常运行数据库用户权限是否正确防火墙是否放行了3306端口5. 生产环境优化部署5.1 使用Systemd管理服务创建服务文件/etc/systemd/system/zrlog.service[Unit] DescriptionZrLog Blog Service Aftersyslog.target network.target [Service] Userwww Groupwww WorkingDirectory/opt/zrlog ExecStart/usr/bin/java -jar /opt/zrlog/zrlog-admin-2.2.0.jar --spring.config.location/opt/zrlog/application.properties SuccessExitStatus143 Restartalways RestartSec10 [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable zrlog sudo systemctl start zrlog5.2 Nginx反向代理配置安装Nginx后添加站点配置server { listen 80; server_name yourdomain.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } # 静态资源缓存 location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ { expires 30d; access_log off; } }5.3 定期备份策略建议设置自动备份脚本/opt/zrlog/backup.sh#!/bin/bash DATE$(date %Y%m%d) BACKUP_DIR/backup/zrlog mkdir -p $BACKUP_DIR # 备份数据库 mysqldump -u zrlog -pyour_password zrlog $BACKUP_DIR/zrlog_db_$DATE.sql # 备份上传文件 tar -czf $BACKUP_DIR/zrlog_uploads_$DATE.tar.gz /opt/zrlog/upload # 备份配置文件 cp /opt/zrlog/application.properties $BACKUP_DIR/ # 保留最近7天备份 find $BACKUP_DIR -type f -mtime 7 -exec rm {} \;添加到crontab每天执行0 2 * * * /bin/bash /opt/zrlog/backup.sh6. 常见问题排查6.1 构建失败问题问题现象Maven构建时出现依赖下载失败解决方案检查阿里云镜像配置是否正确尝试清理本地仓库后重新构建rm -rf ~/.m2/repository/* mvn clean package -Dmaven.test.skiptrue6.2 启动时报端口冲突问题现象Web server failed to start. Port 8080 was already in use.解决方案查找占用端口的进程sudo netstat -tulnp | grep 8080终止冲突进程或修改ZrLog的监听端口server.port80816.3 上传文件大小限制问题现象上传大文件时报Maximum upload size exceeded解决方案 修改application.propertiesspring.servlet.multipart.max-file-size50MB spring.servlet.multipart.max-request-size50MB7. 进阶配置与优化7.1 邮件通知配置在application.properties中添加邮件设置# 邮件配置 mail.hostsmtp.example.com mail.port587 mail.usernameyour_emailexample.com mail.passwordyour_password mail.protocolsmtp mail.properties.mail.smtp.authtrue mail.properties.mail.smtp.starttls.enabletrue mail.fromyour_emailexample.com7.2 Redis缓存加速安装Redis后添加依赖到pom.xmldependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-redis/artifactId /dependency配置Redis连接# Redis配置 spring.redis.hostlocalhost spring.redis.port6379 spring.redis.password spring.redis.database07.3 静态资源CDN加速修改主题模板中的资源引用例如script src/plugins/some-plugin.js/script 改为 script srchttps://cdn.example.com/plugins/some-plugin.js/script或者使用Nginx的proxy_cache实现本地缓存proxy_cache_path /var/cache/nginx levels1:2 keys_zonemy_cache:10m inactive60m; location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ { proxy_cache my_cache; proxy_pass http://127.0.0.1:8080; proxy_cache_valid 200 302 60m; proxy_cache_valid 404 1m; }8. 插件开发与扩展ZrLog支持通过插件扩展功能。创建一个基础插件需要以下步骤创建Maven项目添加依赖dependency groupIdcom.zrlog/groupId artifactIdzrlog.common/artifactId version${zrlog.version}/version scopeprovided/scope /dependency实现插件入口类public class MyPlugin implements Plugin { Override public boolean start(PluginContext context) { // 插件启动逻辑 return true; } Override public boolean stop(PluginContext context) { // 插件停止逻辑 return true; } }打包插件mvn clean package将生成的jar包放入plugins目录重启ZrLog生效开发技巧可以使用mvn zrlog:run启动开发服务器实时测试插件效果
