devops 8 分钟 2026-04-28
GitHub Pages 与 Render API 的全栈部署边界
理解静态前端和动态后端的部署边界,以及如何实现 API Mode 和 Static Demo Mode。
部署GitHub PagesRenderAPI
## GitHub Pages 限制
GitHub Pages 只能托管静态文件,不能运行 Node.js 后端。
## 解决方案
1. 前端部署到 GitHub Pages
2. 后端部署到 Render
3. 前端通过 PUBLIC_API_BASE_URL 连接后端
## API Mode vs Static Demo Mode
- API Mode: 调用真实后端 API
- Static Demo Mode: 使用本地规则解析
## 经验
1. 不要把后端逻辑写死在前端
2. 始终提供 fallback
3. 明确告诉用户当前模式