Triển Khai Laravel Scout + Meilisearch v1.11+ Trên Docker Compose & Tối Ưu Horizon

Tránh Bẫy Gửi Hàng Ngàn Task Lẻ Tẻ Khi Lưu Model Eloquent (MeiliSizer Guide)

Nếu để mặc định, một vòng lặp cập nhật 5.000 dòng Eloquent sẽ bắn 5.000 HTTP task nhỏ lẻ sang Meilisearch gây nghẽn hàng đợi đánh chỉ mục. Chỉ cần bật SCOUT_QUEUE=true trên nhánh Horizon riêng và gom nhóm bằng chunk 1.000 bản ghi, hệ thống sẽ gộp 5.000 thao tác thành 5 lần ghi LMDB siêu tốc trong chưa đầy 1 giây.

File docker-compose.yml Chuẩn Production Cho VPS KVM 16GB

# docker-compose.yml — Dịch vụ Meilisearch v1.11 cô lập tài nguyên
services:
  meilisearch:
    image: getmeili/meilisearch:v1.11
    restart: unless-stopped
    environment:
      MEILI_ENV: production
      MEILI_MASTER_KEY: ${MEILISEARCH_KEY}
      MEILI_MAX_INDEXING_MEMORY: 4Gb
      MEILI_NO_ANALYTICS: "true"
    volumes:
      - meili_lmdb:/meili_data
    ports:
      - "127.0.0.1:7700:7700"
    deploy:
      resources:
        limits:
          memory: 10G

Bảng Định Cỡ RAM MeiliSizer Cho LARAVEL-SCOUT-DOCKER

Checklist Triển Khai MeiliSizer: LARAVEL-SCOUT-DOCKER

• Luôn chạy lệnh php artisan scout:sync-index-settings trong script CI/CD trước khi đẩy dữ liệu mới.
• Bật SCOUT_QUEUE=true và cấu hình kích thước lô scout.chunk.searchable từ 500 đến 1.000 bản ghi.
• Định nghĩa hàm toSearchableArray() gọn sạch để không đẩy nhầm cột mật khẩu hay chuỗi JSON thừa vào chỉ mục.
• Khóa cổng 7700 ở địa chỉ nội bộ 127.0.0.1 hoặc mạng riêng VPC; chỉ mở truy cập ngoài qua Reverse Proxy có HTTPS.

Nạp Thông Số Vào Ma Trận MeiliSizer →