DEPLOY.md 1.7 KB

部署指南

scp -r dist/* [email protected]:/usr/share/nginx/aiorz-webar/

构建静态资源

项目已经构建完成,静态文件位于 dist/ 目录。

Nginx 部署步骤

1. 复制文件到服务器

dist/ 目录下的所有文件复制到服务器的目标目录,例如:

# 在服务器上创建目录
sudo mkdir -p /var/www/aiorz-webar

# 复制文件(从本地执行)
scp -r dist/* user@your-server:/var/www/aiorz-webar/

2. 配置 Nginx

编辑或创建 Nginx 配置文件:

sudo nano /etc/nginx/sites-available/aiorz-webar

使用项目根目录下的 nginx.conf.example 作为参考,修改以下内容:

  • server_name: 您的域名或 IP 地址
  • root: dist 目录的实际路径(例如 /var/www/aiorz-webar

3. 启用站点

# 创建符号链接
sudo ln -s /etc/nginx/sites-available/aiorz-webar /etc/nginx/sites-enabled/

# 测试配置
sudo nginx -t

# 重启 Nginx
sudo systemctl restart nginx

4. 设置权限

确保 Nginx 可以读取文件:

sudo chown -R www-data:www-data /var/www/aiorz-webar
sudo chmod -R 755 /var/www/aiorz-webar

HTTPS 配置(可选但推荐)

使用 Let's Encrypt 配置 HTTPS:

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

验证部署

访问您的域名或 IP 地址,应该能看到 AIORZ WebAR 页面正常运行。

注意事项

  1. 外部资源: 项目使用了 CDN 加载 Three.js 和 MediaPipe,确保服务器可以访问这些外部资源
  2. 摄像头权限: 如果使用摄像头功能,需要 HTTPS 连接(localhost 除外)
  3. 防火墙: 确保防火墙允许 80 和 443 端口