83 lines
3.7 KiB
Markdown
83 lines
3.7 KiB
Markdown
部署说明（Ubuntu 24, 阿里云）
|
||
|
||
目标：把 frontend（Vite）构建为静态文件并通过 nginx 提供，后端运行在本机（端口 4000 作为示例），整个站点通过域名在非常用端口访问（示例使用 8443）。
|
||
|
||
主要思路（摘要）
|
||
- 后端：在服务器上安装 Node 20，构建并用 systemd 运行（或用 Docker/PM2）。
|
||
- 前端：在服务器或 CI 上执行 `npm run build`，将 `frontend/dist` 拷贝到 `/var/www/chat/frontend`，由 nginx 提供静态文件。
|
||
- nginx：配置反向代理 `/api` 到后端（127.0.0.1:4000），将主机监听在非标准端口（示例：8443）。
|
||
|
||
示例文件已放在 `deploy/` 目录：
|
||
- `deploy/nginx/chat.conf` - nginx server block 示例（监听 8443）。
|
||
- `deploy/systemd/chat-backend.service` - systemd 服务单元示例，假设后端位于 `/var/www/chat/backend` 并且已构建到 `dist`。
|
||
- `deploy/Dockerfile.backend` - 可选：后端 Dockerfile（多阶段构建）。
|
||
- `deploy/Dockerfile.frontend` - 可选：前端构建并用 nginx 提供的 Dockerfile。
|
||
|
||
快速按步骤（拷贝/粘贴到服务器的命令，基于 Ubuntu 24）
|
||
|
||
1) 登录服务器并切换到非 root 普通用户（假设使用 `ubuntu`）：
|
||
|
||
sudo -i
|
||
adduser --disabled-password --gecos "" chatuser || true
|
||
usermod -aG sudo chatuser
|
||
su - chatuser
|
||
|
||
2) 安装基础依赖（Node 20 + nginx + build tools）：
|
||
|
||
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
|
||
sudo apt update; sudo apt install -y nodejs nginx git build-essential
|
||
|
||
3) 拉取代码并切到项目目录：
|
||
|
||
git clone <your-repo-url> /var/www/chat
|
||
cd /var/www/chat
|
||
|
||
4) 构建后端并生成产物（示例）：
|
||
|
||
cd backend
|
||
npm ci
|
||
npm run build
|
||
# 确认可执行入口（例如 dist/index.js 或 dist/server.js），如需修改 systemd 文件请调整 ExecStart
|
||
|
||
5) 构建前端并准备静态文件：
|
||
|
||
cd ../frontend
|
||
npm ci
|
||
npm run build
|
||
sudo mkdir -p /var/www/chat/frontend
|
||
sudo rm -rf /var/www/chat/frontend/*
|
||
sudo cp -r dist/* /var/www/chat/frontend/
|
||
sudo chown -R www-data:www-data /var/www/chat/frontend
|
||
|
||
6) 配置 systemd（后端）
|
||
|
||
sudo cp deploy/systemd/chat-backend.service /etc/systemd/system/chat-backend.service
|
||
# 如果后台入口或工作目录不同，请编辑该文件
|
||
sudo systemctl daemon-reload
|
||
sudo systemctl enable --now chat-backend.service
|
||
sudo systemctl status chat-backend.service
|
||
|
||
7) 配置 nginx（监听非标准端口 8443）
|
||
|
||
sudo cp deploy/nginx/chat.conf /etc/nginx/sites-available/chat
|
||
sudo ln -sf /etc/nginx/sites-available/chat /etc/nginx/sites-enabled/chat
|
||
sudo nginx -t && sudo systemctl reload nginx
|
||
|
||
# 打开防火墙端口（如果使用 ufw）
|
||
sudo ufw allow 8443/tcp
|
||
|
||
访问方式：
|
||
- 在浏览器中访问：https://your-domain:8443/ （如果未配置 HTTPS，可以先用 http://your-domain:8443/，但浏览器可能提示不安全）
|
||
|
||
证书/HTTPS（建议）
|
||
- certbot 默认申请 HTTPS 在 80/443，如果你坚持使用非标准端口，可以申请证书然后在 nginx 上配置证书（证书本身不强制要求 443）。建议仍然把 80/443 暂时开放用于证书申请，然后可改回 8443 提供服务。
|
||
|
||
Docker 选项
|
||
- 若你偏好 Docker 部署，参见 `deploy/Dockerfile.backend` 与 `deploy/Dockerfile.frontend`。
|
||
|
||
注意事项
|
||
- systemd 的 `ExecStart` 假定后端构建后入口为 `/var/www/chat/backend/dist/index.js`，若不同请调整。
|
||
- nginx config 中 proxy 与 websocket/SSE 头部已设置，但请根据你的后端 SSE 实现确认 `proxy_buffering off;` 是否需要在特定 location 启用。
|
||
|
||
如需我直接把这些配置拷贝到服务器并启用服务，需要给出 SSH 访问方式与权限或在服务器上运行命令并把输出贴回，我可以一步步协助。
|