部署方案(三选一)
NodeAuth 采用前后端分离的现代化架构,支持极其灵活的部署方案。您可以选择白嫖 Cloudflare 的免费额度实现零成本托管,也可以在私有云(NAS/自有服务器)中通过 Docker 实现完全的数据主权。
🛠️ 部署方案选择
| 场景 | 推荐方案 | 优势 | 难度 |
|---|---|---|---|
| 新手/零成本 | Cloudflare Worker | 0 成本、全球加速、免维护 | ⭐ |
| 数据主权/内网 | Docker 私有化部署 | 数据物理隔离、断网可用 | ⭐⭐ |
| 自动化/持续集成 | GitHub Action | 自动同步代码、版本追溯 | ⭐⭐⭐ |
📖 详细指南
以下是分章节的详细操作手册,建议按照顺序阅读。
1. 核心前置准备
无论选择哪种部署方式,这都是必须完成的第一步。
- 环境变量配置指南:包含 7 大 OAuth 登录平台及数据库核心密钥的详细说明。
2. 托管部署 (Cloudflare 生态)
- Cloudflare Worker (推荐):通过 Wrangler 或网页版一键部署,利用 D1 数据库实现高性能存储。
- GitHub Action 自动化:开发者推荐。每当你提交代码,GitHub 都会自动帮您完成部署并同步数据库。
3. 私有化部署 (Docker 容器)
适用于 NAS、小主机、VPS 或 K8s 环境。
- Docker 部署手册:支持 MySQL、PostgreSQL 及 SQLite 三大数据库引擎。
4. 初始化与维护
TIP
首次部署建议:如果您是个人使用,最推荐 Cloudflare Worker。它不仅完全免费,且得益于 Cloudflare 的全球边缘节点,能够为您提供极致的动态码生成速度。