如何安装

ZrLog 对一些不太懂网站程序安装的网友提供了简洁，便利的安装引导，不过呢，还是有少部分网友安装安装过程也不是想象的那么的流畅，对于这种问题，于是就有了下面这个比较完善的安装教程

安装前置准备

  • jdk 版本 >= 21（若使用的 graalvm native image 可以无需 Java 环境）
  • mysql >= 5.6（推荐使用 mysql8）

Windows

Windows 安装 mysql

  • 通过 mysql 官网 下载适合自己的版本的安装
  • 如果网络过慢可以通过 站长之家 下载
  • 解压完后，运行其中的 .exe 文件，一直按照步骤走完安装流程就可以了

这里注意下，选择下编码 UTF-8

Windows 安装 Java

若选择 graalvm native image 跳过这一步 jdk 安装

  • 通过 oralce 下载自己合适的版本
  • 运行 .exe 文件一直走完安装流程。
  • 配置环境变量
  • 控制面板控\制面板项\系统\高级设置
  • 开始搭建java的环境变量了额,选择新建一个命名为 JAVA_HOME 在变量值的那一行中填写C:\Program Files\Java\jdk1.6.0_43。
  • 看看有没有Path这个,如果没有的话就新建一个吧 有的话。 千万不要把它给删除了额。 删除的话 会导致其实东不能用的额 比如系统的东西可能会存在不能访问额。 在变量值中的前填写 自己的JDK的路径 C:\Program Files\Java\jdk1.6.0_43\bin; 或者是 %JAVA_HOME%\bin; 这里%时说的这里的面的东西时变量 而不是单纯的路径额
  • 查看是否电脑中有 java环境的话 进入dos（win+R）框输入 java （这里必有一个空格额） -version 如果显示了对于的 Java 版本信息就表示安装完成了

Linux 安装

Linux 安装 mysql

  • RedHat/CentOS
    yum -y install mysql-server
  • Debian/Ubuntu
    sudo apt-get -y install mysql-server

Linxu 安装 Java

若选择 graalvm native image 跳过这一步 jdk 安装

介于Linux下面安装方式较多就说一个自己在用的

  • 通过 oralce 下载自己合适的版本
  • 解压 .tar.gz 文件
    tar -xvf jdk-*.tar.gz
  • 在 .basrhc 文件最后面追加
    vim .basrhc
  1. export JAVA_HOME=/home/xiaochun/dev/jdk1.8.0_45（填写自己对应的路径）
  2. export PATH=$JAVA_HOME/bin:$PATH

source .basrhc 刷新下，然后用 java -version 接可以了

创建数据库

注：程序并不会自动创建对应的数据，安装前需要手动创建数据库

创建用户以及数据库，下面的SQL语句为 创建一个 zrlog_test 的数据库，创建一个 zrlog_test用户 登录密码为 123456 可以完全访问 zrlog_test 这个数据库

  1. create database zrlog_test;
  2. CREATE USER "zrlog_test"@"%" IDENTIFIED BY "123456";
  3. use mysql;
  4. GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, EXECUTE, TRIGGER ON `zrlog\_test`.* TO "zrlog_test"@"%";

准备工作完成

unix 快速开始

如果你正好用的也是 Linux 系统，那么这行命令可以让你更快的运行 ZrLog

请先确保已经安装了 wget curl zip 这些工具

注意：如果 8080 已经被已有服务占用，可修改后面的 –port=28080 就可以把服务绑定在新的端口上

请在合适的文件路径下运行这个命令，比如 /data/app/zrlog 又或者 /opt/zrlog

curl -s https://www.zrlog.com/install/zrlog-unix-quick-start.sh | bash -s -- release --port=8080

手动配置

由于网络到处都是采集的，难免源码被人篡改，推荐使用 https://dl.zrlog.com/release/zrlog.zip 这个地址下载

  • 将 .zip 放到合适的目录下，Linux 推荐放在 /opt 或者 /data 下
  • 通过 sh bin/start.sh 或者 bin\start.bat 启动 zrlog 查看控制是否有错误信息输出，若没有可以访问 http://host:port/install 开始使用向导安装

在输入管理密码的时候，请输入一个安全度足够高的密码

安装常见问题

无法加载静态资源问题

使用Nginx这类代理软件，需要额外修改将代理前的 Host给容器（默认会被转化为127.0.0.1:8080这类地址）

Nginx 添加 proxy_set_header Host $host 到对应 server 配置项，或则是在 http 模块里面

Windows 系统页面乱码

由于程序默认的编码为 UTF-8，而有的系统是gbk的，所以需要手动配置编码，需要添加一个环境变量

JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8

数据库用户名密码都正确却提示密码错误

  • 使用其它第三方工具看看能否正常连接
  • MySQL安装在 Docker 内时，使用 root 账户进行安装的时候检查是否启用了 ROOT 远程登录（强烈不推荐使用 root 作为 ZrLog 的 MySQL 的数据库账户）