# HZERO开源-优化版

**Repository Path**: wei_wei10/hzero-optimize

## Basic Information

- **Project Name**: HZERO开源-优化版
- **Description**: 该项目对开源版进行优化
项目可以正常编译；
项目可以正常启动；

开源版：https://github.com/open-hand/hzero
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-07-20
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HZERO 快速启动（优化版）

基于 [HZERO 开源版](https://github.com/open-hand/hzero) 的本地可运行整理：补齐启动脚本、统一开发域名与端口，方便 Windows 下快速联调登录与前后端。

> 官方产品介绍、服务清单、组件说明见原文档：[README.original.md](./README.original.md)  
> 界面截图：[SCREENSHOT.md](./SCREENSHOT.md)

---

## 目录结构

| 目录 | 说明 |
|------|------|
| `hzero-service/` | 后端微服务（Spring Cloud） |
| `hzero-front/` | 前端（React / Ant Design Pro） |
| `hzero-resource/` | 数据库脚本与初始化工具 |

---

## 环境要求

| 依赖 | 建议版本 | 说明 |
|------|----------|------|
| JDK | 1.8 | 脚本默认 `JAVA_HOME=C:\Program Files\Java\jdk1.8.0_202`，可按本机路径修改 |
| Maven | 3.6+ | 首次编译后端需要 |
| Node.js | 14+（建议 16/18） | Node 17+ 脚本已自动加 `--openssl-legacy-provider` |
| Yarn | 1.x | 前端依赖安装 |
| Docker | 任意较新版本 | 运行 MySQL、Redis |
| 内存 | ≥ 8GB | 登录精简场景约 2GB；全量服务建议 8GB+ |

---

## 5 分钟快速启动

### 1. 准备基础设施

确保本机 Docker 中 **MySQL**、**Redis** 已运行，并按 `hzero-resource` 完成库表与种子数据初始化：

```text
hzero-resource/README.md
```

简要步骤：修改 `hzero-resource/application.yml` 中的数据库连接 → 运行 `database-init.sh` → 浏览器中更新库表并导入数据。

### 2. 配置 hosts（必做）

登录联调统一使用域名 `dev.hzero.com.cn`，**不要混用** `127.0.0.1` / 局域网 IP 访问。

以**管理员身份**运行：

```bat
hzero-service\setup-hosts.bat
```

或手动在 `C:\Windows\System32\drivers\etc\hosts` 增加：

```text
127.0.0.1  dev.hzero.com.cn
```

同事连你本机服务时，把 IP 换成服务机局域网地址即可。

也可打开菜单脚本选配置项：

```bat
hzero-service\start-menu.bat
```

### 3. 启动后端（推荐：登录精简）

仅启动登录所需 5 个服务（省内存）：

```bat
cd hzero-service
start-login.bat
```

| 参数 | 含义 |
|------|------|
| （无） | 低内存模式 + 正常打包 |
| `skip` | 低内存 + 跳过 Maven（需已有 jar） |

启动的服务：`register` → `config` → `iam` → `oauth` → `gateway`  
不启：`platform` / `admin` / `swagger`

需要全量服务时：

```bat
start-all.bat
start-all.bat low          REM 低内存
start-all.bat low skip     REM 低内存且跳过打包
```

或直接用菜单：

```bat
start-menu.bat
```

### 4. 启动前端

另开一个终端：

```bat
cd hzero-front
yarn install               REM 首次
start-dev.bat
```

前端默认端口 **8002**（Eureka 占用 8000/8001）。

### 5. 访问与登录

| 入口 | 地址 |
|------|------|
| 前端 | http://dev.hzero.com.cn:8002 |
| 网关 | http://dev.hzero.com.cn:8080 |
| Eureka | http://dev.hzero.com.cn:8000 |
| OAuth 授权（浏览器测 token） | http://dev.hzero.com.cn:8080/oauth/oauth/authorize?response_type=token&client_id=localhost&redirect_uri=http://dev.hzero.com.cn:8002/workplace |

默认账号：

```text
admin / Admin@123
```

登录成功后，地址栏应出现 `#access_token=...`。

---

## 端口一览

| 服务 | 端口 |
|------|------|
| hzero-register (Eureka) | 8000（管理端口 8001） |
| hzero-front | 8002 |
| hzero-config | 8010 |
| hzero-oauth | 8020 |
| hzero-iam | 8030 |
| hzero-swagger | 8050 |
| hzero-gateway | 8080 |

各服务日志：对应目录下 `target\app.log`，同时会弹出独立控制台窗口。

---

## 常用脚本

### 后端 `hzero-service/`

| 脚本 | 用途 |
|------|------|
| `start-menu.bat` | 交互菜单：登录场景 / 全量 / hosts |
| `start-login.bat` | 标准登录联调（推荐） |
| `start-all.bat` | 启动全部核心服务 |
| `setup-hosts.bat` | 写入 `dev.hzero.com.cn` |
| `install.bat` | Maven 全量安装（首次编译） |
| 各服务 `run.bat` | 单独启动某一个服务 |

### 前端 `hzero-front/`

| 脚本 | 用途 |
|------|------|
| `start-dev.bat` | 构建 DLL 并启动开发服务器（端口 8002） |

---

## 首次编译后端（可选）

若本地尚无依赖 jar，可先执行：

```bat
cd hzero-service
install.bat
```

之后用 `start-login.bat skip` 可跳过重复打包，加快启动。

---

## 常见问题

**1. Push / 访问外网失败，提示连接 `127.0.0.1:xxxx`**  
Git 全局代理指向了未启动的本地代理。取消：

```bat
git config --global --unset http.proxy
git config --global --unset https.proxy
```

**2. 前端 Node 报 OpenSSL / webpack 错误**  
使用 `start-dev.bat`（已设置 `NODE_OPTIONS=--openssl-legacy-provider`），不要直接裸跑旧命令。

**3. 登录跳转异常 / Cookie 丢失**  
统一用 `http://dev.hzero.com.cn:...`，不要混用 `localhost`、`127.0.0.1` 和局域网 IP。

**4. 服务端口超时**  
先确认 MySQL、Redis 已起；再看各服务控制台或 `target\app.log`。

---

## 说明

- 上游开源仓库长期缺少维护，本仓库侧重 **能跑起来的本地开发体验**（脚本、hosts、端口约定）。
- 功能说明、模块文档、企业版差异等仍以官方材料与 [README.original.md](./README.original.md) 为准。
- 许可证见仓库根目录 `LICENSE`（Apache 2.0）。

## 相关链接

- [原 README（官方开源说明）](./README.original.md)
- [界面截图](./SCREENSHOT.md)
- [汉得开放平台 - HZERO 开源版文档](https://open.hand-china.com/document-center/doc/product/10002/10271?doc_id=138446&doc_code=3957)
- [上游仓库 open-hand/hzero](https://github.com/open-hand/hzero)