在 OpenShift Local (CRC) 上托管 n8n
本指南将引导你在 OpenShift Local (CRC) 上部署 n8n。CRC 是 Red Hat 提供的本地 OpenShift 集群运行工具。它与 AWS/EKS 部署方式类似,但完全在本地机器上运行。适用于在本地 OpenShift 环境中测试 n8n,无需承担云服务费用。
由于 OpenShift 本身消耗大量资源,你需要一台拥有充足资源的机器。
OpenShift 概念与标准 Kubernetes
OpenShift 基于 Kubernetes 构建,但使用不同的术语,并且具有更严格的安全默认设置。如果你熟悉标准 Kubernetes 或针对 EKS 等托管 Kubernetes 服务的指南,下表列出了对应的概念映射,帮助你了解差异。
| 标准 Kubernetes / EKS | OpenShift Local (CRC) |
|---|---|
kubectl |
oc(OpenShift CLI;也支持 kubectl 命令) |
| Namespace | Project(相同概念,不同命令) |
| Ingress / LoadBalancer | Route(OpenShift 内置,无需额外控制器) |
| EBS StorageClass (gp3) | CRC 内置存储供应器(无需配置) |
| RDS PostgreSQL | 集群内 PostgreSQL(通过 Helm Bitnami 部署) |
| ElastiCache Redis | 集群内 Redis(通过 Helm Bitnami 部署) |
| AWS S3 | 集群内 MinIO(S3 兼容) |
| Pod Identity / IRSA | 通过 Kubernetes Secret 管理访问密钥 |
| AWS Load Balancer Controller | 不需要(Route 已内置) |
| OIDC / IAM | 不需要 |
| 约 $135–400/月 | 免费(在你的机器上运行) |
先决条件
开始之前,请确认你的机器满足以下要求:
- CPU:4 个或更多物理核心(不仅仅是线程),且支持虚拟化
- 内存:至少 32 GB 可用空闲内存(CRC 为其虚拟机保留 9 GB)
- 磁盘:100 GB 可用空间
- 操作系统:Ubuntu(22.04 LTS 或更新版本)
准备 Ubuntu
打开终端
按 Ctrl+Alt+T 或在应用程序菜单中搜索 Terminal。
本指南中的每个命令都在终端中输入,按 Enter 执行。
更新您的系统
首先进行系统更新,以避免依赖问题:
sudo apt update && sudo apt upgrade -y
提示
sudo 须藤
sudo 表示“以管理员身份运行”。系统将提示您输入密码。您输入的字符不会出现在屏幕上,这是正常现象。
检查CPU虚拟化支持
CRC 运行在虚拟机上,你的 CPU 必须支持硬件虚拟化:
egrep -c '(vmx|svm)' /proc/cpuinfo
- 输出
0:虚拟化未启用。进入 BIOS/UEFI 设置,启用 VT-x(Intel)或 AMD-V(AMD),然后重启再试。 - 输出
1或更高:可以继续。
安装 KVM 和 libvirt
KVM 是 Linux 内置的虚拟化引擎。CRC 使用它来运行 OpenShift 集群虚拟机:
sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils
安装 virtiofsd,CRC 需要它来与集群虚拟机共享文件系统:
sudo apt install -y virtiofsd
启动 libvirt 服务并设置为开机自启:
sudo systemctl start libvirtd
sudo systemctl enable libvirtd
验证其是否正在运行:
sudo systemctl status libvirtd
查看是否显示绿色的 Active: active (running)。按 q 退出。
将用户添加到所需组
这样你就可以使用 KVM 和 libvirt,而无需每条命令都输入 sudo:
sudo usermod -aG libvirt $USER
sudo usermod -aG kvm $USER
提示
Warning 警告
You must log out and log back in (or reboot) for this to take effect. 您必须注销并重新登录(或重新启动)才能生效。 如果跳过此步骤,CRC 将失败并出现“权限被拒绝”错误。
立即重启:
sudo reboot
重新登录后,打开终端并验证用户组成员身份:
groups
你应该能看到列出了 libvirt 和 kvm。
安装 NetworkManager
CRC 需要 NetworkManager 来管理集群内部域名的 DNS 条目(*.apps-crc.testing、api.crc.testing):
sudo apt install -y network-manager
sudo systemctl start NetworkManager
sudo systemctl enable NetworkManager
验证连接状态:
nmcli general status
STATE 列应显示 connected。
安装工具
获取红帽帐户并提取秘密
CRC 需要一个免费的 Red Hat 账号来拉取容器镜像。
- 如果还没有,创建一个免费的 Red Hat 账号。
- 在 console.redhat.com/openshift/create/local 页面,点击 Download OpenShift Local。
- 选择 Linux,将
.tar.xz文件下载到~/Downloads。 - 在 Red Hat 控制台的同一页面,点击 Copy pull secret。将其粘贴到文本文件中保存备用。
安装CRC
在 Downloads 文件夹中打开终端。
cd ~/Downloads
解压归档文件。
tar xf crc-linux-amd64.tar.xz
将 crc 二进制文件移动到系统级目录,以便在任何终端中使用:
sudo mv crc-*-linux-amd64/crc /usr/local/bin/
验证安装:
crc version
终端应输出版本号。
安装 Helm
Helm 用于将 n8n 及其支持服务安装到集群中:
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
验证:
helm version
设置环境变量
export NAMESPACE=n8n-$(date +%Y%m%d)
echo "Namespace:$NAMESPACE"
提示
Variable persistence 可变持久性
这些变量仅持续当前终端会话。每当您打开新终端时,请重新运行此行,然后再继续。
启动 OpenShift 本地
运行 CRC 设置
只需运行一次。它会配置 KVM 网络、检查系统要求,并下载 CRC 包(约 2.5 GB):
crc setup
这需要几分钟时间。如果提示缺少任何软件包,使用 sudo apt install -y <package-name> 安装后重新运行。
配置CRC内存并启动集群
CRC 默认为虚拟机分配 9 GB 内存。n8n 及其支持服务需要更多资源。在启动前将内存设置为 14 GB:
crc config set memory 14336
此设置只需运行一次,会在 crc stop / crc start 周期中持久保留。
建议: 先将 pull secret 保存到文件,这样就不用每次都粘贴:
# Open the file, paste your pull secret (from earlier), then Ctrl+O to save, Ctrl+X to exit <a href="#open-the-file-paste-your-pull-secret-from-earlier-then-ctrlo-to-save-ctrlx-to-exit" id="open-the-file-paste-your-pull-secret-from-earlier-then-ctrlo-to-save-ctrlx-to-exit"></a>
nano ~/pull-secret.txt
# Restrict permissions so only you can read it <a href="#restrict-permissions-so-only-you-can-read-it" id="restrict-permissions-so-only-you-can-read-it"></a>
chmod 600 ~/pull-secret.txt
使用文件启动 CRC:
crc start --pull-secret-file ~/pull-secret.txt
也可以不带参数直接运行 crc start,在提示时粘贴 secret。
这需要 10–15 分钟。 完成后你会看到类似以下输出:
Started the OpenShift cluster.
The server is accessible via web console at:
https://console-openshift-console.apps-crc.testing
Log in as administrator:
Username: kubeadmin
Password: <generated-password>
Log in as user:
Username: developer
Password: developer
立即保存 kubeadmin 密码。 下一步会用到它。之后可以通过 crc console --credentials 重新获取。
验证 DNS 解析
在 Ubuntu 上,CRC 会通过 NetworkManager 和 systemd-resolved 自动配置系统解析器,无需手动添加 /etc/hosts 条目。
验证 API 是否可达:
sudo ss -tlnp | grep 6443
你应该能看到一个绑定在 127.0.0.1:6443 上的进程。如果没有输出,重新运行 crc start。如果 DNS 无法解析 *.apps-crc.testing,请参阅故障排除部分。
配置你的 shell
CRC 在虚拟机内打包了 oc CLI。以下命令使其在你的终端中可用:
eval $(crc oc-env)
要使此设置永久生效,避免每次打开终端都要重新运行:
echo 'eval $(crc oc-env)' >> ~/.bashrc
source ~/.bashrc
验证 oc 是否正常工作:
oc version
登录集群
oc login -u kubeadmin -p <your-kubeadmin-password> https://api.crc.testing:6443
将 <your-kubeadmin-password> 替换为配置 CRC 内存并启动集群时输出的密码。
验证是否已登录:
oc whoami
屏幕上应显示 kubeadmin。
单机部署
单实例模式将 n8n 作为单个 Pod 运行,使用 SQLite 数据库。不需要外部数据库或 Redis。适合在本地探索 n8n 和测试工作流。
创建项目
在 OpenShift 中,Project 等同于 Kubernetes 的 Namespace:一个用于隔离资源的独立空间:
oc new-project $NAMESPACE
授予所需的安全权限
OpenShift 强制执行名为 Security Context Constraints (SCCs) 的严格安全策略。默认情况下,Pod 不能以特定用户 ID 运行。n8n chart 以用户 ID 1000 运行,因此你必须显式允许此操作。
使用完整的显式形式。简写的 -z 标志在某些 OpenShift 版本中可能会静默失败:
oc adm policy add-scc-to-user anyuid \
system:serviceaccount:$NAMESPACE:n8n
验证绑定是否已创建:
oc get rolebindings -n $NAMESPACE
你应该能看到引用了 system:openshift:scc:anyuid 的绑定。
创建所需的秘密
oc create secret generic n8n-secrets \
--namespace $NAMESPACE \
--from-literal=N8N_ENCRYPTION_KEY="$(openssl rand -hex 32)" \
--from-literal=N8N_HOST="localhost" \
--from-literal=N8N_PORT="5678" \
--from-literal=N8N_PROTOCOL="http"
立即备份加密密钥:
oc get secret n8n-secrets -n $NAMESPACE \
-o jsonpath='{.data.N8N_ENCRYPTION_KEY}' | base64 --decode
复制输出并保存到安全的地方。丢失加密密钥意味着工作流中存储的所有凭据将永久不可读。
创建您的值文件
创建名为 n8n-standalone-values.yaml 的文件。你可以使用 nano(一个简单的文本编辑器):
nano n8n-standalone-values.yaml
粘贴以下内容,然后按 Ctrl+O 保存,Ctrl+X 退出:
# n8n-standalone-values.yaml <a href="#n8n-standalone-valuesyaml" id="n8n-standalone-valuesyaml"></a>
# Single pod, SQLite database, no external dependencies. <a href="#single-pod-sqlite-database-no-external-dependencies" id="single-pod-sqlite-database-no-external-dependencies"></a>
queueMode:
enabled: false
database:
type: sqlite
useExternal: false
redis:
enabled: false
# PVC stores the SQLite database file. <a href="#pvc-stores-the-sqlite-database-file" id="pvc-stores-the-sqlite-database-file"></a>
persistence:
enabled: true
size: 5Gi
# No storageClassName needed — CRC provides a default storage provisioner.
secretRefs:
existingSecret: "n8n-secrets"
service:
type: ClusterIP
port: 5678
# OpenShift: securityContext must be enabled so the pod runs as UID 1000 (node user) <a href="#openshift-securitycontext-must-be-enabled-so-the-pod-runs-as-uid-1000-node-user" id="openshift-securitycontext-must-be-enabled-so-the-pod-runs-as-uid-1000-node-user"></a>
# with fsGroup 1000 (so the PVC is writable). The anyuid SCC granted above <a href="#with-fsgroup-1000-so-the-pvc-is-writable-the-anyuid-scc-granted-above" id="with-fsgroup-1000-so-the-pvc-is-writable-the-anyuid-scc-granted-above"></a>
# allows this. The seccompProfile line is removed from the chart template in <a href="#allows-this-the-seccompprofile-line-is-removed-from-the-chart-template-in" id="allows-this-the-seccompprofile-line-is-removed-from-the-chart-template-in"></a>
# "Deploy n8n" because OpenShift 4.14+ rejects it even with anyuid. <a href="#deploy-n8n-because-openshift-414-rejects-it-even-with-anyuid" id="deploy-n8n-because-openshift-414-rejects-it-even-with-anyuid"></a>
securityContext:
enabled: true
resources:
main:
requests:
cpu: 100m
memory: 256Mi
limits:
cpu: "1"
memory: 1Gi
config:
timezone: UTC
部署 n8n
n8n Helm chart 在 Pod 规格中硬编码了 seccompProfile: RuntimeDefault。OpenShift 4.14+ 会将其转换为已弃用的 alpha 注解,即使授予了 anyuid SCC 也会在准入时被拒绝。解决方法是将 chart 拉取到本地,删除这两行,然后从修补后的副本进行安装。
拉取并修补 chart:
helm pull oci://ghcr.io/n8n-io/n8n-helm-chart/n8n --version 1.0.3 --untar
sed -i '/seccompProfile:/d; /type: RuntimeDefault/d' ~/n8n/templates/deployment-main.yaml
# Confirm the lines are gone (should return no output) <a href="#confirm-the-lines-are-gone-should-return-no-output" id="confirm-the-lines-are-gone-should-return-no-output"></a>
grep -n "seccomp\|RuntimeDefault" ~/n8n/templates/deployment-main.yaml
从修补后的 chart 安装:
helm install n8n ~/n8n/ \
--namespace $NAMESPACE \
--values n8n-standalone-values.yaml \
--wait \
--timeout 10m
使用端口转发 访问 n8n
OpenShift Route 需要主机名,这会增加单实例本地访问的复杂性。端口转发更简单:
oc port-forward service/n8n-main --namespace $NAMESPACE 5678:5678
保持此命令运行,然后在浏览器中打开:
http://localhost:5678
n8n 会提示你创建一个管理员账号。
提示
Stop tunnel 停止隧道
按 Ctrl+C 停止隧道。稍后重新运行 port-forward 命令即可再次访问 n8n。
检查部署状态
oc get pods -n $NAMESPACE
预期输出:
NAME READY STATUS RESTARTS AGE
n8n-main-7d9f8b-xxxx 1/1 Running 0 3m
单实例部署完成。
多实例队列模式
多实例队列模式运行多个 n8n Pod,共享数据库、消息队列和对象存储。需要 n8n Enterprise 许可证。
本指南使用集群内等效服务替代 AWS 托管服务,与本地或客户 OpenShift 环境一致:
| AWS 服务 | 本地等效方案 |
|---|---|
| RDS PostgreSQL | PostgreSQL(Bitnami Helm图表) |
| ElastiCache Redis | Redis(Bitnami Helm图表) |
| S3 | MinIO(S3 兼容,Bitnami Helm chart) |
安装集群内服务
创建项目并添加 Bitnami Helm 存储库
oc new-project $NAMESPACE
添加 Bitnami chart 仓库(只需执行一次):
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
安装 PostgreSQL
在以下命令中,将 YourStrongPassword123 替换为一个合适的复杂密码。
helm install postgresql bitnami/postgresql \
--namespace $NAMESPACE \
--set auth.username=n8n \
--set auth.password='YourStrongPassword123' \
--set auth.database=n8n_enterprise \
--set global.compatibility.openshift.adaptSecurityContext=auto \
--wait
提示
Flag 旗帜
global.compatibility.openshift.adaptSecurityContext=auto 标志告诉 Bitnami 让 OpenShift 自动分配正确的用户 ID(避免 SCC 错误)。
保存端点地址,集群内服务的地址是固定的:
postgresql.YOUR_NAMESPACE.svc.cluster.local
将 YOUR_NAMESPACE 替换为你的实际 $NAMESPACE 值(例如 n8n-20260306)。
安装 Redis
helm install redis bitnami/redis \
--namespace $NAMESPACE \
--set auth.enabled=false \
--set architecture=standalone \
--set global.compatibility.openshift.adaptSecurityContext=auto \
--wait
Redis 端点:redis-master.$NAMESPACE.svc.cluster.local
安装 MinIO(S3 兼容存储)
在以下命令中,将 MinioStrongPassword123 替换为一个合适的复杂密码。
helm install minio bitnami/minio \
--namespace $NAMESPACE \
--set auth.rootUser=minioadmin \
--set auth.rootPassword='MinioStrongPassword123' \
--set global.compatibility.openshift.adaptSecurityContext=auto \
--wait
MinIO 端点:http://minio:9000(在同一 Namespace 内,直接使用服务名即可)
在 MinIO 中创建 n8n 存储桶
n8n 使用前需要先在 MinIO 中创建存储桶。通过 MinIO 网页控制台操作:
打开 MinIO 控制台:
oc port-forward svc/minio 9001:9001 -n $NAMESPACE
保持此命令运行,然后在浏览器中打开 http://localhost:9001。
使用以下凭据登录:
- 用户名: minioadmin
- 密码: MinioStrongPassword123
在控制台中:
1. 点击左侧边栏的 Buckets → Create Bucket
2. Bucket Name: 桶名称: n8n-data
3. 点击 Create Bucket
回到终端,按 Ctrl+C 停止端口转发。
部署 n8n
为 n8n 授予 SCC
oc adm policy add-scc-to-user anyuid \
system:serviceaccount:$NAMESPACE:n8n-enterprise
验证 oc get rolebindings -n $NAMESPACE 显示了 system:openshift:scc:anyuid 的绑定。
创建所需的秘密
# Core n8n secrets <a href="#core-n8n-secrets" id="core-n8n-secrets"></a>
oc create secret generic n8n-enterprise-secrets \
--namespace $NAMESPACE \
--from-literal=N8N_ENCRYPTION_KEY="$(openssl rand -hex 32)" \
--from-literal=N8N_HOST="localhost" \
--from-literal=N8N_PORT="5678" \
--from-literal=N8N_PROTOCOL="http"
立即备份加密密钥:
oc get secret n8n-enterprise-secrets -n $NAMESPACE \
-o jsonpath='{.data.N8N_ENCRYPTION_KEY}' | base64 --decode
将该值保存到安全的地方。
在以下命令中,将 YourStrongPassword123 和 MinioStrongPassword123 替换为之前步骤中设置的密码。
# Database password (must match what you set when installing PostgreSQL) <a href="#database-password-must-match-what-you-set-when-installing-postgresql" id="database-password-must-match-what-you-set-when-installing-postgresql"></a>
oc create secret generic n8n-enterprise-db-secret \
--namespace $NAMESPACE \
--from-literal=password='YourStrongPassword123'
# MinIO credentials <a href="#minio-credentials" id="minio-credentials"></a>
oc create secret generic n8n-minio-secret \
--namespace $NAMESPACE \
--from-literal=root-password='MinioStrongPassword123'
创建值文件
创建 n8n-multimain-ocp-values.yaml。替换标记为 # <-- REPLACE 的 3 个占位值:
nano n8n-multimain-ocp-values.yaml
# n8n-multimain-ocp-values.yaml <a href="#n8n-multimain-ocp-valuesyaml" id="n8n-multimain-ocp-valuesyaml"></a>
# Multi-instance queue mode for OpenShift Local (CRC). <a href="#multi-instance-queue-mode-for-openshift-local-crc" id="multi-instance-queue-mode-for-openshift-local-crc"></a>
# Uses in-cluster PostgreSQL, Redis, and MinIO instead of AWS services. <a href="#uses-in-cluster-postgresql-redis-and-minio-instead-of-aws-services" id="uses-in-cluster-postgresql-redis-and-minio-instead-of-aws-services"></a>
# Requires Enterprise license. <a href="#requires-enterprise-license" id="requires-enterprise-license"></a>
# --- Enterprise license --- <a href="#enterprise-license" id="enterprise-license"></a>
license:
enabled: true
activationKey: "your-enterprise-license-key-here" # <-- REPLACE
# --- Multi-main: 2 replicas (reduced for local resources) --- <a href="#multi-main-2-replicas-reduced-for-local-resources" id="multi-main-2-replicas-reduced-for-local-resources"></a>
multiMain:
enabled: true
replicas: 2
# --- Queue mode: 2 worker pods --- <a href="#queue-mode-2-worker-pods" id="queue-mode-2-worker-pods"></a>
queueMode:
enabled: true
workerReplicaCount: 2
workerConcurrency: 5
# --- Webhook processors --- <a href="#webhook-processors" id="webhook-processors"></a>
webhookProcessor:
enabled: true
replicaCount: 1
disableProductionWebhooksOnMainProcess: true
# --- PostgreSQL (in-cluster) --- <a href="#postgresql-in-cluster" id="postgresql-in-cluster"></a>
database:
type: postgresdb
useExternal: true
host: "postgresql.YOUR_NAMESPACE.svc.cluster.local" # <-- REPLACE YOUR_NAMESPACE
port: 5432
database: n8n_enterprise
schema: "public"
user: n8n
passwordSecret:
name: "n8n-enterprise-db-secret"
key: "password"
# --- Redis (in-cluster, no TLS) --- <a href="#redis-in-cluster-no-tls" id="redis-in-cluster-no-tls"></a>
redis:
enabled: true
useExternal: true
host: "redis-master.YOUR_NAMESPACE.svc.cluster.local" # <-- REPLACE YOUR_NAMESPACE
port: 6379
tls: false
# --- MinIO (S3-compatible, in-cluster) --- <a href="#minio-s3-compatible-in-cluster" id="minio-s3-compatible-in-cluster"></a>
s3:
enabled: true
bucket:
name: "n8n-data"
region: "us-east-1"
host: "http://minio:9000"
auth:
autoDetect: false
accessKeyId: "minioadmin"
secretAccessKeySecret:
name: "n8n-minio-secret"
key: "root-password"
storage:
mode: "s3"
availableModes: "filesystem,s3"
forcePathStyle: true
# --- Service account --- <a href="#service-account" id="service-account"></a>
serviceAccount:
create: true
name: n8n
保存并退出 nano(Ctrl+O,Ctrl+X)。
在部署之前,将两个 YOUR_NAMESPACE 占位符替换为你的实际 Namespace 值:
# Check your namespace value <a href="#check-your-namespace-value" id="check-your-namespace-value"></a>
echo $NAMESPACE
# Replace in the file (this edits it automatically) <a href="#replace-in-the-file-this-edits-it-automatically" id="replace-in-the-file-this-edits-it-automatically"></a>
sed -i "s/YOUR_NAMESPACE/$NAMESPACE/g" n8n-multimain-ocp-values.yaml
验证替换结果:
grep "svc.cluster.local" n8n-multimain-ocp-values.yaml
两行都应显示你的实际 Namespace 名称,而不是 YOUR_NAMESPACE。
部署 n8n
如果之前没有修补过 chart,现在拉取并修补:
helm pull oci://ghcr.io/n8n-io/n8n-helm-chart/n8n --version 1.0.3 --untar
sed -i '/seccompProfile:/d; /type: RuntimeDefault/d' ~/n8n/templates/deployment-main.yaml
grep -n "seccomp\|RuntimeDefault" ~/n8n/templates/deployment-main.yaml # should return nothing
从修补后的 chart 安装:
helm install n8n ~/n8n/ \
--namespace $NAMESPACE \
--values n8n-multimain-ocp-values.yaml \
--wait \
--timeout 15m
创建外部访问的路由
在 OpenShift 中,Route 将服务暴露给外部访问。它等同于 Kubernetes 的 Ingress 或 LoadBalancer,且无需额外的控制器:
oc expose svc/n8n-main -n $NAMESPACE
获取 URL:
export ROUTE=$(oc get route n8n-main -n $NAMESPACE -o jsonpath='{.spec.host}')
echo "n8n URL: http://$ROUTE"
URL 格式类似:http://n8n-main-n8n-20260306.apps-crc.testing
更新主机密钥
n8n 需要知道其公开 URL。使用 Route 主机名更新 Secret,然后重启 Pod:
ENCRYPTION_KEY=$(oc get secret n8n-enterprise-secrets -n $NAMESPACE \
-o jsonpath='{.data.N8N_ENCRYPTION_KEY}' | base64 --decode)
oc create secret generic n8n-enterprise-secrets \
--namespace $NAMESPACE \
--from-literal=N8N_ENCRYPTION_KEY="$ENCRYPTION_KEY" \
--from-literal=N8N_HOST="$ROUTE" \
--from-literal=N8N_PORT="5678" \
--from-literal=N8N_PROTOCOL="http" \
--dry-run=client -o yaml | oc apply -f -
oc rollout restart deployment -n $NAMESPACE
等待滚动更新完成:
oc rollout status deployment/n8n-main -n $NAMESPACE
验证所有 Pod 是否正在运行
oc get pods -n $NAMESPACE
预期输出(全部 Running):
NAME READY STATUS RESTARTS AGE
n8n-main-xxxx-aaaa 1/1 Running 0 5m
n8n-main-xxxx-bbbb 1/1 Running 0 5m
n8n-worker-xxxx-aaaa 1/1 Running 0 5m
n8n-worker-xxxx-bbbb 1/1 Running 0 5m
n8n-webhook-processor-xxxx-aaaa 1/1 Running 0 5m
postgresql-0 1/1 Running 0 15m
redis-master-0 1/1 Running 0 15m
minio-xxxx-xxxx 1/1 Running 0 15m
在浏览器中打开上面输出的 URL。
多实例部署完成。
更新 n8n
要更改配置或升级 chart 版本,请拉取并重新修补新版本的 chart,然后升级:
# Remove the old local chart copy <a href="#remove-the-old-local-chart-copy" id="remove-the-old-local-chart-copy"></a>
rm -rf ~/n8n/
# Pull and patch the new version <a href="#pull-and-patch-the-new-version" id="pull-and-patch-the-new-version"></a>
helm pull oci://ghcr.io/n8n-io/n8n-helm-chart/n8n --version <new-version> --untar
sed -i '/seccompProfile:/d; /type: RuntimeDefault/d' ~/n8n/templates/deployment-main.yaml
# Standalone <a href="#standalone" id="standalone"></a>
helm upgrade n8n ~/n8n/ \
--namespace $NAMESPACE \
--values n8n-standalone-values.yaml
# Multi-instance <a href="#multi-instance" id="multi-instance"></a>
helm upgrade n8n ~/n8n/ \
--namespace $NAMESPACE \
--values n8n-multimain-ocp-values.yaml
停止和恢复 CRC
CRC 无需在两次使用之间删除。你可以停止并重新启动:
# Stop the cluster (saves state) <a href="#stop-the-cluster-saves-state" id="stop-the-cluster-saves-state"></a>
crc stop
# Start it again later <a href="#start-it-again-later" id="start-it-again-later"></a>
crc start
重新启动后,重新运行:
eval $(crc oc-env)
export NAMESPACE=n8n-YYYYMMDD # use your original date
oc login -u kubeadmin -p <password> https://api.crc.testing:6443
故障排除
crc setup 失败并显示“libvirt not found”
sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients
sudo systemctl start libvirtd
然后重新运行 crc setup。
crc start 因“内存不足”而失败
CRC 至少需要 9 GB 可用内存。关闭其他应用程序后重试。如果你已按照配置 CRC 内存的说明操作,CRC 配置为使用 14 GB。
n8n pod 卡在 Pending 或从未创建过 SCC 错误
检查事件以查找错误:
oc get events -n $NAMESPACE --sort-by='.lastTimestamp' | tail -20
如果你看到 unable to validate against any security context constraint 或 seccomp may not be set,说明 chart 中硬编码的 seccompProfile: RuntimeDefault 被拒绝了。OpenShift 4.14+ 将其转换为已弃用的 alpha 注解,即使授予了 anyuid SCC,准入控制也会拒绝。
1. 使用显式形式授予 anyuid(简写的 -z 可能会静默失败):
# For standalone <a href="#for-standalone" id="for-standalone"></a>
oc adm policy add-scc-to-user anyuid \
system:serviceaccount:$NAMESPACE:n8n
# For multi-instance <a href="#for-multi-instance" id="for-multi-instance"></a>
oc adm policy add-scc-to-user anyuid \
system:serviceaccount:$NAMESPACE:n8n-enterprise
验证:运行 oc get rolebindings -n $NAMESPACE,应能看到 system:openshift:scc:anyuid 的绑定。
2. 将 chart 拉取到本地并删除 seccompProfile 相关行:
helm pull oci://ghcr.io/n8n-io/n8n-helm-chart/n8n --version 1.0.3 --untar
sed -i '/seccompProfile:/d; /type: RuntimeDefault/d' ~/n8n/templates/deployment-main.yaml
# Confirm they're gone (should return no output) <a href="#confirm-theyre-gone-should-return-no-output" id="confirm-theyre-gone-should-return-no-output"></a>
grep -n "seccomp\|RuntimeDefault" ~/n8n/templates/deployment-main.yaml
3. 卸载并从修补后的 chart 重新安装:
helm uninstall n8n -n $NAMESPACE
helm install n8n ~/n8n/ \
--namespace $NAMESPACE \
--values n8n-standalone-values.yaml \
--wait \
--timeout 10m
路由 URL 返回“应用程序不可用”
Pod 可能仍在启动中。检查:
oc get pods -n $NAMESPACE
oc rollout status deployment/n8n-main -n $NAMESPACE
同时确认 Route 是否存在:
oc get route -n $NAMESPACE
n8n pod 卡在 Pending 中,Insufficient memory
CRC 节点没有足够的空闲内存来调度 Pod。
解决方法: 增加 CRC 虚拟机的内存并重启:
crc stop
crc config set memory 14336
crc start
CRC 重启后,Pod 应会自动调度。如果几分钟后 Pod 仍处于 Pending 状态,可以删除它以强制重新调度:
oc delete pod -n $NAMESPACE -l app.kubernetes.io/component=main
如果你的机器无法分配 14 GB,也可以在 n8n-standalone-values.yaml 中降低 Pod 的内存请求:
resources:
main:
requests:
memory: 256Mi
然后升级:helm upgrade n8n ~/n8n/ -n $NAMESPACE -f n8n-standalone-values.yaml
DNS 无法解析 .apps-crc.testing 或 api.crc.testing
在 Ubuntu 上,CRC 会自动配置 DNS。如果失败,请重启 NetworkManager:
sudo systemctl restart NetworkManager
如果仍然无法解析,手动添加条目(CRC 通过 127.0.0.1 路由流量):
sudo tee -a /etc/hosts <<EOF
127.0.0.1 api.crc.testing
127.0.0.1 console-openshift-console.apps-crc.testing
127.0.0.1 oauth-openshift.apps-crc.testing
127.0.0.1 default-route-openshift-image-registry.apps-crc.testing
EOF
提示
Subdomains 子域
当您在多实例部分公开路由时,将创建新的 *.apps-crc.testing 子域。如果您的浏览器无法访问它们,请将它们添加到指向 127.0.0.1 的 /etc/hosts 中。
n8n pod 崩溃,EACCES: permission denied 写入 /home/node/.n8n/
这表示 Pod 以 OpenShift 随机分配的 UID 运行,而非 UID 1000(n8n 镜像期望的 node 用户)。当 values 文件中设置了 securityContext.enabled: false 而没有指定 runAsUser: 1000 和 fsGroup: 1000 时,OpenShift 会分配一个无法写入 PVC 的随机 UID。
解决方法: 确保 values 文件中设置了 securityContext.enabled: true,并且 chart 已修补删除了 seccompProfile(参见上方 SCC 错误部分)。两者都必须同时满足。
查看 Pod 日志
# Main process <a href="#main-process" id="main-process"></a>
oc logs -n $NAMESPACE -l app.kubernetes.io/component=main --tail=50
# Workers <a href="#workers" id="workers"></a>
oc logs -n $NAMESPACE -l app.kubernetes.io/component=worker --tail=50
# Webhook processors <a href="#webhook-processors" id="webhook-processors"></a>
oc logs -n $NAMESPACE -l app.kubernetes.io/component=webhook-processor --tail=50
命名空间 中的所有事件
oc get events -n $NAMESPACE --sort-by='.lastTimestamp'
快速参考
重新打开终端后重新导出变量
eval $(crc oc-env)
export NAMESPACE=n8n-YYYYMMDD # use the date from your original deployment
oc login -u kubeadmin -p <password> https://api.crc.testing:6443
检查集群状态
crc status
打开 OpenShift Web 控制台
crc console
使用 kubeadmin / 你的密码登录,即可查看所有运行中资源的图形化界面。
要保存的东西
| 项目 | 重要原因 |
|---|---|
kubeadmin 密码 |
登录集群 |
| n8n 加密密钥 | 丢失后所有存储的凭据将不可读 |
n8n-standalone-values.yaml |
helm upgrade 时需要 |
n8n-multimain-ocp-values.yaml |
helm upgrade 时需要 |
| MinIO root 密码 | 访问 MinIO 控制台 |
| PostgreSQL 密码 | 数据库访问 |
后续步骤
- 了解更多关于 n8n 配置和扩展的信息。
- 或继续探索如何使用 n8n:试试 Quickstarts 快速入门。
相关资源
- 使用云提供商
- 部署到 DigitalOcean
- 部署到 Heroku
- 部署到 Hetzner
- 部署到AWS
- 部署到 Azure
- 部署到 Google Cloud Run
- 部署到 Google Kubernetes
- 使用 Docker Compose