Serverpod 完全指南【dart】

Serverpod 完全指南

Serverpod 是一个强大的开源后端框架，专为 Flutter 和 Dart 开发者设计。它提供了一个完整的端到端解决方案，可以显著提高全栈应用的开发效率。

目录

• 功能特点
• 环境准备
• 本地运行
• Docker 运行
• 项目结构
• 基础示例

功能特点

• 🚀 自动生成的类型安全 API
• 📦 内置缓存系统
• 💾 PostgreSQL 数据库集成
• 📁 文件和流媒体处理
• 🔄 实时通信（WebSocket）
• ⏰ 任务调度和后台作业
• 🔐 内置身份验证
• 🛠 代码生成工具
• ☁️ 云端部署支持（AWS、GCP）

环境准备

1. 安装 Dart SDK (2.15.0 或更高版本)
2. 安装 Flutter SDK (2.8.0 或更高版本)
3. 安装 PostgreSQL (14.0 或更高版本)
4. 安装 Docker (如果使用 Docker 运行)
5. 安装 Redis (可选，用于缓存)

本地运行

1. 安装 Serverpod CLI

dart pub global activate serverpod_cli

2. 创建新项目

serverpod create my_project

这将创建三个目录：

• my_project_server (服务端代码)
• my_project_client (客户端库)
• my_project_flutter (Flutter 应用示例)

3. 配置数据库

1. 创建 PostgreSQL 数据库：

CREATE DATABASE my_project;
CREATE DATABASE my_project_test;

2. 更新配置文件：
   编辑 my_project_server/config/development.yaml：

database:
  host: localhost
  port: 5432
  name: my_project
  user: postgres
  password: your_password

4. 运行服务器

cd my_project_server
dart bin/main.dart

服务器默认运行在 http://localhost:8080

Docker 运行

1. 准备 Docker 配置

在项目根目录创建 docker-compose.yaml：