Phân biệt Neo4j Desktop và Neo4j Server
Trước khi triển khai, cần xác định rõ mục đích sử dụng để chọn đúng bản phân phối.
Neo4j Desktop là giải pháp dành cho phát triển (Development), học tập và prototype. Nó chạy trên môi trường máy tính cá nhân (Windows, macOS, Linux), cung cấp giao diện GUI trực quan để quản lý nhiều dự án, chạy Bolt local và tích hợp sẵn Cypher Shell.
Neo4j Server (hay Neo4j Enterprise/Community Server) là giải pháp dành cho sản xuất (Production). Nó chạy dưới dạng dịch vụ (systemd service) trên Linux, không có GUI tích hợp, tối ưu cho hiệu năng, xử lý song song và truy cập qua mạng (Bolt/TCP).
Trong bài này, chúng ta tập trung cài đặt Neo4j Server trên Ubuntu 24.04 để phục vụ môi trường production hoặc staging.
Verify kết quả bước này
Hiểu rõ kiến trúc: Desktop dùng cho Dev (GUI), Server dùng cho Ops (CLI/Service).
Cấu hình Repository và Key GPG cho Neo4j
Ubuntu 24.04 không có sẵn Neo4j trong repository mặc định. Chúng ta cần thêm repository chính thức của Neo4j vào nguồn apt.
Bước 1: Cài đặt các công cụ cần thiết
Cần có curl để tải key GPG và gnupg để giải mã, cùng với apt-transport-https để apt có thể kết nối qua HTTPS.
sudo apt update && sudo apt install -y curl gnupg apt-transport-https software-properties-common
Kết quả mong đợi: Các gói công cụ được cập nhật và cài đặt thành công, không có lỗi về missing dependency.
Bước 2: Thêm Key GPG của Neo4j
Để bảo mật, apt yêu cầu ký GPG cho các gói phần mềm. Chúng ta tải key từ server chính thức của Neo4j và thêm vào kho key của hệ thống.
curl -fsSL https://debian.neo4j.com/neotechnology.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/neo4j-archive-keyring.gpg
Kết quả mong đợi: Lệnh chạy xong không output gì (silent success), file key được tạo tại /usr/share/keyrings/neo4j-archive-keyring.gpg.
Bước 3: Thêm Repository Neo4j vào nguồn Apt
Thêm nguồn repository chỉ định cho Ubuntu 24.04 (mã tên "noble") vào danh sách nguồn của apt, tham chiếu đến key GPG vừa tạo.
echo "deb [signed-by=/usr/share/keyrings/neo4j-archive-keyring.gpg] https://debian.neo4j.com stable latest" | sudo tee -a /etc/apt/sources.list.d/neo4j.list
Kết quả mong đợi: File /etc/apt/sources.list.d/neo4j.list được tạo hoặc cập nhật với dòng cấu hình repository.
Bước 4: Cập nhật nguồn gói phần mềm
Yêu cầu apt quét lại danh sách gói mới từ repository vừa thêm để biết phiên bản Neo4j khả dụng.
sudo apt update
Kết quả mong đợi: Trong output phải xuất hiện dòng Get: https://debian.neo4j.com stable/latest InRelease hoặc neo4j trong danh sách các gói có sẵn.
Verify kết quả bước này
Chạy lệnh kiểm tra xem gói neo4j đã xuất hiện trong danh sách chưa.
apt-cache policy neo4j
Kết quả mong đợi: Xuất hiện thông tin về neo4j với phiên bản từ debian.neo4j.com.
Cài đặt Neo4j Server bằng Apt
Sau khi cấu hình nguồn, chúng ta tiến hành cài đặt gói neo4j. Gói này bao gồm cả Neo4j Server và các công cụ quản lý cơ bản.
Bước 1: Cài đặt gói Neo4j
Cài đặt gói neo4j phiên bản mới nhất từ repository. Lệnh -y tự động xác nhận cài đặt.
sudo apt install -y neo4j
Kết quả mong đợi: Quá trình tải và cài đặt chạy, hệ thống thông báo Setting up neo4j (5.x.x) (phiên bản có thể thay đổi tùy thời điểm, luôn là stable nhất).
Bước 2: Kiểm tra phiên bản đã cài
Đảm bảo Neo4j đã được cài đặt chính xác và hiển thị phiên bản.
neo4j --version
Kết quả mong đợi: In ra dòng neo4j 5.x.x (ví dụ: neo4j 5.23.0).
Verify kết quả bước này
Neo4j đã tồn tại trong hệ thống và có thể gọi được command line tool.
Kiểm tra và Khởi động Dịch vụ Neo4j
Neo4j trên Linux hoạt động dưới dạng dịch vụ systemd. Mặc định, sau khi cài đặt, dịch vụ có thể chưa chạy hoặc chưa tự động khởi động khi boot.
Bước 1: Kiểm tra trạng thái dịch vụ hiện tại
Dùng systemctl để xem dịch vụ neo4j đang ở trạng thái gì (inactive, failed, hoặc active).
sudo systemctl status neo4j
Kết quả mong đợi: Có thể thấy trạng thái là inactive (dead) nếu chưa được khởi động.
Bước 2: Kích hoạt và khởi động dịch vụ
Lệnh này thực hiện hai việc: Enable (tự động chạy khi máy bật) và Start (chạy ngay lập tức).
sudo systemctl enable --now neo4j
Kết quả mong đợi: Thông báo Created symlink /etc/systemd/system/multi-user.target.wants/neo4j.service... và Started Neo4j graph database server.
Bước 3: Xác nhận dịch vụ đang chạy ổn định
Kiểm tra lại trạng thái để đảm bảo dịch vụ đang active (running) và không có lỗi trong log.
sudo systemctl status neo4j
Kết quả mong đợi: Dòng trạng thái màu xanh ● neo4j.service - Neo4j graph database server và Active: active (running).
Bước 4: Kiểm tra cổng mặc định
Neo4j Server sử dụng cổng 7474 cho HTTP (Browser) và 7687 cho Bolt (Driver). Kiểm tra xem cổng đã lắng nghe chưa.
sudo netstat -tlnp | grep neo4j
Kết quả mong đợi: Xuất hiện dòng tcp 0 0 0.0.0.0:7474 0.0.0.0:LISTEN ... neo4j và tcp 0 0 0.0.0.0:7687 0.0.0.0:LISTEN ... neo4j.
Verify kết quả bước này
Dịch vụ Neo4j đang chạy, tự động khởi động khi reboot, và đã mở cổng lắng nghe cho kết nối từ xa.
Điều hướng series:
Mục lục: Series: Triển khai Database Graph với Neo4j và Ubuntu 24.04
« Phần 1: Chuẩn bị môi trường Ubuntu 24.04 và các yêu cầu hệ thống
Phần 3: Cấu hình bảo mật, xác thực và truy cập Neo4j »