# n8n 可落地 Demo

这是一个单机 n8n 演示包：固定版本的 n8n 镜像、持久化数据卷和一份不需要外部账号的示例工作流。ZIP 不包含上游仓库源码或 Docker 镜像。上游：[n8n-io/n8n](https://github.com/n8n-io/n8n)；你的 Fork：[2514827566zzx-dev/n8n](https://github.com/2514827566zzx-dev/n8n)。

## 启动和体验

需要 Docker Engine/Desktop、Docker Compose v2+、Python 3 和可下载镜像的网络。建议至少 2 核、2 GB 可用内存。

1. 解压后执行 `python3 start.py`，自动生成本地加密密钥并启动 n8n `2.43.7`。
2. 执行 `python3 verify.py`，预期得到 `/healthz` 的 `HTTP 200`。打开 `http://127.0.0.1:3103` 并创建第一个账号。
3. 在工作流编辑器使用菜单中的“Import from File / 从文件导入”，选择 `examples/feedback-triage.json`。点击“Test workflow / 测试工作流”，末节点应输出 `route = 少送核对`、`next_step = 核对缺失商品与数量，证据不足时交人工`。

示例只在本地给固定文本分流，不读取真实订单，也不执行退款。n8n 的 SQLite 数据、工作流和账号保存在 Docker 命名卷 `n8n_data`。停止：`docker compose down`；不会删除卷。

## 部署边界

默认监听 `127.0.0.1:3103`，通过本机或 `ssh -L 3103:127.0.0.1:3103 用户@服务器` 访问。为了让本地 HTTP 登录可用，这个演示将 `N8N_SECURE_COOKIE` 设为 `false`；若要公网部署，必须改用 HTTPS、重新设置安全 Cookie、配置反向代理/域名和备份策略。不要把这个 Compose 文件直接暴露到互联网。

本包只展示核心工作流编辑和本地执行，不包含 n8n Assistant 的沙箱、SearXNG 或生产环境 PostgreSQL。参考：[官方 Docker Compose 安装](https://docs.n8n.io/deploy/host-n8n/install-options/install-using-docker-compose/) 与 [安全环境变量](https://docs.n8n.io/deploy/host-n8n/configure-n8n/basic-configuration/use-environment-variables/security.md)。
