Khắc phục sự cố

Những lỗi hay gặp khi cài và chạy OpsVibes, cùng cách xử lý.

Kiểm tra trạng thái

Xem panel và Traefik có đang chạy không, và đọc log gần nhất:

docker ps --filter name=opsvibes

docker logs --tail 100 opsvibes

Cổng 80 hoặc 443 đã bị chiếm

Server từng cài Nginx, Apache hoặc một control panel khác sẽ giữ cổng 80/443, khiến Traefik không chạy được. Kiểm tra tiến trình đang dùng cổng:

sudo ss -tlnp | grep -E ':(80|443|3000)\s'

Dừng và tắt dịch vụ đó (ví dụ sudo systemctl disable --now nginx), rồi khởi động lại panel bằng docker restart opsvibes.

Không mở được panel ở cổng 3000

• Kiểm tra tường lửa của server (ufw hoặc firewalld) và tường lửa của nhà cung cấp cloud. Xem Cổng mạng.
• Kiểm tra Docker đang chạy:

sudo systemctl status docker

SELinux trên Rocky, AlmaLinux, RHEL

Khi SELinux đang bật (Enforcing), container của panel có thể bị chặn truy cập Docker socket, log báo permission denied với /var/run/docker.sock.

getenforce

Script cài đặt đã xử lý việc này. Nếu bạn cài bằng Docker, dùng lệnh có tùy chọn --security-opt label=disable ở tab Rocky / AlmaLinux trong trang Cài đặt.

Không cấp được chứng chỉ HTTPS

• Bản ghi A chưa trỏ đúng IP, hoặc DNS chưa cập nhật. Kiểm tra bằng dig +short như ở trang Tên miền và HTTPS.
• Cổng 80 bị chặn từ bên ngoài. Let's Encrypt cần truy cập cổng 80 để xác minh.
• Tên miền đang bật proxy Cloudflare. Chuyển về DNS only rồi thử lại.
• Let's Encrypt giới hạn số lần cấp chứng chỉ cho cùng tên miền mỗi tuần. Nếu thử quá nhiều lần, đợi vài giờ.

Mất setup token

Setup token luôn nằm trong file trên server cho tới khi tài khoản quản trị đầu tiên được tạo:

sudo cat /etc/opsvibes/setup.token

Token cũng được in ra trong log của container opsvibes mỗi lần panel khởi động.