别等服务器崩了才后悔：你的 n8n 数据库该“搬家”了
兄弟们，我是 N8N大学 的主编。如果你正在看这篇文章，大概率是遇到了 n8n 跑着跑着变慢，或者你正在规划把 n8n 推上生产环境。听我一句劝：千万别把 n8n 默认的 SQLite 拿来跑生产！
SQLite 就像是你刚学走路时的小推车，轻便、省事，零配置。但它本质上是个单机文件数据库。一旦你的工作流并发量上来，或者数据量超过了几个 G，它就会频繁锁死，导致整个 n8n 卡顿甚至直接罢工。为了让你的自动化流水线稳如老狗，把底座换成 PostgreSQL 是必经之路。
准备工作：磨刀不误砍柴工
在动手之前，笔者建议你先检查一下手头的资源。这事儿不复杂，但需要你对服务器有一定的掌控权。
- 一台运行中的 n8n 实例：通常是 Docker 环境。
- PostgreSQL 数据库：你可以用现有的，或者在服务器上快速起一个（比如用 Docker）。
- 终端访问权限：我们需要通过命令行来操作容器。
- 备份！备份！备份！：重要的话说三遍。虽然迁移通常是平滑的，但万一呢？把 n8n 的数据卷备份一下，心里踏实。
核心实操：三步完成数据库迁移
我们假设你使用的是 Docker 部署的 n8n（这也是最主流的方式）。整个过程分为：备份、配置新库、导入数据。
第一步：备份现有的 SQLite 数据
首先，我们需要把 SQLite 里的数据导出来，变成 PostgreSQL 能识别的 SQL 文件。这一步需要进入 n8n 的容器内部操作。
找到你的 n8n 容器名称或 ID（使用 docker ps），然后执行以下命令进入容器：
docker exec -it n8n-container-name bash
进入容器后，我们需要安装一个转换工具 pgloader。如果你的容器基础镜像是 Debian/Ubuntu，可以这样装：
apt-get update && apt-get install -y pgloader
接着，执行转换命令（注意替换路径）：
pgloader /home/node/.n8n/database.sqlite postgresql://user:password@host:port/dbname
注意：这里的 /home/node/.n8n/database.sqlite 是 n8n 默认的 SQLite 路径。如果你挂载了外部卷，请修改为你的实际路径。
第二步：修改 n8n 启动环境变量
数据导完后，我们需要告诉 n8n：“以后别用 SQLite 了，改用 PostgreSQL。” 这一步是在 Docker 的配置里完成的。
如果你是用 docker run 命令启动的，加上以下参数：
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=你的数据库地址
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n_user
DB_POSTGRESDB_PASSWORD=你的强密码
如果你是用 docker-compose.yml 启动的，请在 environment 部分添加这些配置。改完后，保存文件。
第三步：重启 n8n 服务
现在是最激动人心的时刻。停止旧的容器，然后重新启动它。
docker-compose down
docker-compose up -d
等待几十秒，访问你的 n8n 面板。如果一切正常，你应该能看到之前的工作流和凭据都在，而且感觉响应速度似乎快了一些。这时候，你可以把旧的 database.sqlite 文件删掉了（或者备份到别处）。
避坑指南：笔者踩过的雷，你别踩
虽然流程很顺畅，但实战中总有意外。以下是两个最常见的坑：
- 字符集编码报错： 如果你在导入数据时遇到
invalid byte sequence for encoding "UTF8"类错误，通常是因为 SQLite 里的数据包含了一些特殊字符。解决办法是在 pgloader 命令里加上编码参数，或者在创建 PostgreSQL 数据库时明确指定编码为UTF8。 - 容器启动失败： 重启后容器直接 Crash。查看日志
docker logs -f n8n-container，如果看到could not connect to server，说明环境变量没配对，或者网络不通。检查你的DB_POSTGRESDB_HOST是否正确，以及 PostgreSQL 是否允许远程连接（pg_hba.conf文件）。
FAQ 问答
Q1: 迁移过程中，我的工作流会中断吗？
A: 在迁移完成并重启 n8n 之前，旧的 n8n 实例（使用 SQLite）是正常运行的。但在重启切换到 PostgreSQL 的那一两分钟内，服务是不可用的。建议在业务低峰期操作。
Q2: 我可以直接把 SQLite 文件拿来覆盖 PostgreSQL 吗？
A: 不行。这是两种完全不同的数据库结构，数据格式也不兼容。必须通过 pgloader 这种转换工具或者 n8n 自带的迁移命令（如果有）来处理。
Q3: 迁移后感觉不到性能提升？
A: 如果你的工作流很少，数据量只有几千条，SQLite 和 PostgreSQL 的区别确实不大。PostgreSQL 的优势在于高并发和海量数据下的稳定性，这是为未来做准备。
总结与资源
将 SQLite 迁移至 PostgreSQL，是 n8n 从“玩具”走向“生产力工具”的关键一步。这不仅是为了性能，更是为了数据的安全性和扩展性。N8N大学 建议，只要你决定在生产环境长期使用，这一步越早做越好。
扩展阅读：
- n8n 官方文档：Database Configuration
- PostgreSQL Docker 部署最佳实践
