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. 如果提示权限问题，请使用方法二

方法二：命令行运行

# 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 提示「权限被拒绝」

解决方法:

chmod +x 启动服务器.sh

3. 手机无法访问局域网地址

检查清单:

• ✅ 手机和电脑是否连接到同一个 WiFi
• ✅ 服务器是否正在运行
• ✅ 电脑防火墙是否阻止了 8080 端口
• ✅ IP 地址是否输入正确

macOS 防火墙设置:

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

Windows 防火墙设置:

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

4. 端口 8080 被占用

解决方法: 修改 server.js 中的端口号

const PORT = 8080; // 改成其他端口，如 3000

---

🔧 高级配置

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

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

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

---

📞 技术支持

如遇到其他问题，请检查:

1. Node.js 版本: node --version (建议 v14 以上)
2. 项目文件是否完整
3. 防火墙设置

---

祝使用愉快！ 🎉