1. 确认最低要求
Directus 需要两个东西来运行:Node.js 和一个数据库。 对于这两个系统要求,我们的目标是支持当前的 LTS 版本(和更新版本)。
要运行 Directus,您当前需要 Node 18 或更高版本,以及以下数据库之一:
Database | Version |
---|---|
PostgreSQL | 10+ |
MySQL 1 | 5.7.8+ / 8+ |
SQLite | 3+ |
MS SQL Server | 13+ |
MariaDB 2 | 10.2.7+ |
CockroachDB 2 | 21.1.13+ |
OracleDB2 3 | 19+ |
MySQL 8+ 需要 mysql_native_password 启用1
旧版本可能有效,但不受官方支持。 使用风险自负。 2
使用 OracleDB 时请务必安装 node-oracledb
及其系统依赖项3
除上述数据库外,还支持其他变体,包括 AWS Aurora (MySQL)、AWS Redshift (PostgreSQL)、Azure SQL (MS SQL)。
在 Apple 制造的 ARM CPU 上安装 Directus 时,请确保安装了 libvips
。 请参阅 Apple M1。
2. 创建项目
导航到要在其中创建新 Directus 项目的目录。 新项目和目录将在当前目录中创建。 通过运行以下 npm 命令创建一个新的 Directus 项目。
npm init directus-project my-project
npm init directus-project my-projectnpm init directus-project my-projectnpm init directus-project my-projectnpm init directus-project my-project
除了 SQLite,数据库必须在创建 Directus 项目之前已经运行。
3. 开始你的项目
要启动 Directus,请导航到项目目录 my-project。
cd my-project
在您的项目目录中运行以下命令。
npx directus start
4. 查看您的项目
Directus 使用的默认端口是 8055。要在本地查看您的项目,请在浏览器中转到http://localhost:8055
。
更改端口
如果您想使用不同的端口,请使用 PORT
环境变量。
.env 权限
默认情况下,create-directus-project
工具会将生成的 .env
的文件权限设置为 -rw-r-----
(0640)。
如果您从计算机上的单独用户运行 Directus,请确保这些权限正确。
配置/更新/升级您的项目
请参阅 更新和迁移 了解如何保持您的项目向前发展。