床垫睡眠监测系统 - 部署简易教程

面向零基础用户，按步骤操作即可完成部署。

一、部署前准备

1. 你需要什么

一台 Linux 电脑（Ubuntu / Debian 等，树莓派、工控机、普通 PC 均可）
能打开终端（Terminal）
有 sudo 权限（能输入密码执行管理员命令）

2. 两种部署方式怎么选

方式	适用场景	难度
有网一键部署	机器能上网，想最快装好	⭐ 最简单
离线 U 盘部署	机器不能上网，或网络不稳定	⭐⭐ 稍复杂

二、有网一键部署（推荐新手）

步骤 1：打开终端

在 Linux 桌面按 Ctrl + Alt + T 打开终端，或从菜单找到「终端」打开。

步骤 2：复制并执行下面这一行命令

整行复制，粘贴到终端，按回车：

sudo mkdir -p /opt/bed-sleep && curl -fL https://download.fisean.cn/wavemill/offline_bundle.tar.gz | sudo tar -xzf - -C /opt/bed-sleep && /opt/bed-sleep/offline_bundle/install_offline.sh

步骤 3：输入密码

提示输入密码时，输入你的 Linux 登录密码（输入时不会显示，正常输入后按回车即可）。

步骤 4：等待完成

脚本会自动下载并安装，可能需要几分钟。看到类似下面的提示就表示成功：

==========================================
  安装完成
  前端: http://localhost:5173
  后端: http://localhost:5000
  前端/后端已配置开机自启 (systemd)
==========================================

步骤 5：访问系统

在浏览器中打开：http://localhost:5173

如果是在其他电脑访问，把 localhost 换成部署机器的 IP 地址，例如：http://192.168.1.100:5173

三、离线 U 盘部署（机器不能上网时）

第一步：下载并拷贝离线包到目标机器

在有网的电脑上打开浏览器，下载离线包：
下载地址：https://download.fisean.cn/wavemill/offline_bundle.tar.gz
将下载的 offline_bundle.tar.gz 拷贝到 U 盘，再插到目标机器
在目标机器上解压（例如解压到 /opt/bed-sleep/）：
```
sudo mkdir -p /opt/bed-sleep
sudo tar -zxvf /path/to/offline_bundle.tar.gz /opt/bed-sleep
```
若 U 盘挂载在 /media/xxx/，把 /path/to/ 换成实际路径
打开终端，进入 offline_bundle 所在目录：
```
cd /opt/bed-sleep/offline_bundle
```

第二步：执行安装

执行安装脚本：
```
./install_offline.sh
```
按提示输入密码，等待安装完成

第三步：访问系统

浏览器打开：http://localhost:5173（或 http://机器IP:5173）

四、常见问题

1. 提示「Permission denied」或「权限不够」

在命令前加 sudo，例如：

sudo ./install_offline.sh

2. 提示「curl: command not found」

系统没有 curl，先安装：

sudo apt update
sudo apt install -y curl

3. 一键部署时下载很慢或失败

检查网络是否正常
可以分步执行（见 README 中的「分步执行」），先下载到本地再解压安装

4. 浏览器打不开 5173 页面

确认安装脚本已执行完成且无报错

检查服务是否在运行：

sudo systemctl status bed-sleep-frontend
sudo systemctl status bed-sleep-backend

若显示未运行，可手动启动：

sudo systemctl start bed-sleep-frontend
sudo systemctl start bed-sleep-backend

5. 其他电脑访问不了（只能本机访问）

确认防火墙放行了 5173 和 5000 端口

Ubuntu 示例：

sudo ufw allow 5173
sudo ufw allow 5000
sudo ufw reload

6. 重启后服务没起来

离线部署默认已配置开机自启。若有问题，可手动启用：

sudo systemctl enable bed-sleep-frontend bed-sleep-backend
sudo systemctl start bed-sleep-frontend bed-sleep-backend

五、访问地址速查

服务	地址	说明
前端页面	http://localhost:5173	主界面
后端 API	http://localhost:5000	接口服务
EMQX MQTT	1883	传感器数据
EMQX WebSocket	8083	网页连接

六、有网环境从源码部署（开发者）

若你有项目源码且机器有网，可按 README 中的「快速开始」手动安装依赖并启动，详见 README.md。