b0d2e629d9
- 修复页面跳转白屏闪烁问题
- 集成过渡岗位页面（岗位装配中心）
- 添加iframe全屏嵌入（教务系统、就业规划）
- 优化企业资源卡片hover分裂效果
- 添加Windows和macOS快捷部署脚本
- 更新.gitignore忽略测试文件和缓存
🤖 Generated with Claude Code
145 lines
3.1 KiB
Markdown
145 lines
3.1 KiB
Markdown
# 🚀 快捷部署指南
|
||
|
||
本项目提供了 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. 防火墙设置
|
||
|
||
---
|
||
|
||
**祝使用愉快！** 🎉
|