# zhipin-cloud-vm-env

**Repository Path**: nomenofear/zhipin-cloud-vm-env

## Basic Information

- **Project Name**: zhipin-cloud-vm-env
- **Description**: 虚拟机环境仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智聘云图 - 配套虚拟机环境

本项目提供 Docker Compose 和 Windows 虚拟机两种方式来还原课程配套环境。

## 环境要求

| 项目 | Docker Compose 方案 | Windows 虚拟机方案 |
|------|---------------------|-------------------|
| 操作系统 | Windows / macOS / Linux | Windows 10/11 64 位 |
| 内存 | 8 GB 及以上（推荐 16 GB） | 8 GB 及以上（推荐 16 GB） |
| 磁盘 | 20 GB 可用空间 | 40 GB 可用空间 |
| 前置软件 | Docker Engine 24+ 或 Docker Desktop 4+ | VMware Workstation 16+ 或 VirtualBox 6+ |

## 快速开始

### 方式一：Docker Compose（推荐）

```bash
# 1. 进入对应架构目录
cd docker-compose/amd64    # Intel CPU / Windows / 云服务器
cd docker-compose/arm64    # Mac M系列

# 2. 一键启动
docker compose up -d

# 3. 查看运行状态
docker compose ps
```

### 方式二：Windows 虚拟机

从百度网盘下载预配置虚拟机镜像，导入 VMware/VirtualBox 后启动即可。

## Docker Compose 多环境部署

项目支持开发环境和测试环境切换，通过 `docker-compose.test.yml` 覆盖文件实现。

### 环境差异

| 配置项 | 开发环境 | 测试环境 |
|---|---|---|
| Gateway 地址 | `192.168.150.1:8600` | `172.17.2.76:8600` |
| 启动命令 | `docker compose up -d` | `docker compose -f docker-compose.yml -f docker-compose.test.yml up -d` |

### 启动命令

```bash
cd docker-compose/amd64  # 或 arm64

# 开发环境（默认）
docker compose up -d

# 测试环境
docker compose -f docker-compose.yml -f docker-compose.test.yml up -d

# 仅重建 nginx（避免中断其他服务）
docker compose -f docker-compose.yml -f docker-compose.test.yml up -d nginx
```

### Nginx 域名架构

采用子域名方式区分前端应用，API 通过独立域名 `api.zhipin-cloud.com` 代理到网关（8600）：

| 域名 | 用途 | 访问路径 |
|---|---|---|
| `recruit.zhipin-cloud.com` | 招聘端（前端 SPA） | nginx → 静态文件 |
| `job.zhipin-cloud.com` | 应聘端（前端 SPA） | nginx → 静态文件 |
| `admin.zhipin-cloud.com` | 管理端（前端 SPA） | nginx → 静态文件 |
| `api.zhipin-cloud.com` | API 网关代理 | nginx → gateway:8600 |
| `xxl-job.zhipin-cloud.com` | XXL-Job 控制台 | nginx → xxl-job:8080 |

### 本地开发 hosts 配置

由于使用子域名，本机需配置 hosts 文件（`C:\Windows\System32\drivers\etc\hosts` 或 `/etc/hosts`）：

```ini
# 开发环境（VM: 192.168.150.68）
192.168.150.68 api.zhipin-cloud.com
192.168.150.68 recruit.zhipin-cloud.com
192.168.150.68 job.zhipin-cloud.com
192.168.150.68 admin.zhipin-cloud.com
192.168.150.68 xxl-job.zhipin-cloud.com
```

> **提示**：Chrome 浏览器默认自动升级 HTTP → HTTPS，请在地址栏显式输入 `http://api.zhipin-cloud.com/` 而非省略协议前缀。

### 前端 API 调用

所有前端项目统一通过 `api.zhipin-cloud.com` 发起 API 请求：

```js
const API_BASE = '//api.zhipin-cloud.com'
fetch(`${API_BASE}/recruiter/api/v1/user/info`)
```

### 跨域说明

- 前端和 API 使用**不同子域名**（跨域）
- 网关已配置全局 CORS（`allowed-origin-patterns: "*"` + `allow-credentials: true`）
- 请求需携带 `Authorization` 头，网关 OPTIONS 预检已放行

## 项目结构

```
zhipin-cloud-vm-env/
├── docker-compose/              # Docker Compose 部署方案
│   ├── amd64/                   # Intel CPU / Windows / 云服务器
│   │   └── docker-compose.yml
│   ├── arm64/                   # Mac M系列
│   │   └── docker-compose.yml
│   ├── shared/                  # 共享配置和数据（两个架构共用）
│   │   ├── mysql/               # MySQL 配置和初始化 SQL
│   │   ├── nacos/               # Nacos 数据和日志
│   │   ├── nacos-config/        # Nacos 共享配置模板
│   │   ├── nginx/               # Nginx 配置和前端页面
│   │   ├── elasticsearch/       # Elasticsearch 配置和插件
│   │   ├── rabbitmq/            # RabbitMQ 数据
│   │   ├── redis/               # Redis 配置
│   │   └── xxl-job/             # XXL-Job 日志
│   └── README.md                # Docker Compose 详细教程
├── windows-vm/                  # Windows 虚拟机方案
│   └── README.md                # 虚拟机下载和使用说明
├── images/                      # Docker 离线镜像包说明
│   └── README.md                # 镜像下载地址和清单
├── scripts/                     # 辅助脚本
│   └── check-env.sh             # 环境检测脚本
└── README.md                    # 本文件
```

## 选择指引

| 你的平台 | 推荐使用方式 | 使用目录 |
|----------|-------------|----------|
| Windows | Docker Compose 或 虚拟机 | `docker-compose/amd64/` 或 `windows-vm/` |
| Intel Mac | Docker Compose | `docker-compose/amd64/` |
| Mac M1/M2/M3/M4 | Docker Compose | `docker-compose/arm64/` |
| 云服务器 (Linux) | Docker Compose | `docker-compose/amd64/` |

## 服务列表

| 服务 | 状态 |
|------|------|
| MySQL | ✅ 已配置 |
| Nacos | ✅ 已配置 |
| RabbitMQ | ✅ 已配置 |
| Nginx | ✅ 已配置 |
| Elasticsearch | ✅ 已配置 |
| Kafka | ✅ 已配置 |
| Redis | ✅ 已配置 |
| XXL-Job | ✅ 已配置 |
| Gogs | ✅ 已配置 |

## 端口汇总

| 服务 | 端口 | 用途 |
|------|------|------|
| MySQL | 3306 | 数据库连接 |
| Nacos | 8848 | 控制台（HTTP） |
| Nacos | 9848 | gRPC 通信 |
| RabbitMQ | 5672 | AMQP 协议端口 |
| RabbitMQ | 15672 | 管理界面（HTTP） |
| Elasticsearch | 9200 | REST API |
| Elasticsearch | 9300 | 节点通信 |
| Kafka | 9092 | Broker 内部通信 |
| Kafka | 9094 | Broker 外部访问 |
| Redis | 6379 | 数据库连接 |
| XXL-Job | 28080 | 管理界面 |
| Gogs | 10880 | Web 控制台 |
| Gogs | 10022 | Git SSH |
| Nginx | 80 | 静态资源 / XXL-Job 代理 |

## 默认账号密码

| 服务 | 用户名 | 密码 |
|------|--------|------|
| MySQL | root | 123 |
| RabbitMQ | itheima | 123321 |
| Redis | - | 123321 |
| Nacos 控制台 | nacos | nacos |
| XXL-Job 控制台 | admin | 123456 |

## 虚拟机信息

| 项目 | 值 |
|------|------|
| IP 地址 | 192.168.150.68 |
| Nacos 命名空间 | ecae68ba-7b43-4473-a980-4ddeb6157bdc |
| Nacos 配置组 | SHARED_GROUP |

## 相关文档

- [Docker Compose 部署教程](docker-compose/README.md)
- [Windows 虚拟机方案](windows-vm/README.md)
- [离线镜像下载](images/README.md)