环境要求

在安装 Drubase One 之前,请确保您的系统满足以下要求。

📋 安装方式选择

Drubase One 支持两种安装方式:

🐳 Docker 方式 (推荐)

优点:

• 一键式安装,开箱即用
• 环境隔离,避免冲突
• 统一的开发和生产环境
• 便于版本管理和回滚

要求: Docker Engine 20.10+ 和 Docker Compose v2+

适用场景: 本地开发、测试环境、快速部署

💻 传统方式 (手动配置)

要求:

• Web 服务器: Nginx 1.18+ 或 Apache 2.4+
• PHP: PHP 8.4+ (with FPM, OPcache, GD, PDO, JSON, XML, mbstring, cURL)
• 数据库: PostgreSQL 17+ 或 MySQL 8.0+
• 缓存: Redis 7+
• Node.js: Node.js 20+ (用于函数服务)
• Composer: 2.0+

适用场景: 生产环境、已有基础设施、特殊性能优化需求

注意: 本文档主要介绍 Docker 方式的要求。传统方式安装请参考 Drupal 11 官方文档。

🖥️ 系统要求

操作系统

支持以下操作系统:

• Linux: Ubuntu 20.04+, Debian 11+, CentOS 8+, Fedora 35+
• macOS: macOS 11 (Big Sur) 或更高版本
• Windows: Windows 10/11 with WSL2

硬件要求

最低配置:

• CPU: 2 核
• 内存: 4 GB RAM
• 磁盘: 10 GB 可用空间

推荐配置:

• CPU: 4 核或更多
• 内存: 8 GB RAM 或更多
• 磁盘: 20 GB 可用空间 (SSD 推荐)

🐳 Docker 环境 (推荐方式)

Docker Engine

必需版本: Docker Engine 20.10+ 或 Docker Desktop 4.0+

验证安装:

docker --version
# 应输出: Docker version 20.10.x 或更高

安装指南:

• Linux: https://docs.docker.com/engine/install/ 
• macOS: https://docs.docker.com/desktop/install/mac-install/ 
• Windows: https://docs.docker.com/desktop/install/windows-install/ 

Docker Compose

必需版本: Docker Compose 2.0+ (集成在 Docker Desktop 中)

验证安装:

docker compose version
# 应输出: Docker Compose version v2.x.x 或更高

注意:

• Docker Desktop 自带 Docker Compose v2
• Linux 用户可能需要单独安装 Docker Compose Plugin

🌐 网络要求

端口占用检查

Drubase One 需要使用以下端口,请确保这些端口未被占用:

检查端口占用:

# Linux/macOS
sudo lsof -i :80
sudo lsof -i :5432
 
# Windows (PowerShell)
netstat -ano | findstr :80
netstat -ano | findstr :5432

网络连接

安装过程需要互联网连接以:

• 拉取 Docker 镜像
• 下载 Composer 依赖包
• 安装 npm 包 (如果使用前端功能)

📦 可选要求

Git

推荐版本: Git 2.30+

用于克隆仓库和版本控制:

git --version

安装指南: https://git-scm.com/downloads 

文本编辑器/IDE

推荐以下编辑器之一:

• VS Code - 轻量级,插件丰富
• PhpStorm - 强大的 PHP IDE
• Cursor - AI 辅助编辑器
• Sublime Text - 快速轻量

✅ 环境检查清单

安装前请确认:

• 操作系统满足要求
• Docker Engine 20.10+ 已安装
• Docker Compose v2+ 已安装
• 端口 80 未被占用
• 有至少 10 GB 可用磁盘空间
• 有稳定的网络连接
• (可选) Git 已安装

🔍 故障排查

Docker 未安装或版本过低

错误: docker: command not found 或版本低于 20.10

解决方案:

1. 访问 https://docs.docker.com/get-docker/ 
2. 选择您的操作系统
3. 按照官方指南安装最新版本

端口 80 被占用

错误: bind: address already in use

解决方案:

# Linux/macOS - 查找占用进程
sudo lsof -i :80
 
# 停止占用服务 (例如 Apache)
sudo systemctl stop apache2  # Ubuntu/Debian
sudo systemctl stop httpd    # CentOS/RHEL
 
# 或修改 docker-compose.yml 使用其他端口
# ports:
#   - "8080:80"  # 使用 8080 替代 80

Docker 权限问题 (Linux)

错误: permission denied while trying to connect to the Docker daemon socket

解决方案:

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER
 
# 重新登录或运行
newgrp docker
 
# 验证
docker ps

WSL2 问题 (Windows)

错误: Docker Desktop 无法启动或性能问题

解决方案:

1. 确认 WSL2 已启用: wsl --list --verbose
2. 更新 WSL2: wsl --update
3. 在 Docker Desktop 设置中启用 WSL2 backend
4. 分配足够的内存和 CPU 资源

➡️ 下一步

环境要求检查完成后,继续:

• 使用 Docker Compose 安装