windows本地搭建Directus环境

🐳 Docker 方式安装（推荐）

这种方法利用容器技术，能省去手动配置数据库和Node.js环境的麻烦。

1. 准备工作：启用 WSL 和安装 Docker

Directus 的 Docker 镜像主要在 Linux 环境下运行，因此Windows电脑需要先安装 WSL2 (Windows Subsystem for Linux) 和 Docker Desktop。

1. 启用 WSL：以管理员身份打开 PowerShell（在开始菜单右键点击 Windows PowerShell 选择“以管理员身份运行”），输入并执行：

   powershell

   wsl --install

   执行后重启电脑。这个过程会自动安装默认的 Ubuntu 发行版。

2. 安装 Docker Desktop：

   • 访问 Docker Desktop for Windows 下载页面并下载安装包。

   • 安装过程中，确保勾选 "Use WSL 2 instead of Hyper-V" 选项。

2. 安装和运行 Directus

1. 打开 Docker Desktop，确保左下角状态为“Running”。

2. 在 PowerShell（或 Windows 终端）中，运行以下命令来拉取并运行 Directus 的 Docker 容器：

   powershell

   docker run -d `
      --name my-directus `
      -p 8055:8055 `
      -e KEY="my-admin-key" `
      -e SECRET="my-admin-secret" `
      -e ADMIN_EMAIL="admin@example.com" `
      -e ADMIN_PASSWORD="password" `
      -e DB_CLIENT="sqlite3" `
      -e DB_FILENAME="/directus/database/data.db" `
      -e WEBSOCKETS_ENABLED="true" `
      directus/directus:latest

   参数解释：

   • -p 8055:8055: 将容器内的 8055 端口映射到本机的 8055 端口。

   • -e KEY 和 -e SECRET: 用于加密，可以自行修改复杂字符串。

   • -e ADMIN_EMAIL 和 -e ADMIN_PASSWORD: 首次登录 Directus 的管理员账号和密码，请务必修改。

   • -e DB_CLIENT="sqlite3": 使用 SQLite 数据库，无需额外安装数据库服务。如需使用 MySQL 或 PostgreSQL，需修改此参数并另外配置数据库容器7。

   • 其他环境变量（如 WEBSOCKETS_ENABLED）可根据需要设置。

3. 访问 Directus

安装完成后，在浏览器中访问 http://localhost:8055。使用上面 ADMIN_EMAIL 和 ADMIN_PASSWORD 设置的管理员账号登录即可。

📦 Node.js 方式安装

这种方法适合需要直接修改源码或进行二次开发的场景。

1. 准备工作：安装 Node.js 和数据库

1. 安装 Node.js：访问 Node.js 官网下载并安装 LTS 版本。安装后打开命令提示符（CMD），输入 node -v 和 npm -v 检查是否安装成功。

2. 安装数据库：选择并安装一个数据库。以 MySQL 为例：

   • 可以从 MySQL官网下载安装包，或者使用其他集成环境（如 XAMPP、WampServer 或 phpStudy）来一键安装 MySQL 和数据库管理工具5。

2. 创建 Directus 项目

1. 打开命令提示符（CMD）或 PowerShell，选择一个合适的目录，运行以下命令来创建新的 Directus 项目：

   shell

   npx create-directus-project my-directus-project

   根据提示进行配置：

   • 选择数据库类型（如 MySQL、SQLite、PostgreSQL等）。

   • 输入数据库连接信息（如果使用 MySQL，需要提前创建好空的数据库）。

   • 设置管理员邮箱和密码34。

3. 启动项目

1. 项目创建完成后，进入项目目录：

   shell

   cd my-directus-project

2. 启动 Directus 服务：

   shell

   npx directus start

3. 启动成功后，同样通过 http://localhost:8055 访问。

⚙️ 初始配置和常见问题

基本配置

首次登录 Directus 管理后台后，建议进行以下设置37：

• 切换语言：在右上角 Settings -> Project Settings -> Default Language 中可切换为中文（简体）。

• 创建数据模型（Collections）：在“数据模型”中创建新的数据表并添加字段。

• 配置权限：在“角色与权限”中，为不同角色（如 Public）配置API访问权限。

可能遇到的问题及解决方法

• 端口冲突：如果 8055 端口已被其他程序占用，启动会失败。可以：

  • 停止占用端口的程序，或

  • 修改 Directus 的启动端口（Docker方式修改 -p <新端口>:8055，Node.js方式修改项目根目录下 .env 文件中的 PORT 变量3）。

• Docker 容器无法启动：

  • 检查 Docker Desktop 是否正常运行。

  • 检查命令中的环境变量值是否正确，特别是密码等敏感信息是否有特殊字符需要转义。

• Node.js 版本问题：确保安装的 Node.js 版本符合 Directus 的要求（通常需要 v18 或更高版本）。

• 数据库连接失败（Node.js 方式）：

  • 检查数据库服务是否启动。

  • 检查 ./my-directus-project/.env 配置文件中的数据库连接信息（如主机名、端口、用户名、密码、数据库名）是否正确38。

💎 总结

在 Windows 上本地搭建 Directus，Docker 方式更适合大多数用户，因为它屏蔽了环境差异，更简单快捷。Node.js 方式则为你提供了更大的灵活性和控制力，适合进阶用户和开发者。