Tóm tắt nhanh: Chạy n8n cục bộ yêu cầu npm (Node.js 20.19-24.x) hoặc Docker. Phương pháp nhanh nhất sử dụng npx n8n để kiểm tra ngay lập tức mà không cần cài đặt, trong khi Docker cung cấp khả năng cô lập tốt hơn và sẵn sàng cho sản xuất. Cả hai phương pháp đều cho phép bạn truy cập đầy đủ vào các khả năng tự động hóa quy trình làm việc của n8n mà không tốn chi phí đám mây định kỳ.
Thiết lập n8n trên máy cục bộ giúp loại bỏ các khoản phí đăng ký định kỳ đồng thời cung cấp quyền kiểm soát hoàn toàn đối với việc tự động hóa quy trình làm việc. Theo tài liệu chính thức của n8n, nền tảng này yêu cầu phiên bản Node.js từ 20.19 đến 24.x cho các bản cài đặt npm, hoặc Docker cho các triển khai đóng gói.
Quyết định giữa lưu trữ cục bộ và dịch vụ đám mây ảnh hưởng đến cả ngân sách và tính linh hoạt. Theo các cuộc thảo luận cộng đồng, các bản cài đặt cục bộ xử lý các quy trình làm việc không giới hạn, trong khi các gói đám mây bao gồm định giá dựa trên số lần thực thi (bắt đầu từ 24 USD/tháng cho 2.500 lần thực thi theo một số báo cáo của người dùng).
Điều kiện tiên quyết cho cài đặt cục bộ
Trước khi cài đặt n8n cục bộ, hệ thống cần phần mềm cụ thể tùy thuộc vào phương pháp được chọn.
Phiên bản Node.js yêu cầu cho bản cài đặt npm hoàn toàn phụ thuộc vào các yêu cầu cụ thể của phiên bản n8n bạn đang triển khai, vì bản thân npm tương thích với tất cả các phiên bản LTS được hỗ trợ hiện tại của Node.js. Tài liệu chính thức chỉ định phạm vi phiên bản chính xác này để tương thích. Kiểm tra phiên bản hiện tại bằng cách chạy node --version trong terminal.
Các bản cài đặt Docker yêu cầu Docker Engine hoặc Docker Desktop. Nhóm n8n khuyến nghị Docker cho hầu hết các nhu cầu tự lưu trữ vì nó cung cấp khả năng cô lập sạch sẽ và tránh các sự không tương thích với hệ điều hành.
Yêu cầu hệ thống
Các phiên bản n8n cục bộ chạy trên hệ thống Windows, macOS và Linux. Không có thông số kỹ thuật RAM tối thiểu nào xuất hiện trong tài liệu chính thức, nhưng độ phức tạp của quy trình làm việc sẽ xác định nhu cầu tài nguyên thực tế.
Ban đầu, quá trình cài đặt tiêu thụ dung lượng đĩa tối thiểu. Yêu cầu lưu trữ tăng lên dựa trên dữ liệu quy trình làm việc, lịch sử thực thi và các gói node tùy chỉnh.
Phương pháp 1: Chạy n8n bằng npm
Cài đặt npm cung cấp con đường nhanh nhất để chạy n8n cục bộ. Phương pháp này hoạt động trực tiếp trên hệ thống máy chủ mà không cần đóng gói.
Khởi động nhanh với npx
Cách đơn giản nhất sử dụng npx mà không cần cài đặt vĩnh viễn. Mở terminal và thực thi:
| npx n8n |
Lệnh này tải xuống mọi thứ cần thiết và khởi động n8n tự động. Giao diện trở nên có thể truy cập tại localhost:5678 trong vài giây.
Phương pháp npx hoạt động hoàn hảo để kiểm tra và đánh giá. Nó không yêu cầu các gói npm toàn cục hoặc các thay đổi hệ thống vĩnh viễn.
Cài đặt npm toàn cục
Để cài đặt vĩnh viễn, gói npm toàn cục cung cấp quyền truy cập nhất quán:
| npm install n8n -g |
Sau khi cài đặt hoàn tất, hãy khởi động n8n bất cứ lúc nào bằng cách chạy:
| n8n |
Phiên bản ổn định chính hiện tại của n8n là 2.x (ví dụ: 2.10.4). Các phiên bản beta có thể chứa các tính năng không ổn định và nên tránh sử dụng cho quy trình làm việc sản xuất.
Cấu hình và lưu trữ dữ liệu
Các bản cài đặt npm lưu trữ dữ liệu quy trình làm việc trong thư mục ~/.n8n theo mặc định. Vị trí này chứa thông tin đăng nhập, định nghĩa quy trình làm việc và lịch sử thực thi.
Các biến môi trường kiểm soát hành vi của n8n. Đặt biến N8N_PORT để thay đổi cổng mặc định 5678. Các biến khác cấu hình kết nối cơ sở dữ liệu, URL webhook và cài đặt xác thực.
Phương pháp 2: Chạy n8n bằng Docker
Cài đặt Docker đại diện cho phương pháp được khuyến nghị cho việc lưu trữ n8n cục bộ. Tài liệu chính thức nhấn mạnh Docker cho nhu cầu tự lưu trữ sản xuất.
Lệnh chạy Docker cơ bản
Khởi động n8n bằng một lệnh Docker duy nhất:
| docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Lệnh này tạo một container có tên n8n, ánh xạ cổng 5678 tới máy chủ và lưu trữ dữ liệu trong thư mục ~/.n8n.
Container chạy tương tác với cờ -it. Xóa --rm để giữ nguyên container sau khi dừng nó.
Docker Compose cho thiết lập sản xuất
Cấu hình Docker Compose cung cấp khả năng kiểm soát tốt hơn cho môi trường sản xuất. Kho lưu trữ n8n-hosting trên GitHub chứa các tệp Docker Compose sẵn sàng sử dụng cho các kiến trúc khác nhau.
Cấu hình docker-compose.yml cơ bản trông như thế này:
| version: '3.8' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=password volumes: - ~/.n8n:/home/node/.n8n |
Khởi động ngăn xếp bằng:
| docker-compose up -d |
Cờ -d chạy container ở chế độ tách biệt, cho phép sử dụng terminal cho các tác vụ khác.
Cấu hình ban đầu và truy cập
Sau khi khởi động n8n thông qua một trong hai phương pháp, hãy truy cập localhost:5678 trong trình duyệt web. Màn hình thiết lập ban đầu yêu cầu địa chỉ email và mật khẩu cho tài khoản quản trị.
Người dùng đầu tiên này sẽ trở thành chủ sở hữu phiên bản với đầy đủ quyền quản trị. Có thể thêm người dùng khác sau thông qua giao diện quản lý người dùng.
Thiết lập xác thực
Để bảo mật, hãy bật xác thực ngay cả trên các bản cài đặt cục bộ. Cấu hình Docker Compose chấp nhận các biến môi trường xác thực trực tiếp:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Các biến này kích hoạt xác thực cơ bản HTTP, yêu cầu thông tin đăng nhập cho mọi lần truy cập.
Kiểm tra các node tùy chỉnh cục bộ
Tài liệu chính thức giải thích cách kiểm tra các node tùy chỉnh trong quá trình phát triển. Cài đặt n8n toàn cục trước, sau đó xây dựng và liên kết gói node tùy chỉnh.
Trong thư mục node tùy chỉnh, chạy:
| npm run build npm link |
Sau đó, điều hướng đến thư mục node của n8n (thường là ~/.n8n/custom/) và liên kết gói:
| npm link <node-package-name> |
Node tùy chỉnh sẽ xuất hiện trong giao diện n8n sau khi khởi động lại phiên bản.
Tài nguyên tự động hóa hữu ích để sử dụng với n8n
Nếu bạn đang tìm hiểu cách chạy n8n cục bộ và kiểm tra quy trình làm việc trên máy của mình, bạn cũng có thể hưởng lợi từ các công cụ hỗ trợ và mẫu bên ngoài giúp tự động hóa các tác vụ phổ biến dễ dàng hơn. Get AI Perks cung cấp một thư viện các mẫu quy trình làm việc và các công cụ hỗ trợ AI mà bạn có thể sử dụng cùng với n8n hoặc để tạo mẫu ý tưởng tự động hóa trước khi tự mình xây dựng.
Với Get AI Perks, bạn có thể:
- Bắt đầu với các mẫu quy trình làm việc được tạo sẵn
- Nhận hỗ trợ AI cho logic và nội dung thông thường
- Khám phá các mẫu tự động hóa phổ biến trước khi triển khai chúng trong n8n
- Kết hợp các mẫu với thiết lập n8n cục bộ của bạn
Khám phá Get AI Perks để tìm các công cụ hỗ trợ tự động hóa cho quy trình làm việc n8n của bạn.
Xử lý sự cố các vấn đề phổ biến
Xung đột cổng là vấn đề cài đặt thường gặp nhất. Nếu cổng 5678 đã được sử dụng, hãy dừng dịch vụ xung đột hoặc thay đổi cổng của n8n bằng biến môi trường N8N_PORT.
Không tương thích phiên bản Node
Sử dụng các phiên bản Node.js ngoài phạm vi 20.19-24.x gây ra lỗi cài đặt. Kho lưu trữ GitHub của n8n ghi lại các vấn đề khi các nhà phát triển cố gắng thiết lập môi trường dev cục bộ, làm nổi bật tầm quan trọng của tính tương thích phiên bản Node.
Xác minh tính tương thích phiên bản Node trước khi khắc phục các sự cố khác. Chuyển đổi phiên bản Node bằng nvm (Node Version Manager) nếu cần.
Lỗi quyền truy cập Docker volume
Các vấn đề về quyền đối với việc gắn kết volume ~/.n8n ngăn chặn việc lưu trữ dữ liệu. Các container Docker chạy với tư cách người dùng node, người dùng này có thể không có quyền ghi vào thư mục máy chủ.
Tạo thư mục với các quyền thích hợp trước khi khởi động container:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Câu hỏi thường gặp
n8n có thể chạy mà không cần truy cập internet không?
Có, n8n hoạt động hoàn toàn ngoại tuyến cho các quy trình làm việc cục bộ. Kết nối internet chỉ cần thiết khi quy trình làm việc tương tác với các API bên ngoài hoặc dịch vụ đám mây.
Chi phí chạy n8n cục bộ là bao nhiêu?
Các bản cài đặt cục bộ là miễn phí. Phiên bản cộng đồng cung cấp tất cả các tính năng cốt lõi mà không tốn phí cấp phép. Lưu trữ đám mây bắt đầu với giới hạn số lần thực thi và chi phí hàng tháng, nhưng lưu trữ cục bộ loại bỏ hoàn toàn các giới hạn này theo các cuộc thảo luận cộng đồng.
Người mới bắt đầu có nên sử dụng npm hay Docker?
Người mới bắt đầu kiểm tra n8n nên bắt đầu với npx để truy cập ngay lập tức. Docker có ý nghĩa hơn cho việc sử dụng liên tục vì nó cung cấp khả năng cô lập tốt hơn và cập nhật dễ dàng hơn.
n8n lưu trữ dữ liệu quy trình làm việc cục bộ ở đâu?
Thư mục dữ liệu mặc định là ~/.n8n trong thư mục chính của người dùng. Vị trí này chứa các tệp cơ sở dữ liệu SQLite, thông tin đăng nhập và nhật ký thực thi trừ khi được cấu hình khác.
Có thể chạy nhiều phiên bản n8n trên một máy không?
Có, nhưng mỗi phiên bản cần một cổng duy nhất. Đặt các cổng khác nhau bằng cách sử dụng biến môi trường N8N_PORT cho mỗi phiên bản. Docker làm điều này dễ dàng hơn thông qua ánh xạ cổng trong các container riêng biệt.
Cập nhật hoạt động như thế nào đối với các bản cài đặt cục bộ?
Các bản cài đặt npm cập nhật thông qua npm update -g n8n hoặc npm install -g n8n@latest. Người dùng Docker tải xuống hình ảnh mới nhất với docker pull n8nio/n8n, sau đó tạo lại các container. Luôn sao lưu thư mục ~/.n8n trước khi cập nhật.
Cân nhắc cho sản xuất
Tài liệu chính thức của n8n nhấn mạnh rằng việc tự lưu trữ đòi hỏi kiến thức kỹ thuật. Thiết lập máy chủ, quản lý tài nguyên và bảo mật ứng dụng đòi hỏi kinh nghiệm với quản trị hệ thống.
Đối với các bản triển khai sản xuất, Docker Compose cung cấp nền tảng. Thêm một proxy ngược như nginx hoặc Caddy để hỗ trợ HTTPS. Kho lưu trữ n8n-hosting bao gồm các cấu hình Caddy sẵn sàng để triển khai.
Việc lựa chọn cơ sở dữ liệu rất quan trọng đối với khối lượng công việc lớn. Cơ sở dữ liệu SQLite mặc định hoạt động tốt cho việc sử dụng trung bình, nhưng PostgreSQL cung cấp hiệu suất tốt hơn cho tự động hóa khối lượng lớn theo hướng dẫn chính thức.
Đưa ra lựa chọn: Cục bộ so với Đám mây
Lưu trữ n8n cục bộ phù hợp với các nhóm có năng lực kỹ thuật và yêu cầu bảo mật cụ thể. Dữ liệu nằm trên cơ sở hạ tầng được kiểm soát và giới hạn thực thi biến mất.
Tuy nhiên, lưu trữ cục bộ đòi hỏi bảo trì, sao lưu và giám sát. Lưu trữ đám mây chuyển các trách nhiệm này cho nhóm cơ sở hạ tầng của n8n. Kiểm tra trang web chính thức để biết giá đám mây hiện tại và so sánh tính năng.
Chạy n8n cục bộ cung cấp quyền kiểm soát hoàn toàn đối với cơ sở hạ tầng tự động hóa quy trình làm việc. Dù sử dụng npm để kiểm tra nhanh hay Docker để triển khai sản xuất, cả hai phương pháp đều mang lại nền tảng đầy đủ mà không tốn chi phí định kỳ. Bắt đầu với npx để khám phá ngay lập tức, sau đó chuyển sang Docker khi quy trình làm việc hướng tới sử dụng sản xuất.
