fix:优化启动配置

This commit is contained in:
Daniel
2026-03-07 23:47:29 +08:00
parent c3d219efc1
commit 7db497bc94
6 changed files with 219 additions and 4 deletions

View File

@@ -74,7 +74,19 @@ npm start
浏览器访问 **http://localhost:3000**,会自动加载 `config.json` 中的立方体六面图(`image/mobile_*.jpg`)。
服务端会创建 **`server/data/store.json`**(纯 JSON 存储,无原生依赖),用于存储:**累积播放、实时在看、点赞数、分享数、留言(弹幕)**。留言以弹幕形式在画面上方滚动播放。
### 2. 构建出站目录(部署用
### 2. Linux 启动脚本(推荐
在 Linux 服务器上可使用根目录下的 shell 脚本一键启动,详见 **[docs/Linux启动说明.md](docs/Linux启动说明.md)**。
| 脚本 | 说明 |
|------|------|
| `./start.sh` | 联合启动:静态 + API单端口默认 3000 |
| `./start-api.sh` | 仅启动后端 API前后端分离时用 |
| `./start-front.sh` | 构建前端并启动静态预览(默认 8080 |
首次使用需执行 `chmod +x start.sh start-api.sh start-front.sh`。修改端口可设置环境变量 `PORT``FRONT_PORT`
### 3. 构建出站目录(部署用)
```bash
npm run build
@@ -82,7 +94,7 @@ npm run build
会将 `index.html``config.json``lib/``image/` 复制到 **`dist/`**。若需保留统计与弹幕功能,需将 **Node 服务server.js + db.js + data/** 一并部署;仅部署静态 `dist/` 时,前端会请求 `/api` 失败,观看/点赞/分享/留言不落库。
### 3. 预览构建结果
### 4. 预览构建结果
```bash
npm run preview
@@ -113,7 +125,7 @@ npm run preview
若使用单张 2:1 全景图,可改为 `"type": "equirectangular"``"panorama": "panorama/panorama.jpg"`
### 5. 其它方式起 HTTP 服务
### 6. 其它方式起 HTTP 服务
因浏览器安全限制,不能直接用 `file://` 打开。除 `npm start` 外也可:
@@ -129,7 +141,7 @@ python3 -m http.server 8080
npx serve -p 8080
```
### 6. 离线部署到其它机器
### 7. 离线部署到其它机器
将整个项目(或仅 `dist/`)拷贝到 U 盘或内网服务器,在目标机器上执行 `npm start` 或部署 `dist/` 到 Web 服务器即可,无需外网。