Traccar 官方文档地址:Build from Source - Traccar
由于官方文档本地部署步骤并不详细且无法复现,本文档从环境配置到运行代码一步一步进行操作教学:
第一步:下载git
打开该链接下载git
Git - Downloading Package (git-scm.com)
下载安装包后打开按默认选项安装
第二步:在项目文件夹路径下拉取Traccar代码
注意:项目文件夹及其父路径必须使用英文命名,不要出现中文命名
完成第一步git安装后,在项目文件夹下点击鼠标右键,找到git bash
粘贴这条命令到命令行后按回车键
git clone --recursive https://github.com/traccar/traccar.git
等待git拉取仓库代码,如果拉取失败是网络问题,可开热点连接手机热点或更换网络后重新拉取。
第三步 下载Visual Studio Code
Download Visual Studio Code - Mac, Linux, Windows
打开该网址选择windows版本下载:
按安装包提示下载安装Visual Studio Code
安装后打开Visual Studio Code,Visual Studio Code默认语言包为英文,如需中文语言包请在extension 插件栏中下载中文语言包,下载后关闭Visual Studio Code重新打开即可生效,由于本人习惯使用英文版Visual Studio Code,故并未安装中文语言包,后续步骤也基于英文版本语言进行示教,可根据个人习惯自由选择
之后点击Open Folder, 打开Traccar项目文件夹
打开后如图所示:
Traccar 项目前后端代码未分离,后端代码仓库包含前端代码,为方便打开终端窗口进行调试,我们把前端代码也加入到工作区中:
项目中的traccar-web即为前端代码地址,在工作区空白区域右键鼠标,我们把traccar-web文件夹也加入到工作区
结果如图所示:
第四步 下载Java JDK 并配置Java运行环境
Java Downloads | Oracle
本Traccar项目后端使用Java17 版本,为适配项目,我们也下载Java17进行适配,点击安装包下载,下载安装包后按默认选项下载即可。
安装好后配置Java系统环境变量:
windows setting中搜索系统环境变量
点击编辑系统环境变量
新建变量, 把变量名命名为JAVA_HOME,变量值为Java 17 JDK 默认安装环境C:\Program Files\Java\jdk-17
之后鼠标双击点击系统变量选择框下的Path变量
点击新建,输入%JAVA_HOME%\bin 后点击确定
到此,Java系统环境变量已配置完成,按键盘上winows标志+ R 键调出运行命令窗口,输入cmd后点击确认调用出系统命令提示符窗口(系统终端Terminal)
输入
java –version
如图下显示即证明安装成功
第五步 在Visual Studio Code 安装Java扩展插件
打开Visual Studio Code,并在extension扩展插件中安装Extension Pack for Java
安装完成后关闭Visual Studio Code重新打开Visual Studio Code
重新打开后点击工作区,看到Java:Ready 后说明Java环境已经准备好,可以在后端终端运行下载依赖,并运行Gradle
第六步 打开后端项目的终端,输入命令下载相关依赖,运行后端
点击Terminal, New Terminal
选择traccar,我们的后端项目路径:
在命令行中键入命令后按回车键:
./gradlew assemble
如果遇到Gradle下载失败Error(timeout 10000) ,请切换网络或使用个人热点重现下载,该项目下载gradle地址为github仓库,由于国内访问github网络并不稳定,有时不可访问会导致下载失败,尽量不要使用公司内网下载,公司内网安全组可能设置禁止访问github导致下载依赖失败
看到绿色的构建成功说明该项目后端依赖已经下载成功,可以运行后端代码开服务:
找到后端项目traccar\src\main\java\org\traccar路径下的Main.java文件,在代码文件右上角找到运行按钮,点击运行
看到终端命令中的 Started 说明运行成功了,后端项目运行在Localhost:8082端口上,此时在浏览器上输入Localhost:8082应该能看到这个页面,说明后端运行成功
第七步 下载node.js
Node.js相当于前端JavaScript的JDK, 我们需要下载Node.js后在前端运行JavaScript文件及用npm包管理工具下载前端的依赖和相关包
Node.js 中文网 — 下载 Node.js ® (nodejs.cn)
我们下载安装包, 通过安装包下载node.js,按默认选项选择即可,node.js默认会自动配置环境变量,不用像Java一样还需要手动配置系统环境变量
安装包安装成功后,像检查Java是否安装配置成功一样,用win + R 键调用命令运行框,再输入cmd调出命令提示符
输入
node -v
如果出现版本号,说明安装成功
第八步 打开前端项目的终端,输入命令下载相关依赖,运行前端
不要关闭后端终端,让他始终保持运行,此项目前端的运行依赖于后端,不开后端服务会导致前端无法运行并报错,当然你也可以选择先关闭后端,等前端依赖安装完成后再运行后端
选择traccar-web
打开前端的终端窗口后,键入以下命令,这是将npm下载的依赖源改为国内镜像源,以提高下载速度并预防下载失败:
npm config set registry https://registry.npmmirror.com
设置好后输入以下命令, PNPM 的安装速度领先于 NPM 和 Yarn,尤其是在网络环境较差时表现更加出色, 且通过硬链接技术,共享相同的依赖包,大幅减少磁盘占用,相当于升级版的npm,所以我们先下载pnpm,用pnpm下载前端的依赖和包:
npm install pnpm --global
之后我们运行:
pnpm install
如果遇到终端中显示该错误:
pnpm : 无法加载文件 C:\Users\xxxxx\pnpm.ps1,因为在此系统上禁止运行脚本
请在setting搜索框搜索PowerShell,然后点击以管理员身份运行:
在命令行中键入:
set-ExecutionPolicy RemoteSigned
记住,一定要以管理员身份运行,不然会得到以下错误:
更改好执行策略后再返回Visual Studio Code,再在终端中重新运行命令
pnpm install
如果遇到pnpm下载sharp包失败:sharp: Installation error: Hostname/IP does not match certificate‘s altnames: Host: … 错误
请输入以下命令,单独为sharp包设置镜像下载地址后再重新使用:
pnpm config set sharp_binary_host=https://npmmirror.com/mirrors/sharp
pnpm config set sharp_libvips_binary_host=https://npmmirror.com/mirrors/sharp-libvips
设置结束后重新输入:
pnpm install
终端中显示Done说明前端依赖已经下载成功
之后我们可以在命令行中输入
pnpm start
启动前端服务,用pnpm start开前端服务会快一点:
也可找到前端目录下的package.json文件,点击文件中scripts上方的Debug按钮,选择start进行开启前端服务:
用debug按钮开启前端服务会新开一个终端命令窗口,如下图所示即是运行成功,即可直接点击下方运行地址,查看前端项目,前端项目 使用本地localhost:3000端口
打开后如图所示,可随便注册账号进入Traccar项目进行查看: