# vagrant_create_vm

**Repository Path**: wwkwesley/vagrant_create_vm

## Basic Information

- **Project Name**: vagrant_create_vm
- **Description**: 一个基于Vagrant的自动化虚拟机创建工具，简化开发环境搭建，支持多平台和自定义配置，为开发者提供高效便捷的虚拟化解决方案。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 虚拟机

## README

# VirtualBox 和 Vagrant 快速创建虚拟机集群

一个简单易用的一键式虚拟机集群创建工具，帮助小白用户快速搭建任意节点数量的 Kubernetes 测试环境。

## 🎯 功能特点

- **一键创建** - 双击脚本即可创建虚拟机集群
- **高度可配置** - 支持自定义节点数、IP地址、内存、CPU等参数
- **零依赖** - 自动检测并配置 VirtualBox 和 Vagrant
- **环境准备** - 自动配置防火墙、SELinux、SSH等系统设置
- **中文交互** - 友好的中文提示界面

## 📋 前提条件

在运行本脚本之前，请确保已安装以下软件：

### 1. 安装 VirtualBox
- 下载地址：https://www.virtualbox.org/wiki/Downloads
- 推荐版本：7.x 或更高

### 2. 安装 Vagrant
- 下载地址：https://developer.hashicorp.com/vagrant/downloads
- 推荐版本：2.4.x 或更高

## 🚀 使用方法

### 方式一：使用 Bat 脚本（一键创建）

#### 步骤 1：下载脚本
将以下文件下载到本地同一目录（推荐 `C:\vagrant`）：
- `start-all.bat` - 主脚本（双击运行）
- `create-vagrantfile.ps1` - 辅助脚本
- `gen-vagrant.ps1` - 辅助脚本

#### 步骤 2：运行脚本
双击 `start-all.bat` 文件，会自动打开命令行窗口

#### 步骤 3：环境检测
脚本会自动检测 VirtualBox 和 Vagrant 是否安装：

```
============================================================
  Welcome to VirtualBox and Vagrant Cluster Creator
        Create any number of VM nodes with one click
============================================================
Author: weiwenke
Email:  weiwk01@gmail.com
Docs:   https://www.yuque.com/wwk_sz/wc9hse/latr5qg6cx2vac4y
============================================================
Step 1: Checking Environment...
[OK] VirtualBox found
[OK] Vagrant found

Environment check completed successfully!
Press Enter to continue...
```

#### 步骤 4：配置参数
根据提示输入配置参数（直接按回车使用默认值）：

```
============================================================
Step 2: Configuration
============================================================

Enter total number of nodes (default: 5, e.g. 5, 8):
Enter IP prefix (default: 10.0.0):
Enter starting IP (default: 101):
Enter memory per node (MB) (default: 4096):
Enter CPUs per node (default: 4):
Enter root password for VMs (default: 123456):

Mode Selection:
  [A] Auto - Smart mode (only create missing nodes)
  [D] Destroy - Destroy all existing and rebuild

Enter mode [A/D] (default: A):

============================================================
Summary:
  Total nodes to create: 5
  IP Range: 10.0.0.101 - 10.0.0.105
  Memory:   4096 MB/node
  CPUs:     4/node
  Root password: 123456
  Mode:     A
============================================================

Press Enter to start...
```

#### 步骤 5：等待创建完成
脚本会自动创建 Vagrantfile 并启动虚拟机：

```
Step 3: Creating Vagrantfile...
[OK] Vagrantfile created

Step 4: Starting VMs...
Bringing machine 'node1' up with 'virtualbox' provider...
Bringing machine 'node2' up with 'virtualbox' provider...
...
============================================================
Complete!
============================================================
2 VMs created successfully!
```

### 方式二：手动配置（高级用户）

如果不想使用 Bat 脚本，可以解压 `vagrant.zip` 自行修改相关配置参数，然后通过 `vagrant up` 方式启动集群创建。

#### 步骤 1：解压文件
解压 `vagrant.zip` 到指定目录

#### 步骤 2：修改配置
编辑 `Vagrantfile` 文件，根据需要修改以下参数：
- `N` - 节点数量
- `IP_PREFIX` - IP 地址前缀
- `IP_START` - 起始 IP
- `MEMORY` - 每节点内存（MB）
- `CPUS` - 每节点 CPU 核数

#### 步骤 3：启动集群
```bash
vagrant up
```

## ⚙️ 配置参数说明

| 参数 | 说明 | 默认值 | 示例 |
|------|------|--------|------|
| **Nodes** | 虚拟机节点数量 | 5 | 2-10 |
| **IP Prefix** | IP地址前缀 | 10.0.0 | 192.168.1 |
| **Starting IP** | 起始IP地址 | 101 | 1 |
| **Memory** | 每节点内存大小（MB） | 4096 | 2048 |
| **CPUs** | 每节点CPU核数 | 4 | 2 |
| **Root Password** | 虚拟机的root密码 | 123456 | 自定义密码 |
| **Mode** | 创建模式 [A=Auto / D=Destroy] | A | A/D |

## 🔌 连接方式

### 使用 Vagrant 连接
```bash
# 连接到 node1
vagrant ssh node1

# 连接到 node2
vagrant ssh node2
```

### 使用 SSH 直接连接
```bash
# 使用 root 用户连接（密码：vagrant）
ssh root@10.0.0.101
```

### 使用密码登录
- **用户名**: `root`
- **密码**: `vagrant`

## 📁 项目结构

```
C:\vagrant\
├── start-all.bat           # 主脚本（双击运行）
├── create-vagrantfile.ps1  # 辅助脚本
├── gen-vagrant.ps1        # 辅助脚本
├── Vagrantfile            # 配置文件（可手动编辑）
├── vagrant.zip            # 完整包（解压后可直接用 vagrant up）
└── README.md              # 说明文档
```

## 📚 参考文档

完整的使用文档和教程：https://www.yuque.com/wwk_sz/wc9hse/latr5qg6cx2vac4y

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License

## 📧 联系方式

- **作者**: weiwenke
- **邮箱**: weiwk01@gmail.com
- **文档**: https://www.yuque.com/wwk_sz/wc9hse/latr5qg6cx2vac4y