Cài n8n self-host trên Raspberry Pi bằng Docker

n8n là nền tảng tự động hóa mã nguồn mở, phù hợp với người muốn tự vận hành workflow thay vì phụ thuộc hoàn toàn vào dịch vụ bên ngoài. Trên Raspberry Pi, cách triển khai bằng Docker giúp tách ứng dụng khỏi hệ điều hành và thuận tiện hơn khi khởi động lại hoặc cập nhật. Bài viết dưới đây tập trung vào Raspberry Pi 5, cách chạy n8n trong mạng nội bộ và các điểm cần chuẩn bị nếu muốn truy cập từ xa.

Nếu Raspberry Pi được dùng như một máy chủ gia đình, bạn cũng có thể tham khảo Cài CasaOS trên Raspberry Pi: Biến Terminal thành App Store để có thêm một hướng quản lý ứng dụng.

Phần cứng trong hướng dẫn gồm bo mạch Raspberry Pi 5, bộ cấp nguồn USB Type-C 27W, thẻ nhớ Micro SD Kioxia EXCERIA Class 10 U1 32GB và vỏ kim loại công nghiệp phiên bản D. Đây là các thành phần liên quan đến khả năng khởi động và lưu dữ liệu của hệ thống, nhưng bài viết không gán trước nguyên nhân lỗi cho riêng một linh kiện nào.

1. Cài n8n với Docker trên Raspberry Pi

Docker là lựa chọn phù hợp nếu bạn muốn chạy n8n trong một môi trường riêng, đồng thời giữ dữ liệu của ứng dụng ở một thư mục dễ sao lưu. Cách này đặc biệt hữu ích khi người dùng đã quen làm việc với Terminal và muốn triển khai nhanh trên Raspberry Pi.

Có thể bạn quan tâm: Cách cài ROM tiếng Việt cho Redmi Note 12 5G Sunstone.

Kiểm tra Docker trước khi tạo n8n

Mở Terminal trên Pi rồi kiểm tra phiên bản Docker và Docker Compose bằng hai lệnh docker --version và docker compose version. Nếu hệ thống chưa có Docker, có thể cài bằng lệnh cài đặt chính thức trong tài liệu nguồn, sau đó thêm tài khoản hiện tại vào nhóm Docker và khởi động lại Raspberry Pi. Việc khởi động lại giúp quyền mới được áp dụng đúng.

Trước khi tiếp tục, cần chắc chắn Pi đã kết nối mạng, nguồn cấp ổn định và thẻ nhớ có đủ không gian cho hệ điều hành cùng dữ liệu workflow. Nếu Docker báo lỗi quyền truy cập sau khi đăng nhập lại, hãy kiểm tra tài khoản đang sử dụng thay vì tự thay đổi quyền của nhiều thư mục hệ thống.

Tạo thư mục lưu cấu hình và dữ liệu

Trong Terminal, tạo thư mục riêng cho n8n bằng mkdir ~/n8n, sau đó chuyển vào thư mục này với cd ~/n8n. Tiếp theo, tạo tệp docker-compose.yml bằng trình soạn thảo nano. Tệp này sẽ khai báo dịch vụ n8n, cổng truy cập, múi giờ Việt Nam và thư mục dữ liệu được gắn từ Pi vào môi trường chạy.

Nội dung liên quan: Thiết Bị Thu Âm.

Trong cấu hình, cổng nội bộ của n8n là 5678. Dữ liệu ứng dụng nên được ánh xạ vào thư mục ./data bên trong thư mục n8n để việc khởi động lại container không làm mất cấu hình đã lưu. Múi giờ có thể đặt là Asia/Ho_Chi_Minh. Thiết lập cookie bảo mật trong ví dụ nguồn được cấu hình để phù hợp với cách truy cập nội bộ qua HTTP; khi mở dịch vụ ra Internet, không nên xem đây là cấu hình bảo mật hoàn chỉnh.

Sau khi nhập nội dung YAML, lưu tệp trong nano bằng tổ hợp phím Ctrl + X, chọn Y rồi nhấn Enter. Cần chú ý thụt lề YAML; chỉ một khoảng trắng sai vị trí cũng có thể khiến Docker Compose không đọc được tệp. Không nên tự đổi tên thư mục dữ liệu hoặc cổng nếu chưa hiểu ảnh hưởng đến URL truy cập và các cấu hình liên quan.

Khởi động container và mở giao diện

Từ thư mục ~/n8n, chạy docker compose up -d. Tham số -d cho phép dịch vụ tiếp tục chạy nền sau khi đóng cửa sổ Terminal. Nếu lệnh hoàn tất mà không báo lỗi nghiêm trọng, hãy chờ một chút để container khởi tạo rồi mở trình duyệt trên thiết bị cùng mạng.

Trong mạng nội bộ, địa chỉ có thể là http://localhost:5678 nếu trình duyệt đang chạy trên chính Raspberry Pi. Với máy tính hoặc điện thoại khác, thay localhost bằng địa chỉ IP hiện tại của Pi, theo dạng http://IP-PI:5678. Sau khi giao diện xuất hiện, tạo tài khoản và đăng nhập để bắt đầu xây dựng workflow.

Nếu trang không mở, hãy kiểm tra ba điểm theo thứ tự: container có đang chạy hay không, Pi có cùng mạng với thiết bị truy cập hay không, và cổng 5678 có được khai báo đúng trong tệp hay không. Không nên vội kết luận thẻ nhớ, nguồn hay bo mạch đã hỏng chỉ vì giao diện n8n chưa hiển thị; cần xem trạng thái Docker và kết nối mạng trước.

2. Đưa n8n ra ngoài mạng nội bộ

Để truy cập n8n từ Internet, chỉ mở cổng trên Pi là chưa đủ. Bạn cần một tên miền hoặc tên miền động DNS trỏ được về mạng đang chứa Raspberry Pi, đồng thời phải cấu hình đường đi từ bên ngoài đến dịch vụ. Tên miền minh họa trong cấu hình nguồn là n8n.mooo.com; đây chỉ là ví dụ và cần thay bằng tên miền DDNS của bạn.

Có thể bạn quan tâm: THIẾT BỊ CHỐNG TRỘM.

Cập nhật cấu hình máy chủ

Sau khi DNS đã được thiết lập, mở lại docker-compose.yml và bổ sung địa chỉ máy chủ n8n, giao thức kết nối cùng URL webhook. Với phương án HTTP, các giá trị tương ứng dùng tên miền DDNS, giao thức http và địa chỉ webhook có kèm cổng 5678. Múi giờ Việt Nam vẫn có thể giữ nguyên để thời gian chạy workflow dễ đối chiếu.

Nếu dùng HTTPS, giao thức trong cấu hình chuyển thành https và webhook sử dụng URL HTTPS tương ứng, không nhất thiết phải ghi cổng trong địa chỉ công khai. Tuy nhiên, đoạn cấu hình này chỉ khai báo n8n nhận diện địa chỉ bên ngoài; để HTTPS hoạt động thực tế, mạng còn cần lớp chuyển tiếp và chứng chỉ phù hợp. Không nên coi việc đổi chữ http thành https là đã hoàn tất bảo mật.

Khởi động lại và kiểm tra từ xa

Lưu tệp rồi chạy lần lượt docker compose down và docker compose up -d trong thư mục n8n. Sau đó thử truy cập bằng tên miền từ một mạng khác, chẳng hạn mạng di động thay vì Wi-Fi tại nhà. Cách kiểm tra này giúp phân biệt việc DNS đã hoạt động với trường hợp dịch vụ chỉ truy cập được trong mạng LAN.

Tham khảo thêm: Apple Watch bị phóng to màn hình: Cách thu nhỏ nhanh.

Khi đưa n8n ra Internet, tài khoản đăng nhập, webhook và dữ liệu workflow cần được xem là thông tin quan trọng. Nếu không truy cập được, hãy kiểm tra DNS, địa chỉ IP mạng nhà, quy tắc chuyển tiếp cổng và trạng thái container theo từng bước. Việc chỉnh nhiều thành phần cùng lúc có thể khiến khó xác định nguyên nhân.

Với trường hợp Raspberry Pi không khởi động, mất kết nối hoặc không còn đọc được dữ liệu, không nên tháo lắp và ghi lại thẻ nhớ khi chưa có bản sao cần thiết. Trungtambaohanh.com có tiếp nhận hỗ trợ phần mềm, kiểm tra thiết bị công nghệ và các vấn đề liên quan đến thiết bị lưu trữ; hình thức tiếp nhận có thể là tại cửa hàng, từ xa hoặc gửi thiết bị tùy khu vực.

Chi phí kiểm tra Raspberry Pi khi n8n không truy cập được

Mức giá phụ thuộc vào tình trạng thực tế, linh kiện và phương án xử lý. Mức giá tham khảo có thể thay đổi; vui lòng liên hệ để xác nhận khoảng giá hiện hành trước khi thực hiện.

FAQ về cài n8n trên Raspberry Pi

Có thể chạy n8n mà không dùng Docker không?

Có. n8n có thể được triển khai bằng npm hoặc trên VPS, nhưng nội dung này chọn Docker vì cách đóng gói và khởi động phù hợp với người đã quen công cụ container trên Raspberry Pi.

Thiết bị nào trong cùng mạng có thể mở n8n?

Máy tính hoặc điện thoại cùng mạng với Pi có thể truy cập qua địa chỉ IP của Raspberry Pi và cổng 5678. Địa chỉ localhost chỉ phù hợp khi trình duyệt chạy ngay trên Pi.

Nội dung liên quan: Hướng dẫn unlock bootloader điện thoại Xiaomi an toàn.

Vì sao đã chạy Docker nhưng vẫn không vào được trang n8n?

Cần kiểm tra trạng thái container, địa chỉ IP hiện tại, kết nối giữa hai thiết bị và phần khai báo cổng trong tệp Compose. Chưa đủ căn cứ để kết luận lỗi thuộc về một linh kiện phần cứng.

Có nên mở n8n ra Internet ngay sau khi cài đặt?

Nên hoàn tất kiểm tra trong mạng nội bộ trước. Khi truy cập từ xa, cần có DNS phù hợp và cấu hình giao thức, webhook, chuyển tiếp mạng cũng như lớp HTTPS nếu sử dụng.

Khi cần hỗ trợ kiểm tra thực tế

Nếu thiết bị có dấu hiệu bất thường, khách hàng có thể liên hệ Trungtambaohanh.com qua hotline 0967891080 để mô tả tình trạng và được hướng dẫn hình thức tiếp nhận phù hợp. Kỹ thuật viên cần kiểm tra thực tế trước khi xác định nguyên nhân, phương án xử lý, chi phí, thời gian và điều kiện bảo hành.

Tham khảo thêm: Dàn lạnh.

Xem thêm thông tin dịch vụ tại trang giới thiệu Trungtambaohanh.com hoặc bấm đặt lịch với kỹ thuật ngay tại đây trên website để được hỗ trợ theo khu vực.

Muốn lưu bài để đọc tiếp trên điện thoại? Hãy quét mã QR dưới đây.