用 OrbStack 本地运行 n8n

1. 创建项目目录

新建n8n文件夹

mkdir -p ~/n8n
cd ~/n8n

2. 创建 docker-compose.yml 

# version: "3.8"
# this file uses prebuilt image in dockerhub

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
      # - ./n8n:/data # 将宿主机当前目录下的 'n8n' 子目录映射到容器的 '/data'
      - ./:/data #整个项目目录映射到容器 /data
    environment:
      - GENERIC_TIMEZONE=
      - TZ=
      - WEBHOOK_TUNNEL_URL=http://localhost:5678
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=
      - N8N_BASIC_AUTH_PASSWORD=
      - N8N_SECURE_COOKIE=false # 禁用 secure cookie（不推荐，但开发测试可用）
      # 禁用安全 Cookie 可能在部署到公网时带来安全隐患，仅适用于本地测试。

3. 启动服务

首次运行请先拉取镜像，然后启动服务。项目根目录 terminal 运行，vscode 可直接打开。

docker compose pull
docker compose up

4. 打开浏览器访问 n8n

浏览器访问地址：http://localhost:5678

5. 用 OrbStack 图形界面管理容器

OrbStack → Containers：

  • n8n
  • 状态为 Running
  • ▶ 启动 / ⏹ 停止 / 查看 Logs

项目目录结构示例

~/n8n/
├── docker-compose.yml
└──