VPN 服务完整技术栈与节点自动注册文档
VPN 服务完整技术栈与节点自动注册文档
项目定位：VPN 服务（官网 + 后端 + 多地区节点）
目标用户：约 1 万注册用户起步
开发模式：个人开发
更新时间：2026 年 11 月
1. 整体架构
| 层级 | 技术 | 部署位置 | 说明 |
|---|---|---|---|
| 官网前端 | Next.js 15 | Vercel 或自建服务器 | SEO 友好，落地页 + 博客 + 用户中心 |
| 后端 API | FastAPI | ByteVirt 香港 | 用户认证、套餐、节点管理 |
| 数据库 | PostgreSQL | 独立服务器（香港） | 用户数据、订单、节点信息 |
| 缓存 | Redis | 独立服务器（香港） | 会话、限流、热点缓存 |
| 节点服务器 | 多地区 VPS | 香港 / 新加坡 / 日本 / 美国 | 实际 VPN 连接节点 |
2. 前端技术栈（VPN 官网）
核心目标：SEO 友好、加载快、易维护
| 类别 | 技术 | 版本建议 | 说明 |
|---|---|---|---|
| 框架 | Next.js | 15.x | App Router，支持 SSR / SSG |
| 语言 | TypeScript | 5.x | 类型安全，长期维护 |
| 样式 | Tailwind CSS | 3.x / 4.x | 快速开发落地页 |
| UI 组件 | shadcn/ui + Radix | 最新 | 高质量、可定制组件 |
| 内容 | MDX | - | 博客、帮助文档 |
| 状态管理 | Zustand 或 React Query | 最新 | 按需使用 |
| 部署 | Vercel（推荐） | - | 自动优化 + 全球 CDN |
为什么选这个组合：
- SEO 表现优秀（服务端渲染）
- 开发效率高，适合个人
- 生态成熟，资料丰富
- 后期可平滑扩展用户中心、支付等功能
3. 后端技术栈
核心目标：稳定、异步、长期可维护
3.1 核心依赖（推荐固定版本）
# 核心框架
fastapi==0.115.0
uvicorn[standard]==0.32.0
gunicorn==23.0.0
pydantic==2.9.2
pydantic-settings==2.6.0
# 数据库
sqlalchemy==2.0.36
asyncpg==0.30.0
alembic==1.14.0
# 认证
python-jose[cryptography]==3.3.0
passlib[bcrypt]==1.7.4
bcrypt==4.2.0
# 缓存 & 工具
redis==5.2.0
httpx==0.27.2
python-dotenv==1.0.1
lijianguo