1. 为什么 N8N 生产环境必须上 PostgreSQL 做数据持久化N8N 默认用 SQLite 存数据跑在 Docker 里如果不挂载卷容器一删工作流全没。我见过太多人本地测试跑得飞起一上生产重启容器凭证、执行历史、工作流全丢只能从头配。N8N 生产环境部署的核心问题不是能不能跑而是数据能不能活过下一次docker compose down。N8N 官方支持 SQLite 和 PostgreSQL 两种数据库后端。SQLite 适合单机轻量场景但生产环境有几个硬伤并发写入会锁库、执行历史表膨胀后查询变慢、容器迁移时数据文件不好管理。PostgreSQL 则天然支持并发、支持远程连接、支持备份恢复是 N8N 生产环境部署的标准选择。这篇文章解决三个具体问题第一用 docker-compose 把 N8N 和 PostgreSQL 编排在一起数据落库不丢第二给出完整的环境变量清单和连接参数复制就能用第三通过 TaoToken 统一 Key 管理 N8N 里所有外部 API 调用不用在每个节点里重复填 Key。适合已经会用 Docker、准备把 N8N 从测试环境搬到生产环境的同学。先说清楚 N8N 用 PostgreSQL 持久化到底存了什么。N8N 的数据库里主要有这几类表workflow_entity存工作流定义credentials_entity存加密后的凭证execution_entity存每次执行记录shared_workflow存共享关系。这些表全部落在 PostgreSQL 里容器重启后 N8N 从数据库读回状态工作流和凭证原样恢复。这就是数据持久化的意义——N8N 容器变成无状态的计算层数据层独立出来。我实测下来N8N 连 PostgreSQL 的配置就靠一组DB_*环境变量。关键是DB_TYPEpostgresdb然后DB_POSTGRESDB_HOST、DB_POSTGRESDB_PORT、DB_POSTGRESDB_DATABASE、DB_POSTGRESDB_USER、DB_POSTGRESDB_PASSWORD五个参数填对N8N 启动时会自动建表。不需要手动跑 migrationN8N 自己会处理 schema 初始化。还有一个容易踩的坑N8N 的加密密钥N8N_ENCRYPTION_KEY。如果你不显式设置N8N 每次启动会生成一个新的导致之前加密的凭证解不开。生产环境必须把这个 Key 固定下来写进环境变量或者.env文件。这个 Key 丢了数据库里的凭证就废了只能重新填。下面进入实操。我会先给 docker-compose 配置再给环境变量清单然后验证数据落库最后测重启恢复。TaoToken 的部分放在 API 调用环节讲怎么用一个统一 Key 替代散落在各节点的多个 Key。2. TaoToken 前置准备统一 Key 管理 N8N 外部 API 调用N8N 工作流里经常要调各种大模型 API比如 OpenAI、Claude、通义千问。每个节点配一个 Key管理起来很乱Key 散落在凭证里、换 Key 要改多个地方、团队协作时 Key 泄露风险高。TaoToken 的做法是提供一个统一的 API 网关你只需要一个 TaoToken Key就能调用多家模型Base URL 指向 TaoToken 的 API 地址。TaoToken 是什么简单说它是一个大模型 API 聚合网关兼容 OpenAI 的接口格式。你在 N8N 里配置 OpenAI 凭证时把 Base URL 改成 TaoToken 的地址API Key 填 TaoToken 的 Key就能调用它背后支持的模型。对 N8N 来说它就是一个标准的 OpenAI 兼容接口不需要改工作流逻辑。适合谁用如果你在 N8N 里接了多个模型供应商或者团队多人共用工作流不想每人配一套 KeyTaoToken 的统一 Key 管理能省不少事。另外做 Coding Plan 长期编码任务的同学用统一 Key 也方便做用量统计和额度控制。前置准备分三步。第一步注册 TaoToken 账号拿到 API Key。第二步确认你要用的模型 ID比如claude-sonnet-4-20250514或者gpt-4o。第三步在 N8N 里创建 OpenAI 凭证Base URL 填 TaoToken 的 API 地址Key 填 TaoToken Key。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带 UTM 参数直接用于程序调用。官网地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册和查看文档走官网。在 N8N 里配置凭证的具体操作进入 N8N 管理界面左侧菜单点 Credentials右上角 Add Credential搜索 OpenAI选择 OpenAI API。在 API Key 字段填 TaoToken 的 Key在 Base URL 字段填https://taotoken.net/api。保存后点 Test如果返回 Connection tested successfully说明凭证可用。这里有个细节N8N 的 OpenAI 凭证默认 Base URL 是https://api.openai.com/v1你要把它改成 TaoToken 的地址。有些版本的 N8N 在 OpenAI 凭证里没有 Base URL 字段那就需要在节点里手动指定。我用的 N8N 版本是 1.x凭证里有 Base URL 选项直接改就行。配置好凭证后在 AI Agent 节点或者 OpenAI Chat Model 节点里选择这个凭证模型 ID 填 TaoToken 支持的模型名。比如你要用 Claude模型 ID 填claude-sonnet-4-20250514要用 GPT填gpt-4o。TaoToken 会根据模型 ID 路由到对应的后端。为什么要在 N8N 生产环境部署里提 TaoToken因为生产环境的工作流往往要调多个外部 APIKey 管理是个真实痛点。用 TaoToken 统一 Key 后你只需要维护一个 Key换模型不用换 Key团队协作时也只需要分发一个 Key。这比在每个节点里填不同供应商的 Key 要清爽得多。如果你还没注册 TaoToken可以先访问官网了解支持的模型列表和计费方式。注册后在 Console 里创建 API Key然后回到 N8N 配置凭证。整个流程不超过五分钟。3. 可复制的 docker-compose 配置与环境变量清单这一节给完整的 docker-compose 配置包含 N8N 和 PostgreSQL 两个服务。你可以直接复制到服务器上改几个参数就能跑。配置里我会把数据卷、环境变量、网络都写清楚避免容器重启后数据丢失。先看 docker-compose.yml 的完整内容version: 3.8 services: postgres: image: postgres:16-alpine container_name: n8n-postgres restart: unless-stopped environment: POSTGRES_USER: n8n POSTGRES_PASSWORD: n8n_strong_password_2025 POSTGRES_DB: n8n TZ: Asia/Shanghai volumes: - postgres_data:/var/lib/postgresql/data ports: - 5432:5432 healthcheck: test: [CMD-SHELL, pg_isready -U n8n -d n8n] interval: 10s timeout: 5s retries: 5 networks: - n8n-network n8n: image: n8nio/n8n:latest container_name: n8n restart: unless-stopped depends_on: postgres: condition: service_healthy environment: DB_TYPE: postgresdb DB_POSTGRESDB_HOST: postgres DB_POSTGRESDB_PORT: 5432 DB_POSTGRESDB_DATABASE: n8n DB_POSTGRESDB_USER: n8n DB_POSTGRESDB_PASSWORD: n8n_strong_password_2025 DB_POSTGRESDB_SCHEMA: public N8N_ENCRYPTION_KEY: your_fixed_encryption_key_here N8N_DEFAULT_LOCALE: zh-CN N8N_SECURE_COOKIE: false N8N_HOST: 0.0.0.0 N8N_PORT: 5678 N8N_PROTOCOL: http WEBHOOK_URL: http://your-server-ip:5678/ GENERIC_TIMEZONE: Asia/Shanghai TZ: Asia/Shanghai N8N_LOG_LEVEL: info N8N_METRICS: true volumes: - n8n_data:/home/node/.n8n ports: - 5678:5678 networks: - n8n-network volumes: postgres_data: driver: local n8n_data: driver: local networks: n8n-network: driver: bridge这份配置的关键点逐个说。PostgreSQL 用postgres:16-alpine镜像轻量且稳定。POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB三个变量定义数据库名和账号N8N 那边要填一样的值。volumes把postgres_data挂到/var/lib/postgresql/data这是 PostgreSQL 的数据目录容器删了数据还在。healthcheck让 PostgreSQL 先就绪N8N 再启动。depends_on配合condition: service_healthy保证启动顺序避免 N8N 连不上数据库反复重启。N8N 服务的环境变量是重点。DB_TYPEpostgresdb告诉 N8N 用 PostgreSQL。DB_POSTGRESDB_HOSTpostgres这里填的是 docker-compose 里的服务名因为两个容器在同一个网络里N8N 通过服务名访问 PostgreSQL。如果你用外部数据库这里填 IP 地址。N8N_ENCRYPTION_KEY必须固定我写的是占位符你要换成一个随机字符串。生成方法openssl rand -hex 32。这个 Key 一旦设定不要改改了之前加密的凭证就解不开。N8N_SECURE_COOKIEfalse是因为我们用 HTTP 访问如果配了 HTTPS 可以设为 true。WEBHOOK_URL填你的服务器地址webhook 节点生成的回调地址会基于这个。n8n_data卷挂到/home/node/.n8n这里存 N8N 的配置文件和一些本地缓存。虽然数据主要在 PostgreSQL 里但这个卷也建议保留。启动命令docker compose up -d启动后检查容器状态docker compose ps你应该看到两个容器都是running状态PostgreSQL 显示healthy。如果 N8N 反复重启看日志docker compose logs n8n --tail 50常见错误是数据库连接失败日志里会显示Connection refused或password authentication failed。检查DB_POSTGRESDB_*变量是否和 PostgreSQL 的POSTGRES_*一致。环境变量清单整理成表格方便对照变量名作用示例值DB_TYPE数据库类型postgresdbDB_POSTGRESDB_HOST数据库主机postgresDB_POSTGRESDB_PORT数据库端口5432DB_POSTGRESDB_DATABASE数据库名n8nDB_POSTGRESDB_USER数据库用户n8nDB_POSTGRESDB_PASSWORD数据库密码你的密码DB_POSTGRESDB_SCHEMAschemapublicN8N_ENCRYPTION_KEY凭证加密密钥32位随机串N8N_DEFAULT_LOCALE界面语言zh-CNN8N_SECURE_COOKIE安全CookiefalseWEBHOOK_URLWebhook回调地址http://ip:5678/GENERIC_TIMEZONE时区Asia/Shanghai这份配置我实测下来可以直接用改三个地方PostgreSQL 密码、N8N_ENCRYPTION_KEY、WEBHOOK_URL。其他保持默认即可。如果你用外部 PostgreSQL 而不是 docker-compose 里的把DB_POSTGRESDB_HOST改成外部数据库 IPDB_POSTGRESDB_PORT改成对应端口然后删掉 postgres 服务和 depends_on 配置。4. 验证数据落库与重启恢复测试配置跑起来后要验证两件事数据确实写进了 PostgreSQL以及容器重启后数据能恢复。这一节给具体操作步骤。先验证数据落库。用docker compose exec进入 PostgreSQL 容器docker compose exec postgres psql -U n8n -d n8n进入 psql 后列出所有表\dt你应该看到 N8N 自动创建的表包括workflow_entity、credentials_entity、execution_entity、shared_workflow、tag_entity等。如果这些表存在说明 N8N 成功连上了 PostgreSQL 并完成了 schema 初始化。查一下工作流表SELECT id, name, active FROM workflow_entity;刚部署时可能是空的因为你还没创建工作流。去 N8N 界面创建一个测试工作流比如一个手动触发节点加一个 Set 节点保存后回到 psql 再查应该能看到记录。查凭证表SELECT id, name, type FROM credentials_entity;你在 N8N 里创建的 TaoToken 凭证会出现在这里。注意data字段是加密的看不到明文这是正常的。查执行记录SELECT id, workflow_id, status, started_at FROM execution_entity ORDER BY started_at DESC LIMIT 10;每次工作流执行都会写一条记录。执行几次工作流后这里应该有数据。验证完落库做重启恢复测试。先记录当前工作流数量SELECT COUNT(*) FROM workflow_entity;假设是 3 个。然后退出 psql重启 N8N 容器docker compose restart n8n等 N8N 重新启动后刷新浏览器界面检查工作流是否还在。再进 psql 查一次SELECT COUNT(*) FROM workflow_entity;如果还是 3说明数据从 PostgreSQL 恢复了。再测一个更彻底的删掉 N8N 容器重建docker compose down n8n docker compose up -d n8n注意这里只 down 了 n8n 服务没动 postgres。重建后 N8N 从数据库读回所有数据工作流和凭证原样恢复。这就是数据持久化的效果。如果你想测极端情况把两个容器都停掉再启动docker compose down docker compose up -d因为postgres_data卷还在数据不会丢。只有执行docker compose down -v才会删卷那时候数据才真的没了。生产环境千万别加-v。验证 TaoToken 凭证在重启后是否可用。重启 N8N 后打开之前用 TaoToken 凭证的工作流执行一次。如果模型正常返回说明凭证解密成功N8N_ENCRYPTION_KEY配置正确。这里有个排查点如果重启后凭证报Could not decrypt credentials说明N8N_ENCRYPTION_KEY变了。检查环境变量是否固定有没有被 docker-compose 重新生成。再给一个数据备份的命令生产环境建议定期跑docker compose exec postgres pg_dump -U n8n -d n8n n8n_backup_$(date %Y%m%d).sql这个命令把整个 N8N 数据库导出成 SQL 文件恢复时用psql导入即可。备份文件建议存到对象存储或者另一台机器。恢复命令cat n8n_backup_20250607.sql | docker compose exec -T postgres psql -U n8n -d n8n注意恢复前最好停掉 N8N避免写入冲突。5. 本篇常见错误排查401、local proxy failed、reading choices、OAuth部署过程中会遇到几类典型报错这一节逐个拆解。每个报错给现象、原因、解决步骤。第一类数据库连接报错。N8N 启动日志出现Error: connect ECONNREFUSED 172.x.x.x:5432或者password authentication failed for user n8n。原因是 N8N 连不上 PostgreSQL或者账号密码不对。排查步骤先确认 PostgreSQL 容器在跑docker compose ps看状态。然后检查DB_POSTGRESDB_HOST是否填的postgresdocker-compose 服务名如果你填了localhost那肯定连不上因为容器里的 localhost 是容器自己。密码不一致也会报这个对照POSTGRES_PASSWORD和DB_POSTGRESDB_PASSWORD是否一样。第二类401 报错。在 N8N 里调 TaoToken 接口时返回401 Unauthorized。原因是 API Key 不对或者 Base URL 配错。排查步骤检查 N8N 凭证里的 API Key 是否是 TaoToken 的 Key有没有多余空格。检查 Base URL 是否是https://taotoken.net/api注意结尾不要加/v1TaoToken 的地址已经包含了版本路径。如果还报 401去 TaoToken Console 确认 Key 是否有效、额度是否充足。第三类local proxy failed报错。这个通常出现在 N8N 容器访问外部 API 时日志显示local proxy failed或者getaddrinfo EAI_AGAIN。原因是容器内 DNS 解析失败或者网络不通。排查步骤进 N8N 容器测试网络docker compose exec n8n sh wget -qO- https://taotoken.net/api如果 wget 失败检查 docker 网络配置。有时候是宿主机的 DNS 问题在 docker-compose 里给 N8N 服务加dns: 8.8.8.8可以解决。另外检查防火墙是否放行了出站 443 端口。第四类reading choices报错。N8N 的 OpenAI 节点返回Cannot read properties of undefined (reading choices)。原因是接口返回格式不对通常是 Base URL 配错导致返回了 HTML 错误页而不是 JSON。排查步骤确认 Base URL 是https://taotoken.net/api模型 ID 是 TaoToken 支持的模型名。如果模型 ID 写错TaoToken 可能返回错误信息N8N 解析不到choices字段就报这个错。去 TaoToken 文档查支持的模型列表确认模型 ID 拼写正确。第五类OAuth 报错。如果你在 N8N 里配置了需要 OAuth 的节点比如 Google、GitHub回调时报OAuth callback failed或者redirect_uri_mismatch。原因是WEBHOOK_URL配置不对OAuth 回调地址不匹配。排查步骤确认WEBHOOK_URL填的是外部可访问的地址比如http://your-server-ip:5678/。如果你用了域名填域名。OAuth 应用里配置的回调地址要和这个一致。另外N8N_SECURE_COOKIE如果设为 true 但用的是 HTTPOAuth 流程也会失败测试环境设为 false。第六类N8N 界面能打开但工作流执行卡住。日志显示Execution failed但没有具体错误。排查步骤看execution_entity表里的data字段里面有详细错误信息SELECT data FROM execution_entity WHERE status error ORDER BY started_at DESC LIMIT 1;或者直接在 N8N 界面点开执行记录看详情。常见原因是数据库连接池耗尽检查 PostgreSQL 的max_connections是否够用。N8N 默认连接池大小是 10如果并发高可以调大DB_POSTGRESDB_POOL_SIZE。第七类TaoToken 调用返回model not found。原因是模型 ID 不在 TaoToken 支持列表里。解决去 TaoToken 官网或 Console 查看可用模型用准确的模型 ID。比如 Claude 系列要用claude-sonnet-4-20250514这种完整名称不能简写。排查思路总结成一句话先看日志定位是数据库问题还是 API 问题数据库问题查连接参数API 问题查 Key 和 Base URL。N8N 的日志在docker compose logs n8n里PostgreSQL 的日志在docker compose logs postgres里。6. 长期编码与 Agent 场景的 CTAN8N 生产环境部署跑通后下一步就是接实际业务。如果你在 N8N 里做长期编码任务或者 Agent 工作流TaoToken 的 Coding Plan 适合这种场景。Coding Plan 提供稳定的 API 额度和统一的 Key 管理不用每次换模型都改配置。具体操作路径访问 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content了解 Coding Plan 详情。然后在 Console 里创建 API Key地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。创建好 Key 后在 N8N 的 OpenAI 凭证里填入Base URL 用https://taotoken.net/api。如果你还没配好 N8N 的凭证接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有各语言的调用示例。想先测试模型对话效果可以用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content在线试。N8N 里配置 TaoToken 的三件套再强调一遍Base URL 填https://taotoken.net/apiAPI Key 填 TaoToken 的 KeyModel ID 填具体模型名比如claude-sonnet-4-20250514。这三个填对N8N 就能通过 TaoToken 调模型。如果你用 Claude Code 做编码TaoToken 也支持 Anthropic 接口格式配置地址在https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。N8N 里如果要调 Claude 的 Anthropic 原生接口也可以用这个地址。最后给一个 N8N 工作流里用 TaoToken 的实用技巧把 TaoToken 凭证设成共享凭证团队里其他人用同一个凭证不用每人配 Key。在 N8N 的 Credentials 里点凭证右上角选择 Share添加团队成员。这样统一 Key 管理的优势就体现出来了——一个人维护 Key全团队用。生产环境部署 N8N 的核心就是数据持久化加统一 Key 管理。PostgreSQL 保证数据不丢TaoToken 保证 API 调用不乱。这两件事做好N8N 就能稳定跑在生产环境里。 N8N 生产环境部署实战：用 PostgreSQL 实现数据持久化，TaoToken 统一 Key 打通 API 调用
1. 为什么 N8N 生产环境必须上 PostgreSQL 做数据持久化N8N 默认用 SQLite 存数据跑在 Docker 里如果不挂载卷容器一删工作流全没。我见过太多人本地测试跑得飞起一上生产重启容器凭证、执行历史、工作流全丢只能从头配。N8N 生产环境部署的核心问题不是能不能跑而是数据能不能活过下一次docker compose down。N8N 官方支持 SQLite 和 PostgreSQL 两种数据库后端。SQLite 适合单机轻量场景但生产环境有几个硬伤并发写入会锁库、执行历史表膨胀后查询变慢、容器迁移时数据文件不好管理。PostgreSQL 则天然支持并发、支持远程连接、支持备份恢复是 N8N 生产环境部署的标准选择。这篇文章解决三个具体问题第一用 docker-compose 把 N8N 和 PostgreSQL 编排在一起数据落库不丢第二给出完整的环境变量清单和连接参数复制就能用第三通过 TaoToken 统一 Key 管理 N8N 里所有外部 API 调用不用在每个节点里重复填 Key。适合已经会用 Docker、准备把 N8N 从测试环境搬到生产环境的同学。先说清楚 N8N 用 PostgreSQL 持久化到底存了什么。N8N 的数据库里主要有这几类表workflow_entity存工作流定义credentials_entity存加密后的凭证execution_entity存每次执行记录shared_workflow存共享关系。这些表全部落在 PostgreSQL 里容器重启后 N8N 从数据库读回状态工作流和凭证原样恢复。这就是数据持久化的意义——N8N 容器变成无状态的计算层数据层独立出来。我实测下来N8N 连 PostgreSQL 的配置就靠一组DB_*环境变量。关键是DB_TYPEpostgresdb然后DB_POSTGRESDB_HOST、DB_POSTGRESDB_PORT、DB_POSTGRESDB_DATABASE、DB_POSTGRESDB_USER、DB_POSTGRESDB_PASSWORD五个参数填对N8N 启动时会自动建表。不需要手动跑 migrationN8N 自己会处理 schema 初始化。还有一个容易踩的坑N8N 的加密密钥N8N_ENCRYPTION_KEY。如果你不显式设置N8N 每次启动会生成一个新的导致之前加密的凭证解不开。生产环境必须把这个 Key 固定下来写进环境变量或者.env文件。这个 Key 丢了数据库里的凭证就废了只能重新填。下面进入实操。我会先给 docker-compose 配置再给环境变量清单然后验证数据落库最后测重启恢复。TaoToken 的部分放在 API 调用环节讲怎么用一个统一 Key 替代散落在各节点的多个 Key。2. TaoToken 前置准备统一 Key 管理 N8N 外部 API 调用N8N 工作流里经常要调各种大模型 API比如 OpenAI、Claude、通义千问。每个节点配一个 Key管理起来很乱Key 散落在凭证里、换 Key 要改多个地方、团队协作时 Key 泄露风险高。TaoToken 的做法是提供一个统一的 API 网关你只需要一个 TaoToken Key就能调用多家模型Base URL 指向 TaoToken 的 API 地址。TaoToken 是什么简单说它是一个大模型 API 聚合网关兼容 OpenAI 的接口格式。你在 N8N 里配置 OpenAI 凭证时把 Base URL 改成 TaoToken 的地址API Key 填 TaoToken 的 Key就能调用它背后支持的模型。对 N8N 来说它就是一个标准的 OpenAI 兼容接口不需要改工作流逻辑。适合谁用如果你在 N8N 里接了多个模型供应商或者团队多人共用工作流不想每人配一套 KeyTaoToken 的统一 Key 管理能省不少事。另外做 Coding Plan 长期编码任务的同学用统一 Key 也方便做用量统计和额度控制。前置准备分三步。第一步注册 TaoToken 账号拿到 API Key。第二步确认你要用的模型 ID比如claude-sonnet-4-20250514或者gpt-4o。第三步在 N8N 里创建 OpenAI 凭证Base URL 填 TaoToken 的 API 地址Key 填 TaoToken Key。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带 UTM 参数直接用于程序调用。官网地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册和查看文档走官网。在 N8N 里配置凭证的具体操作进入 N8N 管理界面左侧菜单点 Credentials右上角 Add Credential搜索 OpenAI选择 OpenAI API。在 API Key 字段填 TaoToken 的 Key在 Base URL 字段填https://taotoken.net/api。保存后点 Test如果返回 Connection tested successfully说明凭证可用。这里有个细节N8N 的 OpenAI 凭证默认 Base URL 是https://api.openai.com/v1你要把它改成 TaoToken 的地址。有些版本的 N8N 在 OpenAI 凭证里没有 Base URL 字段那就需要在节点里手动指定。我用的 N8N 版本是 1.x凭证里有 Base URL 选项直接改就行。配置好凭证后在 AI Agent 节点或者 OpenAI Chat Model 节点里选择这个凭证模型 ID 填 TaoToken 支持的模型名。比如你要用 Claude模型 ID 填claude-sonnet-4-20250514要用 GPT填gpt-4o。TaoToken 会根据模型 ID 路由到对应的后端。为什么要在 N8N 生产环境部署里提 TaoToken因为生产环境的工作流往往要调多个外部 APIKey 管理是个真实痛点。用 TaoToken 统一 Key 后你只需要维护一个 Key换模型不用换 Key团队协作时也只需要分发一个 Key。这比在每个节点里填不同供应商的 Key 要清爽得多。如果你还没注册 TaoToken可以先访问官网了解支持的模型列表和计费方式。注册后在 Console 里创建 API Key然后回到 N8N 配置凭证。整个流程不超过五分钟。3. 可复制的 docker-compose 配置与环境变量清单这一节给完整的 docker-compose 配置包含 N8N 和 PostgreSQL 两个服务。你可以直接复制到服务器上改几个参数就能跑。配置里我会把数据卷、环境变量、网络都写清楚避免容器重启后数据丢失。先看 docker-compose.yml 的完整内容version: 3.8 services: postgres: image: postgres:16-alpine container_name: n8n-postgres restart: unless-stopped environment: POSTGRES_USER: n8n POSTGRES_PASSWORD: n8n_strong_password_2025 POSTGRES_DB: n8n TZ: Asia/Shanghai volumes: - postgres_data:/var/lib/postgresql/data ports: - 5432:5432 healthcheck: test: [CMD-SHELL, pg_isready -U n8n -d n8n] interval: 10s timeout: 5s retries: 5 networks: - n8n-network n8n: image: n8nio/n8n:latest container_name: n8n restart: unless-stopped depends_on: postgres: condition: service_healthy environment: DB_TYPE: postgresdb DB_POSTGRESDB_HOST: postgres DB_POSTGRESDB_PORT: 5432 DB_POSTGRESDB_DATABASE: n8n DB_POSTGRESDB_USER: n8n DB_POSTGRESDB_PASSWORD: n8n_strong_password_2025 DB_POSTGRESDB_SCHEMA: public N8N_ENCRYPTION_KEY: your_fixed_encryption_key_here N8N_DEFAULT_LOCALE: zh-CN N8N_SECURE_COOKIE: false N8N_HOST: 0.0.0.0 N8N_PORT: 5678 N8N_PROTOCOL: http WEBHOOK_URL: http://your-server-ip:5678/ GENERIC_TIMEZONE: Asia/Shanghai TZ: Asia/Shanghai N8N_LOG_LEVEL: info N8N_METRICS: true volumes: - n8n_data:/home/node/.n8n ports: - 5678:5678 networks: - n8n-network volumes: postgres_data: driver: local n8n_data: driver: local networks: n8n-network: driver: bridge这份配置的关键点逐个说。PostgreSQL 用postgres:16-alpine镜像轻量且稳定。POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB三个变量定义数据库名和账号N8N 那边要填一样的值。volumes把postgres_data挂到/var/lib/postgresql/data这是 PostgreSQL 的数据目录容器删了数据还在。healthcheck让 PostgreSQL 先就绪N8N 再启动。depends_on配合condition: service_healthy保证启动顺序避免 N8N 连不上数据库反复重启。N8N 服务的环境变量是重点。DB_TYPEpostgresdb告诉 N8N 用 PostgreSQL。DB_POSTGRESDB_HOSTpostgres这里填的是 docker-compose 里的服务名因为两个容器在同一个网络里N8N 通过服务名访问 PostgreSQL。如果你用外部数据库这里填 IP 地址。N8N_ENCRYPTION_KEY必须固定我写的是占位符你要换成一个随机字符串。生成方法openssl rand -hex 32。这个 Key 一旦设定不要改改了之前加密的凭证就解不开。N8N_SECURE_COOKIEfalse是因为我们用 HTTP 访问如果配了 HTTPS 可以设为 true。WEBHOOK_URL填你的服务器地址webhook 节点生成的回调地址会基于这个。n8n_data卷挂到/home/node/.n8n这里存 N8N 的配置文件和一些本地缓存。虽然数据主要在 PostgreSQL 里但这个卷也建议保留。启动命令docker compose up -d启动后检查容器状态docker compose ps你应该看到两个容器都是running状态PostgreSQL 显示healthy。如果 N8N 反复重启看日志docker compose logs n8n --tail 50常见错误是数据库连接失败日志里会显示Connection refused或password authentication failed。检查DB_POSTGRESDB_*变量是否和 PostgreSQL 的POSTGRES_*一致。环境变量清单整理成表格方便对照变量名作用示例值DB_TYPE数据库类型postgresdbDB_POSTGRESDB_HOST数据库主机postgresDB_POSTGRESDB_PORT数据库端口5432DB_POSTGRESDB_DATABASE数据库名n8nDB_POSTGRESDB_USER数据库用户n8nDB_POSTGRESDB_PASSWORD数据库密码你的密码DB_POSTGRESDB_SCHEMAschemapublicN8N_ENCRYPTION_KEY凭证加密密钥32位随机串N8N_DEFAULT_LOCALE界面语言zh-CNN8N_SECURE_COOKIE安全CookiefalseWEBHOOK_URLWebhook回调地址http://ip:5678/GENERIC_TIMEZONE时区Asia/Shanghai这份配置我实测下来可以直接用改三个地方PostgreSQL 密码、N8N_ENCRYPTION_KEY、WEBHOOK_URL。其他保持默认即可。如果你用外部 PostgreSQL 而不是 docker-compose 里的把DB_POSTGRESDB_HOST改成外部数据库 IPDB_POSTGRESDB_PORT改成对应端口然后删掉 postgres 服务和 depends_on 配置。4. 验证数据落库与重启恢复测试配置跑起来后要验证两件事数据确实写进了 PostgreSQL以及容器重启后数据能恢复。这一节给具体操作步骤。先验证数据落库。用docker compose exec进入 PostgreSQL 容器docker compose exec postgres psql -U n8n -d n8n进入 psql 后列出所有表\dt你应该看到 N8N 自动创建的表包括workflow_entity、credentials_entity、execution_entity、shared_workflow、tag_entity等。如果这些表存在说明 N8N 成功连上了 PostgreSQL 并完成了 schema 初始化。查一下工作流表SELECT id, name, active FROM workflow_entity;刚部署时可能是空的因为你还没创建工作流。去 N8N 界面创建一个测试工作流比如一个手动触发节点加一个 Set 节点保存后回到 psql 再查应该能看到记录。查凭证表SELECT id, name, type FROM credentials_entity;你在 N8N 里创建的 TaoToken 凭证会出现在这里。注意data字段是加密的看不到明文这是正常的。查执行记录SELECT id, workflow_id, status, started_at FROM execution_entity ORDER BY started_at DESC LIMIT 10;每次工作流执行都会写一条记录。执行几次工作流后这里应该有数据。验证完落库做重启恢复测试。先记录当前工作流数量SELECT COUNT(*) FROM workflow_entity;假设是 3 个。然后退出 psql重启 N8N 容器docker compose restart n8n等 N8N 重新启动后刷新浏览器界面检查工作流是否还在。再进 psql 查一次SELECT COUNT(*) FROM workflow_entity;如果还是 3说明数据从 PostgreSQL 恢复了。再测一个更彻底的删掉 N8N 容器重建docker compose down n8n docker compose up -d n8n注意这里只 down 了 n8n 服务没动 postgres。重建后 N8N 从数据库读回所有数据工作流和凭证原样恢复。这就是数据持久化的效果。如果你想测极端情况把两个容器都停掉再启动docker compose down docker compose up -d因为postgres_data卷还在数据不会丢。只有执行docker compose down -v才会删卷那时候数据才真的没了。生产环境千万别加-v。验证 TaoToken 凭证在重启后是否可用。重启 N8N 后打开之前用 TaoToken 凭证的工作流执行一次。如果模型正常返回说明凭证解密成功N8N_ENCRYPTION_KEY配置正确。这里有个排查点如果重启后凭证报Could not decrypt credentials说明N8N_ENCRYPTION_KEY变了。检查环境变量是否固定有没有被 docker-compose 重新生成。再给一个数据备份的命令生产环境建议定期跑docker compose exec postgres pg_dump -U n8n -d n8n n8n_backup_$(date %Y%m%d).sql这个命令把整个 N8N 数据库导出成 SQL 文件恢复时用psql导入即可。备份文件建议存到对象存储或者另一台机器。恢复命令cat n8n_backup_20250607.sql | docker compose exec -T postgres psql -U n8n -d n8n注意恢复前最好停掉 N8N避免写入冲突。5. 本篇常见错误排查401、local proxy failed、reading choices、OAuth部署过程中会遇到几类典型报错这一节逐个拆解。每个报错给现象、原因、解决步骤。第一类数据库连接报错。N8N 启动日志出现Error: connect ECONNREFUSED 172.x.x.x:5432或者password authentication failed for user n8n。原因是 N8N 连不上 PostgreSQL或者账号密码不对。排查步骤先确认 PostgreSQL 容器在跑docker compose ps看状态。然后检查DB_POSTGRESDB_HOST是否填的postgresdocker-compose 服务名如果你填了localhost那肯定连不上因为容器里的 localhost 是容器自己。密码不一致也会报这个对照POSTGRES_PASSWORD和DB_POSTGRESDB_PASSWORD是否一样。第二类401 报错。在 N8N 里调 TaoToken 接口时返回401 Unauthorized。原因是 API Key 不对或者 Base URL 配错。排查步骤检查 N8N 凭证里的 API Key 是否是 TaoToken 的 Key有没有多余空格。检查 Base URL 是否是https://taotoken.net/api注意结尾不要加/v1TaoToken 的地址已经包含了版本路径。如果还报 401去 TaoToken Console 确认 Key 是否有效、额度是否充足。第三类local proxy failed报错。这个通常出现在 N8N 容器访问外部 API 时日志显示local proxy failed或者getaddrinfo EAI_AGAIN。原因是容器内 DNS 解析失败或者网络不通。排查步骤进 N8N 容器测试网络docker compose exec n8n sh wget -qO- https://taotoken.net/api如果 wget 失败检查 docker 网络配置。有时候是宿主机的 DNS 问题在 docker-compose 里给 N8N 服务加dns: 8.8.8.8可以解决。另外检查防火墙是否放行了出站 443 端口。第四类reading choices报错。N8N 的 OpenAI 节点返回Cannot read properties of undefined (reading choices)。原因是接口返回格式不对通常是 Base URL 配错导致返回了 HTML 错误页而不是 JSON。排查步骤确认 Base URL 是https://taotoken.net/api模型 ID 是 TaoToken 支持的模型名。如果模型 ID 写错TaoToken 可能返回错误信息N8N 解析不到choices字段就报这个错。去 TaoToken 文档查支持的模型列表确认模型 ID 拼写正确。第五类OAuth 报错。如果你在 N8N 里配置了需要 OAuth 的节点比如 Google、GitHub回调时报OAuth callback failed或者redirect_uri_mismatch。原因是WEBHOOK_URL配置不对OAuth 回调地址不匹配。排查步骤确认WEBHOOK_URL填的是外部可访问的地址比如http://your-server-ip:5678/。如果你用了域名填域名。OAuth 应用里配置的回调地址要和这个一致。另外N8N_SECURE_COOKIE如果设为 true 但用的是 HTTPOAuth 流程也会失败测试环境设为 false。第六类N8N 界面能打开但工作流执行卡住。日志显示Execution failed但没有具体错误。排查步骤看execution_entity表里的data字段里面有详细错误信息SELECT data FROM execution_entity WHERE status error ORDER BY started_at DESC LIMIT 1;或者直接在 N8N 界面点开执行记录看详情。常见原因是数据库连接池耗尽检查 PostgreSQL 的max_connections是否够用。N8N 默认连接池大小是 10如果并发高可以调大DB_POSTGRESDB_POOL_SIZE。第七类TaoToken 调用返回model not found。原因是模型 ID 不在 TaoToken 支持列表里。解决去 TaoToken 官网或 Console 查看可用模型用准确的模型 ID。比如 Claude 系列要用claude-sonnet-4-20250514这种完整名称不能简写。排查思路总结成一句话先看日志定位是数据库问题还是 API 问题数据库问题查连接参数API 问题查 Key 和 Base URL。N8N 的日志在docker compose logs n8n里PostgreSQL 的日志在docker compose logs postgres里。6. 长期编码与 Agent 场景的 CTAN8N 生产环境部署跑通后下一步就是接实际业务。如果你在 N8N 里做长期编码任务或者 Agent 工作流TaoToken 的 Coding Plan 适合这种场景。Coding Plan 提供稳定的 API 额度和统一的 Key 管理不用每次换模型都改配置。具体操作路径访问 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content了解 Coding Plan 详情。然后在 Console 里创建 API Key地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。创建好 Key 后在 N8N 的 OpenAI 凭证里填入Base URL 用https://taotoken.net/api。如果你还没配好 N8N 的凭证接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有各语言的调用示例。想先测试模型对话效果可以用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content在线试。N8N 里配置 TaoToken 的三件套再强调一遍Base URL 填https://taotoken.net/apiAPI Key 填 TaoToken 的 KeyModel ID 填具体模型名比如claude-sonnet-4-20250514。这三个填对N8N 就能通过 TaoToken 调模型。如果你用 Claude Code 做编码TaoToken 也支持 Anthropic 接口格式配置地址在https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。N8N 里如果要调 Claude 的 Anthropic 原生接口也可以用这个地址。最后给一个 N8N 工作流里用 TaoToken 的实用技巧把 TaoToken 凭证设成共享凭证团队里其他人用同一个凭证不用每人配 Key。在 N8N 的 Credentials 里点凭证右上角选择 Share添加团队成员。这样统一 Key 管理的优势就体现出来了——一个人维护 Key全团队用。生产环境部署 N8N 的核心就是数据持久化加统一 Key 管理。PostgreSQL 保证数据不丢TaoToken 保证 API 调用不乱。这两件事做好N8N 就能稳定跑在生产环境里。