DDCZ/快捷部署说明.md

# 🚀 快捷部署指南

本项目提供了 Windows 和 macOS 的一键启动脚本，方便快速部署到局域网。

---

## 📦 前置要求

### 必须安装 Node.js

- **macOS**:
  - 官方下载: https://nodejs.org/
  - Homebrew 安装: `brew install node`

- **Windows**:
  - 官方下载: https://nodejs.org/
  - 建议下载 LTS（长期支持）版本

---

## 🍎 macOS / Linux 使用方法

### 方法一：双击运行（推荐）
1. 找到项目文件夹中的 `启动服务器.sh`
2. **双击**运行（系统会自动使用终端打开）
3. 如果提示权限问题，请使用方法二

### 方法二：命令行运行
```bash
# 1. 打开终端（Terminal）
# 2. 进入项目目录
cd /Users/apple/Documents/cursor/三合一页面

# 3. 运行脚本
./启动服务器.sh
```

### 方法三：直接拖拽
1. 打开终端（Terminal）
2. 拖拽 `启动服务器.sh` 到终端窗口
3. 按回车

---

## 🪟 Windows 使用方法

### 方法一：双击运行（推荐）
1. 找到项目文件夹中的 `启动服务器.bat`
2. **双击**运行
3. 会自动打开命令提示符窗口

### 方法二：右键管理员运行（可选）
1. 右键点击 `启动服务器.bat`
2. 选择「以管理员身份运行」
3. 点击「是」允许运行

---

## 📱 如何访问

脚本启动后，会显示访问地址：

```
📍 本机访问: http://localhost:8080
📍 局域网访问: http://192.168.2.9:8080
```

### 本机访问
- 在启动服务器的电脑上打开浏览器
- 输入: `http://localhost:8080`

### 手机/平板访问
1. 确保设备连接到**同一个 WiFi**
2. 打开浏览器
3. 输入局域网地址（如 `http://192.168.2.9:8080`）

---

## ⏹️ 如何停止服务器

- **macOS / Linux**: 按 `Ctrl + C`
- **Windows**: 按 `Ctrl + C` 或直接关闭窗口

---

## ❓ 常见问题

### 1. 提示「找不到 Node.js」
**原因**: 未安装 Node.js
**解决**: 访问 https://nodejs.org/ 下载安装

### 2. macOS 提示「权限被拒绝」
**解决方法**:
```bash
chmod +x 启动服务器.sh
```

### 3. 手机无法访问局域网地址
**检查清单**:
- ✅ 手机和电脑是否连接到同一个 WiFi
- ✅ 服务器是否正在运行
- ✅ 电脑防火墙是否阻止了 8080 端口
- ✅ IP 地址是否输入正确

**macOS 防火墙设置**:
1. 系统偏好设置 → 安全性与隐私 → 防火墙
2. 点击「防火墙选项」
3. 确保允许 Node.js 的网络连接

**Windows 防火墙设置**:
1. 控制面板 → Windows Defender 防火墙
2. 高级设置 → 入站规则
3. 新建规则，允许端口 8080

### 4. 端口 8080 被占用
**解决方法**: 修改 `server.js` 中的端口号
```javascript
const PORT = 8080; // 改成其他端口，如 3000
```

---

## 🔧 高级配置

如需修改端口或其他配置，请编辑 `server.js` 文件:

```javascript
const PORT = 8080; // 修改端口号
```

修改后重新运行启动脚本即可。

---

## 📞 技术支持

如遇到其他问题，请检查:
1. Node.js 版本: `node --version` (建议 v14 以上)
2. 项目文件是否完整
3. 防火墙设置

---

**祝使用愉快！** 🎉