n8n 设置时区不生效？如何正确配置时区？

Question

在使用 n8n 进行自动化流程开发时，部分用户会遇到“设置时区不生效”的问题，尤其是在涉及时间相关的节点（如 Cron、Date & Time 或函数节点）时，导致时间显示或执行不符合预期。这通常是因为 n8n 默认使用服务器所在时区，未正确配置全局或节点级时区参数。解决此问题的关键在于：一、在 n8n 启动时通过环境变量 `N8N_TIMEZONE` 明确指定时区，如 `Asia/Shanghai`；二、在具体节点中手动设置时区，确保与业务需求一致。此外，还需检查系统时区与 Docker 容器（如使用）的时区是否同步，以避免配置冲突。

Answer 1

一、问题现象：n8n 时间设置不生效

在使用 n8n 进行自动化流程开发时，部分用户反馈时间相关的节点（如 Cron、Date & Time 或函数节点）显示或执行的时间与预期不符。例如：

• 定时任务未按预期时间触发
• 时间格式化输出显示为 UTC 或服务器本地时间
• 跨时区协作时出现时间偏差

这些问题通常源于 n8n 默认使用服务器所在时区，而未正确配置全局或节点级时区参数。

二、问题分析：时区设置的多层影响因素

n8n 的时间处理涉及多个层级，时区设置不生效可能由以下多个因素叠加造成：

1. 全局时区未配置：n8n 启动时未通过环境变量 N8N_TIMEZONE 设置时区
2. 节点级时区缺失：如 Date & Time 节点未手动指定时区
3. 系统与容器时区不一致：使用 Docker 时，宿主机与容器内部时区不同步
4. JavaScript 时区处理机制：Node.js 内部对时间的处理依赖系统时区

三、解决方案：分层配置时区策略

为确保时间处理的一致性，建议采用以下分层配置方式：

配置层级	配置方式	作用范围	示例值
全局时区	环境变量 N8N_TIMEZONE	整个 n8n 实例	Asia/Shanghai
节点级时区	在 Date & Time 等节点中手动设置	当前节点逻辑	Asia/Shanghai
系统时区	Linux 系统：timedatectl set-timezone Asia/Shanghai	所有依赖系统时间的服务	America/New_York
Docker 容器时区	运行时挂载时区文件或设置环境变量	容器内部服务	-e TZ=Asia/Shanghai

四、配置示例：Docker 部署时的完整配置

以 Docker 部署为例，完整配置命令如下：

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -e N8N_TIMEZONE=Asia/Shanghai \
  -e TZ=Asia/Shanghai \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  n8nio/n8n

五、验证方法：确认时区是否生效

可通过以下方式验证配置是否生效：

1. 在 n8n 中添加 Date & Time 节点，输出当前时间并检查时区
2. 查看日志输出中时间戳是否符合预期
3. 执行 Cron 节点任务，确认触发时间是否准确
4. 在函数节点中打印 new Date().toString() 检查运行时时间

六、进阶建议：时区处理的最佳实践

为了减少时区带来的不确定性，建议遵循以下最佳实践：

• 统一使用 Asia/Shanghai 等 IANA 时区标识，避免使用缩写（如 CST）
• 开发阶段即明确配置时区，避免后期修改带来的兼容性问题
• 在流程中增加日志节点，记录关键时间点，便于排查时区问题
• 跨时区部署时，结合 UTC 时间进行统一协调

七、流程图：时区配置检查流程

graph TD
A[启动 n8n] --> B{是否配置 N8N_TIMEZONE?}
B -->|是| C[使用指定时区]
B -->|否| D[使用系统时区]
D --> E{是否在 Docker 中运行?}
E -->|是| F[检查容器时区与宿主机是否一致]
E -->|否| G[检查系统时区设置]
F --> H{是否一致?}
H -->|否| I[重新配置容器时区]
H -->|是| J[继续运行]
G --> K{系统时区是否正确?}
K -->|否| L[修改系统时区]
K -->|是| M[继续运行]