部署静态网站或 React 应用
- 在本地构建 React 应用或其他静态网站,再通过轻量的 NGINX 镜像提供构建后的文件。
- 这样可以避免在 CapRover 服务器上安装构建依赖。
- 本示例使用 Vite 常见的
dist输出目录。如果项目生成的是build,请相应修改路径。
-
在项目中运行
npm ci && npm run build,确认生成了dist/index.html。 -
在项目根目录创建
Dockerfile:FROM nginx:stable-alpineCOPY dist/ /usr/share/nginx/html/ -
在同一目录创建
captain-definition文件,内容为{"schemaVersion":2,"dockerfilePath":"./Dockerfile"}。 -
将 Dockerfile、Captain Definition 和构建产物打包,然后部署:
tar -cf deploy.tar captain-definition Dockerfile distcaprover deploy --tarFile ./deploy.tar先在 CapRover 中创建 Web 应用,CLI 提示时选择该应用。也可以在应用的 Deployment 标签页上传
deploy.tar。将 Container HTTP Port 设置为80。 -
访问应用的 HTTP 地址,然后启用 HTTPS 并验证公网域名。每次部署新版本时,都要重新构建并打包。
- CLI 默认的 Git 部署使用
git archive,不会包含未提交或被 Git 忽略的文件。 - 构建产物通常位于
.gitignore中,因此请使用上面的 tar 部署方式。直接运行caprover deploy可能遗漏这些构建产物,建议显式传入--tarFile。
如果前端使用客户端路由,例如 /settings,请在项目根目录创建如下 nginx.conf,确保刷新页面时能正确加载应用:
server {
listen 80;
root /usr/share/nginx/html;
index index.html;
location / { try_files $uri $uri/ /index.html; }
}
在 Dockerfile 中加入 COPY nginx.conf /etc/nginx/conf.d/default.conf,并将 nginx.conf 添加到上面的 tar -cf 命令中,然后重新构建并部署。不要将私密凭据放进构建时的变量,因为编译后的 JavaScript 对外公开。如果应用需要后端 API,请单独部署后端,并让前端访问它的 HTTPS URL。