Coolify平台中Directus服务环境变量配置指南

在使用Coolify平台一键部署Directus服务时，许多开发者会遇到环境变量配置不生效的问题。本文将深入分析这一问题的原因，并提供完整的解决方案。

问题现象分析

当开发者在Coolify平台通过一键部署功能创建Directus服务后，在服务配置页面添加的环境变量无法生效。即使重启服务，新添加的变量仍然无法被Directus服务识别。这种现象通常表现为：

1. 通过终端执行env命令查看不到新增变量
2. 依赖这些变量的功能无法正常工作
3. 重启服务操作后问题依旧存在

根本原因

Coolify平台的环境变量配置机制与Docker Compose部署方式存在差异。平台提供了两个配置层级：

1. 全局环境变量：在服务配置页面的"环境变量"选项卡中设置
2. 容器级环境变量：需要在Docker Compose文件中显式声明

大多数开发者只完成了第一层配置，而忽略了第二层的关键步骤，导致变量无法传递到容器内部。

完整解决方案

要正确配置Directus服务环境变量，需要完成以下两个步骤：

第一步：添加全局环境变量

1. 进入Coolify平台的服务配置页面
2. 导航至"环境变量"选项卡
3. 添加所需的变量名称和值
4. 保存配置

第二步：修改Docker Compose文件

1. 在服务配置页面找到"编辑Compose文件"按钮
2. 在Directus服务的environment配置段中添加变量映射
3. 使用$变量名语法引用之前定义的全局变量
4. 保存并应用修改

示例配置片段：

services:
  directus:
    environment:
      - MY_VARIABLE=$MY_VARIABLE
      - OTHER_VAR=$OTHER_VAR

第三步：重启服务

完成上述修改后，必须重启服务才能使新配置生效。在Coolify平台中可以通过服务控制面板的"重启"按钮完成此操作。

最佳实践建议

1. 变量命名规范：使用大写字母和下划线的命名方式，如CONTENT_SECURITY_POLICY
2. 敏感信息保护：对于密码等敏感信息，考虑使用Coolify的密钥管理功能
3. 配置验证：通过服务终端执行env命令验证变量是否已正确加载
4. 文档参考：结合Directus官方文档确认所需环境变量的正确格式

常见应用场景

1. 内容安全策略(CSP)配置：通过CONTENT_SECURITY_POLICY变量增强应用安全性
2. 数据库连接配置：设置DB_开头的系列变量控制数据库连接参数
3. 性能调优：利用CACHE_相关变量优化系统缓存行为
4. 功能开关：通过EXTENSIONS_变量控制扩展模块的加载

通过理解Coolify平台的环境变量传递机制，开发者可以更高效地管理和配置Directus服务的运行环境，充分发挥这一强大CMS系统的功能特性。