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或~/.zshrc）：
export MAVEN_HOME=/opt/apache-maven-3.8.6 export PATH=$MAVEN_HOME/bin:$PATH然后配置阿里云镜像加速依赖下载，编辑/opt/apache-maven-3.8.6/conf/settings.xml：
<mirrors> <mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://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 'zrlog'@'localhost' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON zrlog.* TO 'zrlog'@'localhost'; 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.skip=true构建成功后，会在zrlog-admin/target目录生成可运行的jar包，文件名类似zrlog-admin-2.2.0.jar。
经验分享：第一次构建可能会比较慢，因为需要下载所有依赖。使用阿里云镜像后，我的构建时间从原来的15分钟缩短到3分钟左右。
4. 配置与运行ZrLog
4.1 基础配置
创建配置文件application.properties：
# 数据库配置 spring.datasource.driver-class-name=com.mysql.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/zrlog?useUnicode=true&characterEncoding=UTF-8 spring.datasource.username=zrlog spring.datasource.password=your_password # 服务器端口 server.port=8080 # 上传文件大小限制 spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB # 开发模式关闭缓存 spring.thymeleaf.cache=false4.2 启动应用
使用以下命令启动ZrLog：
java -jar zrlog-admin/target/zrlog-admin-2.2.0.jar --spring.config.location=application.properties启动成功后，访问http://服务器IP:8080即可进入安装向导。
4.3 安装向导配置
按照页面提示完成安装：
- 设置管理员账号和密码
- 配置网站基本信息（标题、描述等）
- 完成安装后进入后台管理界面
避坑提示：如果安装过程中出现数据库连接错误，请检查：
- MySQL服务是否正常运行
- 数据库用户权限是否正确
- 防火墙是否放行了3306端口
5. 生产环境优化部署
5.1 使用Systemd管理服务
创建服务文件/etc/systemd/system/zrlog.service：
[Unit] Description=ZrLog Blog Service After=syslog.target network.target [Service] User=www Group=www WorkingDirectory=/opt/zrlog ExecStart=/usr/bin/java -jar /opt/zrlog/zrlog-admin-2.2.0.jar --spring.config.location=/opt/zrlog/application.properties SuccessExitStatus=143 Restart=always RestartSec=10 [Install] WantedBy=multi-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 -p'your_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.skip=true
6.2 启动时报端口冲突
问题现象：Web server failed to start. Port 8080 was already in use.
解决方案：
- 查找占用端口的进程：
sudo netstat -tulnp | grep 8080 - 终止冲突进程或修改ZrLog的监听端口：
server.port=8081
6.3 上传文件大小限制
问题现象：上传大文件时报Maximum upload size exceeded
解决方案： 修改application.properties：
spring.servlet.multipart.max-file-size=50MB spring.servlet.multipart.max-request-size=50MB7. 进阶配置与优化
7.1 邮件通知配置
在application.properties中添加邮件设置：
# 邮件配置 mail.host=smtp.example.com mail.port=587 mail.username=your_email@example.com mail.password=your_password mail.protocol=smtp mail.properties.mail.smtp.auth=true mail.properties.mail.smtp.starttls.enable=true mail.from=your_email@example.com7.2 Redis缓存加速
安装Redis后，添加依赖到pom.xml：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency>配置Redis连接：
# Redis配置 spring.redis.host=localhost spring.redis.port=6379 spring.redis.password= spring.redis.database=07.3 静态资源CDN加速
修改主题模板中的资源引用，例如：
<script src="/plugins/some-plugin.js"></script> 改为 <script src="https://cdn.example.com/plugins/some-plugin.js"></script>或者使用Nginx的proxy_cache实现本地缓存：
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m inactive=60m; 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> <groupId>com.zrlog</groupId> <artifactId>zrlog.common</artifactId> <version>${zrlog.version}</version> <scope>provided</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启动开发服务器，实时测试插件效果
