Skip to Content
🚀 Drubase One v1.1 - 基于 Drupal 11 的多租户后端即服务平台
Docs配置配置指南

配置指南

Drubase One 安装完成后,您可以根据实际需求调整各项配置,以优化演示项目的运行效果。

📋 配置概述

本章节介绍影响演示项目运行的主要配置选项:

🎯 快速配置向导

开发环境推荐配置

适合本地开发和测试:

API 速率限制: 宽松 (用户 100次/分钟, IP 50次/分钟)
CORS: 允许所有来源 (*)
缓存: 禁用页面缓存,开启 Redis
实时功能: 启用 WebSocket
文件存储: 本地文件系统

生产环境推荐配置

适合正式部署:

API 速率限制: 严格 (用户 30次/分钟, IP 10次/分钟)
CORS: 仅允许特定域名
缓存: 开启 Redis + 页面缓存
实时功能: 启用 WebSocket (使用 SSL)
文件存储: 对象存储 (S3 兼容)

🔧 配置方式

Drubase One 支持多种配置方式:

1. Web 界面配置

最直观的配置方式,适合快速调整:

访问: http://YOUR_HOST/admin/config/baas

可配置的模块:

  • BaaS API Settings
  • Rate Limiting
  • File Management
  • Realtime Configuration

2. 环境变量

通过 Docker 环境变量配置:

编辑 docker/.env:

# 域名配置（⚠️ 重要）
BAAS_DOMAIN=local.drubase.com  # 内部服务域名
DOMAIN=localhost                # 外部访问域名

# Redis 配置
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=your_password

# 数据库配置
DB_PASSWORD=baas_password
DB_NAME=drubase
DB_USER=postgres

# PHP 配置
PHP_MEMORY_LIMIT=512M
PHP_MAX_UPLOAD_SIZE=100M

# 应用配置
APP_ENV=production
APP_SECRET=your-secret-key-change-this

⚠️ 域名配置特别提醒:

如果您使用自定义域名，必须同时修改：

  1. docker/.env - 设置 BAAS_DOMAIN 和 DOMAIN
  2. apps/groups/config/runtime-config.js - 设置 BAAS_BASE_URL 和服务端点

详细步骤请查看: 安装过程 - 配置域名

3. Groups 应用配置

如果使用 Groups 演示应用，需要配置运行时参数:

编辑 apps/groups/config/runtime-config.js:

window.__RUNTIME_CONFIG__ = {
  BAAS_BASE_URL: 'http://localhost',  // ⚠️ 必须与 docker/.env 的 DOMAIN 一致
  BAAS_TENANT_ID: '7375b0cd',
  BAAS_PROJECT_ID: '7375b0cd_6888d012be80c',
  BAAS_API_KEY: 'your-api-key-here',  // ⚠️ 需要在后台生成
  ENDPOINTS: {
    API: '/api/v1',
    FUNCTIONS: 'http://localhost:3001',
    REALTIME: 'ws://localhost:4000',
    FILES: '/files'
  }
};

📊 配置优先级

当多个配置源存在冲突时,优先级如下:

  1. 环境变量 (最高优先级)
  2. Web 界面配置
  3. 默认值 (最低优先级)

🔍 验证配置

通过 Web 界面

访问配置管理页面查看当前配置:

http://YOUR_HOST/admin/config/baas

通过 API 测试

# 测试 API 速率限制
for i in {1..65}; do curl -I http://YOUR_HOST/api/health; done
 
# 测试 CORS
curl -H "Origin: http://example.com" -I http://YOUR_HOST/api/health
 
# 测试文件上传
curl -X POST -F "file=@test.jpg" http://YOUR_HOST/api/files/upload \
  -H "Authorization: Bearer YOUR_TOKEN"

⚠️ 配置注意事项

修改配置后的操作

某些配置需要重启服务才能生效:

# Redis 配置变更
docker compose restart redis
 
# PHP 配置变更
docker compose restart php8-4-fpm
 
# Nginx 配置变更
docker compose restart nginx

配置备份

重要配置变更前建议备份:

# 备份配置文件
tar -czf config-backup-$(date +%Y%m%d).tar.gz config/sync/
 
# 恢复配置
tar -xzf config-backup-20250122.tar.gz

🎯 常见配置场景

场景 1: 开发调试

  • 禁用页面缓存
  • 禁用 CSS/JS 聚合
  • 宽松的速率限制
  • 允许所有来源的 CORS

场景 2: 性能优化

  • 启用页面缓存 (1 小时)
  • 启用 CSS/JS 聚合
  • 配置 Redis 缓存
  • 启用 Gzip 压缩

场景 3: API 集成测试

  • 允许所有来源的 CORS
  • 暂时禁用速率限制
  • 启用 API 日志
  • 详细的错误消息

📖 详细文档

请查看左侧导航栏,了解每个配置模块的详细说明:

  • 域名配置 - 自定义访问域名 (查看详情)
  • API 配置 - 基础 API 设置
  • 速率限制 - 保护 API 免受滥用
  • 文件存储 - 管理上传文件
  • 实时功能 - WebSocket 配置
  • CORS 跨域 - 前端集成
  • 缓存配置 - 提升性能

➡️ 下一步

配置完成后,继续:

Last updated on
安装过程API 配置