# server-test-webapp

**Repository Path**: netbuffer/server-test-webapp

## Basic Information

- **Project Name**: server-test-webapp
- **Description**: 服务器负载均衡测试，docker下部署多应用实例测试，k8s下多应用实例测试
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://hub.docker.com/repository/docker/javawiki/server-test-webapp
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-04-10
- **Last Updated**: 2026-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Docker, Server

## README

# 🖥️ server-test-webapp

> 轻量级服务器诊断与 IO 测试工具，基于 **Spring Boot 4.1.0** + **Java 21** 构建。

适用于快速验证服务器环境、网络连通性、文件系统 IO 能力以及运行时信息采集。

## ✨ 特性

- 📝 文件读写测试
- 💾 磁盘空间探测
- 🔧 系统属性 / 环境变量查询
- 🌐 HTTP 请求 Dump（含公网 IP）
- ⏱️ 模拟耗时任务
- 🏥 Spring Boot Actuator 健康检查与信息端点

## 🚀 快速开始

### 📥 下载构建产物

前往 [GitHub Releases](../../releases) 页面下载最新的 `server-test-webapp.jar`。

### ▶️ 直接运行

```bash
java -jar server-test-webapp.jar
```

应用默认监听 **9800** 端口，可通过环境变量 `STW_SERVER_PORT` 修改。

### 🐳 Docker 运行

```bash
docker run -it --rm -p 9800:9800 javawiki/server-test-webapp:2.0.0
```

自定义 JVM 参数和时区：

```bash
docker run -it --rm -p 9800:9800 \
  -e TZ=Asia/Shanghai \
  -e JAVA_OPTS="-XX:+PrintCommandLineFlags" \
  javawiki/server-test-webapp:2.0.0
```

### 🐙 Docker Compose

```bash
docker compose up -d
```

## 📡 API 接口

| 接口 | 说明 |
|------|------|
| `GET /server/io/write?path=&message=` | 📝 写入文件 |
| `GET /server/io/read?path=` | 📖 读取文件 |
| `GET /server/io/diskspace?path=` | 💾 磁盘空间 |
| `GET /server/info/properties` | 🔧 系统属性 |
| `GET /server/info/env` | 🌍 环境变量 |
| `GET /server/info/getProperty?key=` | 🔍 查询单个属性 |
| `GET /server/info/getActiveProfiles` | 🏷️ 当前激活的 Profiles |
| `GET /server/info/getDefaultProfiles` | 📋 默认 Profiles |
| `GET /server/info/request/dump` | 📋 请求详情 Dump |
| `GET /task/sleep?sleep=60` | ⏱️ 模拟耗时任务（秒） |
| `GET /actuator` | 🏥 Actuator 端点索引 |
| `GET /actuator/health` | 💚 健康检查 |
| `GET /actuator/info` | ℹ️ 应用信息 |

## 🔨 构建

项目使用 [Dragonwell JDK 21](https://github.com/dragonwell-project/dragonwell21) 构建，推荐通过 GitHub Actions 自动完成。

```bash
mvn clean package -DskipTests
```

构建产物位于 `target/server-test-webapp.jar`。

## 🔄 CI/CD

推送至 `master` / `main` 分支或创建 `v*` 标签时，GitHub Actions 将自动：

1. 🐉 使用 `alibabadragonwell/dragonwell:21-ubuntu` 镜像编译打包
2. 📦 上传构建产物（可在 Actions 页面下载）
3. 🏷️ 创建 Release 时自动发布 jar 包到 GitHub Releases

手动触发 Release：

```bash
git tag v2.0.0 && git push origin v2.0.0
```

## ⚙️ 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `STW_SERVER_PORT` | `9800` | 服务监听端口 |
| `APP_VERSION` | `v1.0.0` | 应用版本标识 |
| `JAVA_OPTS` | - | JVM 启动参数 |
| `SPRING_PROFILES_ACTIVE` | - | 激活的 Spring Profile |

## 🧰 技术栈

- ☕ Java 21 (Dragonwell)
- 🍃 Spring Boot 4.1.0
- 🌐 Spring Web MVC
- 🏥 Spring Boot Actuator
- 🧅 Lombok
- 🐳 Docker & Docker Compose