feat: 完善项目功能和部署脚本
- 修复页面跳转白屏闪烁问题
- 集成过渡岗位页面(岗位装配中心)
- 添加iframe全屏嵌入(教务系统、就业规划)
- 优化企业资源卡片hover分裂效果
- 添加Windows和macOS快捷部署脚本
- 更新.gitignore忽略测试文件和缓存
🤖 Generated with Claude Code
This commit is contained in:
144
快捷部署说明.md
Normal file
144
快捷部署说明.md
Normal file
@@ -0,0 +1,144 @@
|
||||
# 🚀 快捷部署指南
|
||||
|
||||
本项目提供了 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. 防火墙设置
|
||||
|
||||
---
|
||||
|
||||
**祝使用愉快!** 🎉
|
||||
Reference in New Issue
Block a user