Linux 环境启动说明

本文说明在 Linux 服务器上如何启动本项目（联合模式与前后端分离模式）。

环境要求

Node.js >= 14（推荐 18 或 20 LTS）
可选：Python 3（仅在使用 scripts/ 下 720 云提取脚本时需要）

安装 Node（示例，以实际环境为准）：

# 使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18

# 或使用系统包管理器
# Ubuntu/Debian: sudo apt install nodejs npm
# CentOS: sudo yum install nodejs npm

方式一：联合启动（前后端同机、单端口）

适合本机或单台服务器同时提供页面和 API，访问一个端口即可。

上传项目到服务器（或 git clone），进入项目根目录：
```
cd /path/to/720yun-offline
```
使用启动脚本（推荐）：
```
chmod +x start.sh
./start.sh
```
或在当前终端前台运行：
```
bash start.sh
```
或手动执行：
```
npm install
npm start
```
默认端口 3000。修改端口可设置环境变量后再启动：
```
export PORT=8080
./start.sh
```
浏览器访问：http://服务器IP:3000（或你设置的端口）。

说明：start.sh 会先执行根目录 npm install，再执行 node server.js，同时提供静态页面和 /api 接口。

方式二：前后端分离启动

适合前端、后端分别部署（如前端 Nginx、后端 Node），或需要单独调试 API 时使用。

1. 启动后端 API

在项目根目录执行：

chmod +x start-api.sh
./start-api.sh

或手动：

cd server
npm install
npm start

默认端口以 start-api.sh 内为准（如 5599），若与联合模式同机需避免端口冲突。
修改端口：PORT=3001 ./start-api.sh 或 cd server && PORT=3001 npm start。
数据文件：server/data/store.json（自动创建）。
重要：前后端分离时，前端 api.config.json 的 apiBase 必须填后端完整地址（含端口），例如 "http://你的域名或IP:5599"，否则页面无法请求统计/弹幕等接口。

生产环境建议用 pm2 保活，例如：

cd server && npm install && PORT=5599 npx pm2 start index.js --name pano-api

2. 启动前端（静态资源）

选项 A：用脚本构建并临时预览

chmod +x start-front.sh
./start-front.sh

会执行 npm run build 生成 dist/，再用静态服务托管 dist/，默认端口 8080。
修改端口：FRONT_PORT=8080 ./start-front.sh。
此时前端与后端分离，需在 根目录 api.config.json（构建会复制到 dist）中设置 apiBase 为后端地址且端口与 start-api.sh 一致，例如后端端口 5599 则填 "http://你的域名或IP:5599"，否则页面无法请求到统计/弹幕等接口。

选项 B：部署到 Nginx

在项目根目录执行 npm run build。
将 dist/ 内所有文件拷贝到 Nginx 站点目录。
在 Nginx 中配置该目录为 root。若 API 同域并反代到后端（如 proxy_pass http://127.0.0.1:5599），则 api.config.json 的 apiBase 可留空 ""；否则必须填后端完整地址（含端口）。

脚本说明

脚本	作用
start.sh	联合启动：根目录安装依赖并启动 `server.js`，同时提供静态 + API（默认 3000）。
start-api.sh	仅启动后端：进入 `server/` 安装依赖并启动 API（默认 3000）。
start-front.sh	构建前端到 `dist/` 并启动静态服务预览（默认 8080），需自行配置 `api.config.json` 指向后端。

所有脚本均可在 Linux 下直接执行，需先 chmod +x 脚本名。

常见问题

端口被占用：修改 PORT（联合/后端）或脚本内前端端口后再启动。
无权限监听 80：使用 3000/8080 等高位端口，或用 Nginx 反代。
跨域：前后端分离且不同域时，后端已设置 CORS；可限制来源：在启动后端前设置 CORS_ORIGIN=https://你的前端域名。

4.1 KiB Raw Blame History Unescape Escape