Jpom 技术文档：安装指南与使用说明

Jpom 技术文档：安装指南与使用说明

【免费下载链接】Jpom 【dromara】🚀简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件 项目地址: https://gitcode.com/dromara/Jpom

1. 安装指南

1.1 系统要求

• JDK 1.8.0_40+
• Linux/Windows 服务器（推荐 Linux）
• 内存：建议 2GB 以上

1.2 安装方式

1.2.1 一键安装（Linux 推荐）

服务端安装：

# 默认安装（含JDK）
curl -fsSL https://jpom.top/docs/install.sh | bash -s Server jdk+default

# 安装服务端+JDK+Maven
yum install -y wget && \
wget -O install.sh https://jpom.top/docs/install.sh && \
bash install.sh Server jdk+mvn

插件端安装：

# 默认安装（含JDK）
curl -fsSL https://jpom.top/docs/install.sh | bash -s Agent jdk+default

1.2.2 容器化安装

基础安装：

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

挂载数据目录：

mkdir -p /home/jpom-server/{logs,data,conf}
docker run -d -p 2122:2122 \
    -v /home/jpom-server/logs:/usr/local/jpom-server/logs \
    -v /home/jpom-server/data:/usr/local/jpom-server/data \
    -v /home/jpom-server/conf:/usr/local/jpom-server/conf \
    jpomdocker/jpom

1.2.3 手动下载安装

1. 下载安装包：https://jpom.top/pages/all-downloads/
2. 解压文件
3. 服务端：
   • 目录：server-x.x.x-release
   • 启动脚本：bin/start.sh(Linux) 或 bin/start.bat(Windows)
   • 默认端口：2122
4. 插件端：
   • 目录：agent-x.x.x-release
   • 启动脚本：同上
   • 默认端口：2123

2. 使用说明

2.1 初始访问

1. 服务端启动后访问：http://服务器IP:2122
2. 默认管理员账号：admin，密码：jpom123

2.2 核心功能

项目管理

• 项目状态监控
• 控制台日志查看
• 项目文件管理
• 在线文本编辑

构建部署

• 支持 Git/SVN 仓库拉取
• 容器构建（Docker）
• SSH 方式发布
• 定时构建
• WebHook 触发构建

服务器管理

• 在线 SSH 终端
• 文件目录管理
• 命令模板执行
• Docker 容器管理
• Nginx 配置管理

监控报警

• 项目异常自动报警
• 邮件/钉钉/微信通知
• 自动尝试重启

3. API 使用文档

3.1 认证方式

所有 API 请求需携带 Header：

Authorization: Bearer {token}

3.2 常用 API 示例

获取节点列表

GET /api/node/list

项目状态查询

GET /api/project/status?nodeId={nodeId}&projectId={projectId}

触发构建

POST /api/build/trigger
{
    "id": "构建ID",
    "token": "构建令牌"
}

文件上传

POST /api/file/upload
Content-Type: multipart/form-data

4. 安装注意事项

1. 目录隔离：服务端和插件端必须安装在不同目录

2. 防火墙配置：

   # 放行端口
   firewall-cmd --add-port=2122/tcp --permanent
   firewall-cmd --add-port=2123/tcp --permanent
   firewall-cmd --reload
   

3. 环境依赖：

   • 构建项目需预装对应环境（Maven/Node等）
   • 安装后需重启服务使环境生效

4. 数据备份：

   • 重要数据位于安装目录下的data文件夹
   • 建议定期备份该目录

5. 升级注意：

   • 2.7.x 版本后不建议降级
   • 升级前请查看 CHANGELOG.md

6. 多机部署：

   • 服务端只需安装一次
   • 每台被管理的服务器都需安装插件端

【免费下载链接】Jpom 【dromara】🚀简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件 项目地址: https://gitcode.com/dromara/Jpom