mirror of
https://github.com/patdelphi/suanming.git
synced 2026-02-28 05:33:11 +08:00
添加Koyeb部署配置和文档
This commit is contained in:
8
.gitignore
vendored
8
.gitignore
vendored
@@ -47,10 +47,4 @@ temp/
|
||||
*.ntvs*
|
||||
*.njsproj
|
||||
*.sln
|
||||
*.sw?
|
||||
|
||||
# Database files (SQLite)
|
||||
*.db
|
||||
*.db-shm
|
||||
*.db-wal
|
||||
numerology.db*
|
||||
*.sw?
|
||||
31
.koyeb/koyeb.yaml
Normal file
31
.koyeb/koyeb.yaml
Normal file
@@ -0,0 +1,31 @@
|
||||
# Koyeb部署配置文件
|
||||
name: suanming-app
|
||||
|
||||
services:
|
||||
- name: suanming-backend
|
||||
type: web
|
||||
git:
|
||||
branch: master
|
||||
build_command: npm ci
|
||||
run_command: npm start
|
||||
instance_type: nano
|
||||
ports:
|
||||
- port: 8000
|
||||
protocol: http
|
||||
env:
|
||||
- key: NODE_ENV
|
||||
value: production
|
||||
- key: PORT
|
||||
value: "8000"
|
||||
volumes:
|
||||
- name: sqlite-data
|
||||
mount_path: /app/data
|
||||
size: 1GB
|
||||
health_check:
|
||||
http:
|
||||
path: /api/health
|
||||
port: 8000
|
||||
initial_delay_seconds: 30
|
||||
period_seconds: 10
|
||||
timeout_seconds: 5
|
||||
failure_threshold: 3
|
||||
27
Dockerfile
Normal file
27
Dockerfile
Normal file
@@ -0,0 +1,27 @@
|
||||
# 使用官方Node.js运行时作为基础镜像
|
||||
FROM node:18-alpine
|
||||
|
||||
# 设置工作目录
|
||||
WORKDIR /app
|
||||
|
||||
# 复制package.json和package-lock.json
|
||||
COPY package*.json ./
|
||||
|
||||
# 安装依赖
|
||||
RUN npm ci --only=production
|
||||
|
||||
# 复制应用代码
|
||||
COPY . .
|
||||
|
||||
# 创建数据目录用于SQLite数据库
|
||||
RUN mkdir -p /app/data
|
||||
|
||||
# 设置环境变量
|
||||
ENV NODE_ENV=production
|
||||
ENV PORT=8000
|
||||
|
||||
# 暴露端口
|
||||
EXPOSE 8000
|
||||
|
||||
# 初始化数据库并启动应用
|
||||
CMD ["sh", "-c", "npm run db:init && npm start"]
|
||||
161
KOYEB_DEPLOYMENT.md
Normal file
161
KOYEB_DEPLOYMENT.md
Normal file
@@ -0,0 +1,161 @@
|
||||
# Koyeb 部署指南
|
||||
|
||||
本指南将帮助您将三算命项目部署到 Koyeb 平台。
|
||||
|
||||
## 🚀 部署步骤
|
||||
|
||||
### 1. 准备工作
|
||||
|
||||
确保您的代码已推送到 GitHub 仓库的 `master` 分支。
|
||||
|
||||
### 2. 注册 Koyeb 账号
|
||||
|
||||
1. 访问 [Koyeb官网](https://www.koyeb.com/)
|
||||
2. 注册免费账号
|
||||
3. 验证邮箱
|
||||
|
||||
### 3. 创建新应用
|
||||
|
||||
1. 登录 Koyeb 控制台
|
||||
2. 点击 "Create App"
|
||||
3. 选择 "GitHub" 作为部署源
|
||||
4. 授权 Koyeb 访问您的 GitHub 仓库
|
||||
5. 选择您的项目仓库
|
||||
6. 选择 `master` 分支
|
||||
|
||||
### 4. 配置部署设置
|
||||
|
||||
#### 基本设置
|
||||
- **App Name**: `suanming-app`(或您喜欢的名称)
|
||||
- **Service Name**: `suanming-backend`
|
||||
- **Instance Type**: `Nano` (免费套餐)
|
||||
- **Port**: `8000`
|
||||
|
||||
#### 构建设置
|
||||
- **Build Command**: `npm ci`
|
||||
- **Run Command**: `npm start`
|
||||
|
||||
#### 环境变量
|
||||
在 Koyeb 控制台中添加以下环境变量:
|
||||
|
||||
```
|
||||
NODE_ENV=production
|
||||
PORT=8000
|
||||
JWT_SECRET=your-super-secret-jwt-key-here
|
||||
```
|
||||
|
||||
**重要**: 请将 `JWT_SECRET` 替换为一个安全的随机字符串!
|
||||
|
||||
#### 持久化存储
|
||||
1. 在 "Volumes" 部分添加存储卷
|
||||
2. **Name**: `sqlite-data`
|
||||
3. **Mount Path**: `/app/data`
|
||||
4. **Size**: `1GB`
|
||||
|
||||
### 5. 部署应用
|
||||
|
||||
1. 检查所有配置
|
||||
2. 点击 "Deploy"
|
||||
3. 等待部署完成(通常需要 3-5 分钟)
|
||||
|
||||
### 6. 获取应用URL
|
||||
|
||||
部署完成后,Koyeb 会提供一个类似这样的URL:
|
||||
```
|
||||
https://your-app-name-your-org.koyeb.app
|
||||
```
|
||||
|
||||
### 7. 更新前端配置
|
||||
|
||||
1. 复制您的 Koyeb 应用 URL
|
||||
2. 更新 `src/lib/localApi.ts` 中的 API URL:
|
||||
|
||||
```typescript
|
||||
const API_BASE_URL = import.meta.env.VITE_API_BASE_URL ||
|
||||
(import.meta.env.PROD ? 'https://your-actual-app-url.koyeb.app/api' : 'http://localhost:3001/api');
|
||||
```
|
||||
|
||||
3. 提交并推送更改
|
||||
|
||||
### 8. 验证部署
|
||||
|
||||
访问以下端点验证部署是否成功:
|
||||
|
||||
- **健康检查**: `https://your-app-url.koyeb.app/api/health`
|
||||
- **API根路径**: `https://your-app-url.koyeb.app/api`
|
||||
|
||||
## 🔧 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
#### 1. 应用启动失败
|
||||
- 检查环境变量是否正确设置
|
||||
- 查看 Koyeb 日志中的错误信息
|
||||
- 确保 `package.json` 中的 `start` 脚本正确
|
||||
|
||||
#### 2. 数据库连接问题
|
||||
- 确保持久化存储卷已正确配置
|
||||
- 检查 `/app/data` 目录权限
|
||||
- 查看数据库初始化日志
|
||||
|
||||
#### 3. CORS 错误
|
||||
- 在服务器配置中添加您的前端域名到 CORS 白名单
|
||||
- 更新 `server/index.cjs` 中的 CORS 配置
|
||||
|
||||
### 查看日志
|
||||
|
||||
在 Koyeb 控制台中:
|
||||
1. 进入您的应用
|
||||
2. 点击 "Logs" 标签
|
||||
3. 查看实时日志输出
|
||||
|
||||
## 📊 监控和维护
|
||||
|
||||
### 健康检查
|
||||
|
||||
Koyeb 会自动监控您的应用健康状态:
|
||||
- **端点**: `/api/health`
|
||||
- **检查间隔**: 10秒
|
||||
- **超时时间**: 5秒
|
||||
|
||||
### 数据备份
|
||||
|
||||
定期备份您的 SQLite 数据库:
|
||||
1. 在 Koyeb 控制台中访问您的应用
|
||||
2. 使用 "Terminal" 功能连接到容器
|
||||
3. 复制 `/app/data/numerology.db` 文件
|
||||
|
||||
### 扩展和升级
|
||||
|
||||
如需更多资源:
|
||||
1. 在 Koyeb 控制台中选择更大的实例类型
|
||||
2. 增加存储卷大小
|
||||
3. 配置自动扩展规则
|
||||
|
||||
## 💰 费用说明
|
||||
|
||||
**免费套餐包含**:
|
||||
- 512MB RAM
|
||||
- 100GB 带宽/月
|
||||
- 1个应用
|
||||
- 基础支持
|
||||
|
||||
**注意**: 超出免费额度后会产生费用,请监控使用情况。
|
||||
|
||||
## 🔗 有用链接
|
||||
|
||||
- [Koyeb 文档](https://www.koyeb.com/docs)
|
||||
- [Koyeb 定价](https://www.koyeb.com/pricing)
|
||||
- [Koyeb 支持](https://www.koyeb.com/support)
|
||||
|
||||
## 🆘 获取帮助
|
||||
|
||||
如果遇到问题:
|
||||
1. 查看 Koyeb 官方文档
|
||||
2. 检查应用日志
|
||||
3. 联系 Koyeb 支持团队
|
||||
4. 在项目 GitHub 仓库中创建 Issue
|
||||
|
||||
---
|
||||
|
||||
**部署成功后,您的三算命应用就可以在全球范围内访问了!** 🎉
|
||||
13
railway.json
13
railway.json
@@ -1,13 +0,0 @@
|
||||
{
|
||||
"$schema": "https://railway.app/railway.schema.json",
|
||||
"build": {
|
||||
"builder": "NIXPACKS"
|
||||
},
|
||||
"deploy": {
|
||||
"startCommand": "npm start",
|
||||
"healthcheckPath": "/health",
|
||||
"healthcheckTimeout": 100,
|
||||
"restartPolicyType": "ON_FAILURE",
|
||||
"restartPolicyMaxRetries": 10
|
||||
}
|
||||
}
|
||||
@@ -5,7 +5,10 @@ const fs = require('fs');
|
||||
class DatabaseManager {
|
||||
constructor() {
|
||||
this.db = null;
|
||||
this.dbPath = path.join(__dirname, '../../numerology.db');
|
||||
// 生产环境使用持久化存储路径,开发环境使用本地路径
|
||||
this.dbPath = process.env.NODE_ENV === 'production'
|
||||
? '/app/data/numerology.db'
|
||||
: path.join(__dirname, '../../numerology.db');
|
||||
this.schemaPath = path.join(__dirname, 'schema.sql');
|
||||
}
|
||||
|
||||
|
||||
@@ -42,12 +42,7 @@ app.use(helmet({
|
||||
// CORS配置
|
||||
app.use(cors({
|
||||
origin: process.env.NODE_ENV === 'production'
|
||||
? [
|
||||
'http://localhost:5173',
|
||||
'http://localhost:4173',
|
||||
/\.railway\.app$/, // Railway域名
|
||||
/\.up\.railway\.app$/ // Railway新域名格式
|
||||
]
|
||||
? ['http://localhost:5173', 'http://localhost:4173'] // 生产环境允许的域名
|
||||
: true, // 开发环境允许所有域名
|
||||
credentials: true,
|
||||
methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
|
||||
@@ -68,6 +63,16 @@ app.get('/health', (req, res) => {
|
||||
});
|
||||
});
|
||||
|
||||
// API健康检查端点(用于Koyeb监控)
|
||||
app.get('/api/health', (req, res) => {
|
||||
res.status(200).json({
|
||||
status: 'healthy',
|
||||
timestamp: new Date().toISOString(),
|
||||
uptime: process.uptime(),
|
||||
database: 'connected'
|
||||
});
|
||||
});
|
||||
|
||||
// API路由
|
||||
app.use('/api/auth', authRoutes);
|
||||
app.use('/api/analysis', analysisRoutes);
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
// 本地API客户端
|
||||
// 替代Supabase客户端,提供相同的接口
|
||||
|
||||
const API_BASE_URL = import.meta.env.VITE_API_BASE_URL || 'http://localhost:3001/api';
|
||||
const API_BASE_URL = import.meta.env.VITE_API_BASE_URL ||
|
||||
(import.meta.env.PROD ? 'https://your-app.koyeb.app/api' : 'http://localhost:3001/api');
|
||||
|
||||
interface ApiResponse<T> {
|
||||
data?: T;
|
||||
|
||||
Reference in New Issue
Block a user