{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/254", "result": {"data":{"issuesJson":{"id":"9b4669e8-e367-53d0-9a93-e0fcfb0d3bff","title":"dromara/Jpom: 简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件","number":254,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Reposdromara/Jpom
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

\n\t\n\t \"logo\"\n\t\n

\n

\n\t【dromara】🚀简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件\n

\n

\n 【更是一款原生 ops 软件 / English】\n

\n

\n\t\n \"gitee\n \n \t\n\t\t\"github\n \n \t\n\t\t\"gitcode\n \n \n\t\t\"license\"\n\t \n

\n

\n \n \"jdk\"\n \n \n \"codacy\"\n \n \n\t\t\"docker\n \n \n\t\t\"docker\n \n

\n

\n\t👉 国际站：https://jpom.dromara.org 👈\n

\n

\n 👉 大陆站：https://jpom.top 👈\n

\n

😭 日常开发中，您是否有以下痛点？

\n\n
\n

如果是分布式的项目，以上步骤则更加繁琐。

\n

让 Jpom 来帮您解决这些痛点吧！然而，这些只是 Jpom 解决的最基础的功能。

\n
\n

😁 使用 Jpom 后

\n\n

🔔️ 特别提醒

\n
\n
    \n
  1. 在 Windows 服务器中可能有部分功能因为系统特性造成兼容性问题，建议在实际使用中充分测试。Linux 目前兼容性良好
    2. \n
  2. 服务端和插件端请安装到不同目录中，切勿安装到同一目录中
    3. \n
  3. 卸载 Jpom 插件端或者服务端，先停止对应服务，然后删除对应的程序文件、日志文件夹、数据目录文件夹即可
    4. \n
  4. 本地构建依赖的是系统环境，如果构建命令需要使用 maven 或者 node
    \n需要在构建项目的服务器安装好对应的环境。如果已经启动服务端再安装的对应环境需要通过命令行重启服务端后环境才会生效。
    5. \n
  5. 在 Ubuntu/Debian 服务器作为插件端可能会添加失败，请在当前用户的根目录创建 .bash_profile 文件
    6. \n
  6. 升级 2.7.x 后不建议降级操作，会涉及到数据不兼容的情况
    7. \n
  7. 由于目前 2.x.x 版本插件端和服务端主要采用 http 协议通讯，插件端和服务端网络要求互通，在使用的时候请注意。
    8. \n
  8. Jpom 3.0 版本已经开始规划更新了，尽请期待新版本的诞生吧
    9. \n
\n
\n

🗒️ 版本更新日志

\n

升级前必看：CHANGELOG.md

\n

📥 安装 Jpom

\n

Jpom 支持多种安装方式，满足不同用户的个性化需求，您只需要选择一种方式安装即可。

\n

方式一：🚀（推荐） 一键安装（Linux）

\n

一键安装服务端

\n
\n

注意：安装的目录位于执行命令的目录！

\n

⚠️ 特别提醒：一键安装的时候注意执行命令不可在同一目录下，即 Server 端和 Agent 端不可安装在同一目录下！

\n

如果需要修改服务端数据、日志存储的路径请修改
\napplication.yml
\n文件中 jpom.path 配置属性。

\n
\n
# 一键默认安装\ncurl -fsSL https://jpom.top/docs/install.sh | bash -s Server jdk+default\n# 一键默认安装 + 自动配置开机自启服务\ncurl -fsSL https://jpom.top/docs/install.sh | bash -s Server jdk+default+service\n\n# 安装服务端和 jdk 环境\nyum install -y wget && \\\nwget -O install.sh https://jpom.top/docs/install.sh && \\\nbash install.sh Server jdk\n\n# 安装服务端和 jdk、maven 环境\nyum install -y wget && \\\nwget -O install.sh https://jpom.top/docs/install.sh && \\\nbash install.sh Server jdk+mvn\n\n# ubuntu\napt-get install -y wget && \\\nwget -O install.sh https://jpom.top/docs/install.sh && \\\nbash install.sh Server jdk
\n

启动成功后，服务端的端口为 2122，可通过 http://127.0.0.1:2122/
\n访问管理页面（如果不是本机访问，需要把 127.0.0.1 换成您安装的服务器 IP 地址）。

\n
\n

如无法访问管理系统，执行命令 systemctl status firewalld 检查下是否开启了防火墙
\n，如状态栏看到绿色显示 Active: active (running) 需要放行 2122 端口。

\n
# 放行管理系统的 2122 端口\nfirewall-cmd --add-port=2122/tcp --permanent\n# 重启防火墙才会生效\nfirewall-cmd --reload
\n

如果在操作系统上放行了端口仍无法访问，并且您使用的是云服务器，请到云服务器后台中检查安全组规则是否放行 2122 端口。

\n

⚠️ 注意： Linux 系统中有多种防火墙：Firewall、Iptables、SELinux 等，再检查防火墙配置时候需要都检查一下。

\n
\n

一键安装插件端

\n
\n

如果安装服务端的服务器也需要被管理，在服务端上也需要安装插件端（同一个服务器中可以同时安装服务端和插件端）

\n

⚠️ 特别提醒：一键安装的时候注意执行命令不可在同一目录下，即 Server 端和 Agent 端不可安装在同一目录下！

\n

如果需要修改插件端数据、日志存储的路径请修改
\napplication.yml
\n文件中 jpom.path 配置属性。

\n
\n
# 一键默认安装\ncurl -fsSL https://jpom.top/docs/install.sh | bash -s Agent jdk+default\n# 一键默认安装 + 自动配置开机自启服务\ncurl -fsSL https://jpom.top/docs/install.sh | bash -s Agent jdk+default+service\n\n# 安装插件端和 jdk 环境\nyum install -y wget && \\\nwget -O install.sh https://jpom.top/docs/install.sh && \\\nbash install.sh Agent jdk\n\n# ubuntu\napt-get install -y wget && \\\nwget -O install.sh https://jpom.top/docs/install.sh && \\\nbash install.sh Agent jdk
\n

启动成功后，插件端的端口为 2123，插件端提供给服务端使用。

\n

方式二：📦 容器化安装

\n
\n

⚠️ 注意：容器化安装方式需要先安装 docker，点击跳转docker安装文档

\n
\n

一条命令安装

\n
docker run -p 2122:2122 --name jpom-server jpomdocker/jpom
\n

使用挂载方式存储相关数据（在部分环境可能出现兼容性问题）

\n
    \n
  1. 阿里仓库
    2. \n
\n
docker pull registry.cn-chengdu.aliyuncs.com/jpomdocker/jpom\nmkdir -p /home/jpom-server/logs\nmkdir -p /home/jpom-server/data\nmkdir -p /home/jpom-server/conf\ndocker run -d -p 2122:2122 \\\n\t--name jpom-server \\\n\t-v /home/jpom-server/logs:/usr/local/jpom-server/logs \\\n\t-v /home/jpom-server/data:/usr/local/jpom-server/data \\\n\t-v /home/jpom-server/conf:/usr/local/jpom-server/conf \\\n\tjpomdocker/jpom
\n
    \n
  1. dockerhub 仓库
    2. \n
\n
docker pull jpomdocker/jpom\nmkdir -p /home/jpom-server/logs\nmkdir -p /home/jpom-server/data\nmkdir -p /home/jpom-server/conf\ndocker run -d -p 2122:2122 \\\n\t--name jpom-server \\\n\t-v /home/jpom-server/logs:/usr/local/jpom-server/logs \\\n\t-v /home/jpom-server/data:/usr/local/jpom-server/data \\\n\t-v /home/jpom-server/conf:/usr/local/jpom-server/conf \\\n\tjpomdocker/jpom
\n

使用容器卷方式存储相关数据

\n
    \n
  1. 阿里仓库
    2. \n
\n
docker pull registry.cn-chengdu.aliyuncs.com/jpomdocker/jpom\ndocker volume create jpom-server-data\ndocker volume create jpom-server-logs\ndocker volume create jpom-server-conf\ndocker run -d -p 2122:2122 \\\n\t--name jpom-server \\\n\t-v jpom-server-data:/usr/local/jpom-server/data \\\n\t-v jpom-server-logs:/usr/local/jpom-server/logs \\\n\t-v jpom-server-conf:/usr/local/jpom-server/conf \\\n\tjpomdocker/jpom
\n
    \n
  1. dockerhub 仓库
    2. \n
\n
docker pull jpomdocker/jpom\ndocker volume create jpom-server-data\ndocker volume create jpom-server-logs\ndocker volume create jpom-server-conf\ndocker run -d -p 2122:2122 \\\n\t--name jpom-server \\\n\t-v jpom-server-data:/usr/local/jpom-server/data \\\n\t-v jpom-server-logs:/usr/local/jpom-server/logs \\\n\t-v jpom-server-conf:/usr/local/jpom-server/conf \\\n\tjpomdocker/jpom
\n
\n

容器化安装仅提供服务端版。由于容器和宿主机环境隔离，而导致插件端的很多功能无法正常使用，因此对插件端容器化意义不大。

\n

安装docker、配置镜像、自动启动、查找安装后所在目录等可参考文档
\nhttps://jpom.top/pages/b63dc5/

\n

在低版本 docker 中运行可能出现 ls: cannot access'/usr/local/jpom-server/lib/': Operation not permitted
\n错误，此时需要添加 --privileged 参数
\n如：docker run -p 2122:2122 --name jpom-server jpomdocker/jpom --privileged

\n
\n

方式三：💾 下载安装

\n
    \n
  1. 下载安装包 https://jpom.top/pages/all-downloads/
    2. \n
  2. 解压文件
    3. \n
  3. 安装插件端\n
      \n
    1. agent-x.x.x-release 目录为插件端的全部安装文件
      2. \n
    2. 上传到对应服务器（整个目录）
      3. \n
    3. 启动插件端，Windows 环境用 bat 脚本，Linux 环境用 sh 脚本。（如果出现乱码或者无法正常执行，请检查编码格式、换行符是否匹配。）
      4. \n
    4. 插件端默认运行端口：2123
      5. \n
    \n
    4. \n
  4. 安装服务端\n
      \n
    1. server-x.x.x-release 目录为服务端的全部安装文件
      2. \n
    2. 上传到对应服务器（整个目录）
      3. \n
    3. 启动服务端，Windows 环境用 bat 脚本，Linux 环境用 sh 脚本。（如果出现乱码或者无法正常执行，请检查编码格式、换行符是否匹配。）
      4. \n
    4. 服务端默认运行端口：2122，访问管理页面：http://127.0.0.1:2122/（非本机访问把 127.0.0.1 换成您的服务器 IP 地址）
      5. \n
    \n
    5. \n
\n

方式四：⌨️ 编译安装

\n
    \n
  1. 访问 Jpom 的码云主页，拉取最新完整代码（建议使用 master 分支）
    2. \n
  2. 切换到 web-vue 目录，执行 npm install（vue 环境需要提前搭建和安装依赖包详情可以查看 web-vue 目录下 README.md）
    3. \n
  3. 执行 npm run build 进行 vue 项目打包
    4. \n
  4. 切换到项目根目录执行：mvn clean package
    5. \n
  5. 安装插件端\n
      \n
    1. 查看插件端安装包 modules/agent/target/agent-x.x.x-release
      2. \n
    2. 打包上传服务器运行（整个目录）
      3. \n
    3. 启动插件端，Windows 环境用 bat 脚本，Linux 环境用 sh 脚本。（如果出现乱码或者无法正常执行，请检查编码格式、换行符是否匹配。）
      4. \n
    4. 默认运行端口：2123
      5. \n
    \n
    6. \n
  6. 安装服务端\n
      \n
    1. 查看插件端安装包 modules/server/target/server-x.x.x-release
      2. \n
    2. 打包上传服务器运行（整个目录）
      3. \n
    3. 启动服务端，Windows 环境用 bat 脚本，Linux 环境用 sh 脚本。（如果出现乱码或者无法正常执行，请检查编码格式、换行符是否匹配。）
      4. \n
    4. 服务端默认运行端口：2122，访问管理页面：http://127.0.0.1:2122/（非本机访问把 127.0.0.1 换成您的服务器 IP 地址）
      5. \n
    \n
    7. \n
\n
\n

也可以使用 script/release.bat 或 script/release.sh 快速打包。

\n
\n

方式五：📦 一键启动 docker-compose

\n\n
\n

需要注意修改 .env 文件中的 token 值

\n
\n
yum install -y git\ngit clone https://gitee.com/dromara/Jpom.git\ncd Jpom\ndocker-compose -f docker-compose.yml up\n# docker-compose -f docker-compose.yml up --build\n# docker-compose -f docker-compose.yml build --no-cache\n# docker-compose -f docker-compose-local.yml up\n# docker-compose -f docker-compose-local.yml build --build-arg TEMP_VERSION=.0\n# docker-compose -f docker-compose-cluster.yml up --build
\n

方式六：💻 编译运行

\n
    \n
  1. 访问 Jpom 的码云主页 拉取最新完整代码 （建议使用 master 分支，如果想体验新功能可以使用
    \ndev 分支）
    2. \n
  2. 运行插件端\n
      \n
    1. 运行 org.dromara.jpom.JpomAgentApplication
      2. \n
    2. 留意控制台打印的默认账号密码信息
      3. \n
    3. 插件端默认运行端口：2123
      4. \n
    \n
    3. \n
  3. 运行服务端\n
      \n
    1. 运行 org.dromara.jpom.JpomServerApplication
      2. \n
    2. 服务端默认运行端口：2122
      3. \n
    \n
    4. \n
  4. 构建 vue 页面，切换到 web-vue 目录（前提需要本地开发环境有 node、npm 环境）
    5. \n
  5. 安装项目 vue 依赖，控制台执行 npm install
    6. \n
  6. 启动开发模式，控制台执行 npm run dev
    7. \n
  7. 根据控制台输出的地址访问前端页面：http://127.0.0.1:3000/（非本机访问把 127.0.0.1 换成您的服务器 IP 地址）
    8. \n
\n

管理 Jpom 命令

\n
    \n
  1. Windows 系统使用 bat 脚本文件。
    2. \n
\n
# 服务端管理脚本 （命令行）\n./bin/Server.bat start   # 启动Jpom服务端\n./bin/Server.bat stop    # 停止Jpom服务端\n./bin/Server.bat restart # 重启Jpom服务端\n./bin/Server.bat status  # 查看Jpom服务端运行状态\n# 服务端管理脚本 （控制面板），按照面板提示输入操作\n./bin/Server.bat\n\n# 插件端管理脚本\n./bin/Agent.bat start   # 启动Jpom插件端\n./bin/Agent.bat stop    # 停止Jpom插件端\n./bin/Agent.bat restart # 重启Jpom插件端\n./bin/Agent.bat status  # 查看Jpom插件端运行状态\n# 插件端管理脚本（控制面板），按照面板提示输入操作\n./bin/Agent.bat\n
\n
\n

Windows 系统中执行启动后需要根据日志去跟进启动的状态，如果出现乱码请检查或者修改编码格式，Windows 系统中 bat
\n编码格式推荐为 GB2312

\n
\n
    \n
  1. Linux 系统中使用 sh 脚本文件。
    2. \n
\n
# 服务端\n./bin/Server.sh start     # 启动Jpom服务端\n./bin/Server.sh stop      # 停止Jpom服务端\n./bin/Server.sh restart   # 重启Jpom服务端\n./bin/Server.sh status    # 查看Jpom服务端运行状态\n./bin/Service.sh install  # 创建Jpom服务端的应用服务（jpom-server）\n\n# 插件端\n./bin/Agent.sh start     # 启动Jpom插件端\n./bin/Agent.sh stop      # 停止Jpom插件端\n./bin/Agent.sh restart   # 重启Jpom插件端\n./bin/Agent.sh status    # 查看Jpom插件端运行状态\n./bin/Service.sh install # 创建Jpom插件端的应用服务（jpom-agent）
\n

Linux 服务方式管理

\n
\n

这里安装服务仅供参考，实际中可以根据需求自定义配置

\n

在使用 ./bin/Service.sh install 成功后

\n

systemctl {status | start | stop | restart} jpom-server

\n

systemctl {status | start | stop | restart} jpom-agent

\n
\n

⚙️ Jpom 的参数配置

\n

在项目运行的根路径下的 ：

\n

程序配置 ./conf/application.yml

\n
    \n
  1. 插件端示例：
    \napplication.yml
    2. \n
  2. 服务端示例：
    \napplication.yml
    3. \n
\n

项目日志 ./conf/logback.xml

\n
    \n
  1. 插件端示例：
    \nlogback.xml
    2. \n
  2. 服务端示例：
    \nlogback.xml
    3. \n
\n

📝 常见问题、操作说明

\n\n

实践案例

\n
\n

里面有部分图片加载可能比较慢

\n
\n
    \n
  1. 本地构建 + SSH 发布 java 项目
    2. \n
  2. 本地构建 + 项目发布 node 项目
    3. \n
  3. 本地构建 + SSH 发布 node 项目
    4. \n
  4. 本地构建 + 自定义管理 python 项目
    5. \n
  5. 自定义管理 java 项目
    6. \n
  6. 管理编译安装的 nginx
    7. \n
  7. 管理 docker
    8. \n
  8. 容器构建 + 项目发布 java 项目
    9. \n
  9. 更新实践案例>>
    10. \n
\n

构建案例仓库代码

\n
    \n
  1. Jboot 案例代码
    2. \n
  2. SpringBoot 案例代码(ClassPath)
    3. \n
  3. SpringBoot 案例代码(Jar)
    4. \n
  4. node vue 案例代码(antdv)
    5. \n
  5. python 案例代码
    6. \n
\n
\n

Node.js 编译指定目录：

\n
\n
yarn --cwd xxxx/ install\nyarn --cwd xxxx/ build
\n
\n

Maven 编译指定目录：

\n
\n
mvn -f xxxx/pom.xml clean package
\n

🛠️ 整体架构

\n

\"jpom-func-arch\"

\n

🐞 交流讨论 、反馈 BUG、提出建议等

\n
    \n
  1. 快扫描下方左侧微信群二维码和我们一起交流讨论吧！（添加小助手：备注 Jpom 进群）
    2. \n
  2. 开源项目离不开社区的支持，如果项目帮助到了您，并且想给我们加个餐。
    \n欢迎扫描下方微信、支付宝收款码赞赏
    \n或通过码云赞赏
    \n（在项目首页下方点击捐赠，支持微信和支付宝）。赞赏记录
    3. \n
  3. 购买开源周边商品：周边介绍
    4. \n
  4. 企业技术服务请单独与我们联系沟通服务方案
    5. \n
  5. 反馈 BUG、提出建议，欢迎新建：issues，开发人员会不定时查看回复。
    6. \n
  6. 参与贡献，请查看贡献指南。
    7. \n
\n

感谢所有赞赏以及参与贡献的小伙伴，您们的支持是我们不断更新前进的动力！

\n

\n\"praise\n

\n

💖 周边商品

\n

为了更好地维持开源项目，我们决定推出周边商品。

\n

购买支持我们这样您既获得了一份小商品我们也获得了您购买商品的利润（周边商品的价格会比市场价稍高，介意请勿下单）

\n

\n\"shop\n

\n

🔨贡献指南

\n
\n

提交贡献即认为签署了 CLA 协议

\n
\n

贡献须知

\n

Jpom 作为开源项目，离不开社区的支持，欢迎任何人修改和提出建议。贡献无论大小，您的贡献会帮助背后成千上万的使用者以及开发者，您做出的贡献也会永远的保留在项目的贡献者名单中，这也是开源项目的意义所在！

\n

为了保证项目代码的质量与规范，以及帮助您更快的了解项目的结构，请在贡献之前阅读：

\n\n

贡献步骤

\n
    \n
  1. \n

    Fork 本仓库。

    \n
    2. \n
  2. \n

    Fork 后会在您的账号下多了一个和本仓库一模一样的仓库，把您账号的仓库 clone 到本地。

    \n

    注意替换掉链接中的分支名和用户名。

    \n

    如果是贡献代码，分支名填 dev；如果是贡献文档，分支名填 docs

    \n
    git clone -b 分支名 https://gitee.com/用户名/Jpom.git
    \n
    3. \n
  3. \n

    修改代码/文档，修改后提交上来。

    \n
    # 把修改的文件添加到暂存区\ngit add .\n# 提交到本地仓库，说明您具体做了什么修改\ngit commit -m '填写您做了什么修改'\n# 推送到远程仓库，分支名替换成 dev 或者 docs\ngit push origin 分支名
    \n
    4. \n
  4. \n

    登录您的仓库，然后会看到一条 PR 请求，点击请求合并，等待管理员把您的代码合并进来。

    \n
    5. \n
\n

项目分支说明

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
分支说明
master主分支，受保护分支，此分支不接受 PR。在 beta 分支后经过测试没问题后会合并到此分支。
betabeta 版本 分支，受保护分支，此分支不接受 PR。在 dev 分支后经过测试没问题后会合并到此分支。
dev开发分支，接受 PR，PR 请提交到 dev 分支。
docs项目文档分支，接受 PR，介绍项目功能、汇总常见问题等。
\n
\n

目前用到的主要是 dev 和 docs 分支，接受 PR 修改，其他的分支为归档分支，贡献者可以不用管。

\n
\n

贡献者

\n\n \"contributors\"\n\n

Made with contrib.rocks.

\n

🌍 知识星球

\n

\n\"扫码加入知识星球，了解学习更多知识\"\n

\n

🔔 精品项目推荐

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目名称项目地址项目介绍
SpringBoot_v2https://gitee.com/bdj/SpringBoot_v2基于springboot的一款纯净脚手架
TLog GVP 项目https://gitee.com/dromara/TLog一个轻量级的分布式日志标记追踪神器，10分钟即可接入，自动对日志打标签完成微服务的链路追踪
Sa-Tokenhttps://gitee.com/dromara/sa-token这可能是史上功能最全的 Java 权限认证框架！
Erupthttps://gitee.com/erupt/erupt零前端代码，纯注解开发 admin 管理后台
hippo4jhttps://gitee.com/magegoofy/hippo4j强大的动态线程池框架，附带监控报警功能。
HertzBeathttps://gitee.com/dromara/hertzbeat易用友好的云监控系统, 无需 Agent, 强大自定义监控能力。
\n

🤝 鸣谢

\n\n

\n\"JetBrains\"\n

","updatedAt":"2025-05-21T16:03:43Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"CICD","color":"cd57f9"}},{"node":{"name":"dromara","color":"3a35a2"}}]},"comments":{"edges":[]}}},"pageContext":{"number":254,"previous":{"title":"joggle-cn/joggle: Joggle 是基于 Ngrok 二开的开源内网穿透项目，支持多节点、私有部署、云服务。","number":253},"next":{"title":"AykutSarac/jsoncrack.com: 将 JSON、YAML、XML、CSV 等各种数据格式转换为交互式图表的工具","number":255}}}, "staticQueryHashes": ["151096407","2861350382"]}