Khắc phục sự cố

Dùng trang này để chẩn đoán các vấn đề phổ biến khi cấu hình và chạy Ogma.

Không có lưu lượng trong Lịch sử HTTP

Kiểm tra:

1. Phiên proxy Ogma đang chạy.
2. Proxy của trình duyệt hoặc ứng dụng trỏ đến bộ lắng nghe của phiên proxy, thường là 127.0.0.1:8080.
3. Ứng dụng mục tiêu không bỏ qua proxy.
4. Cài đặt VPN, proxy hệ thống, container, trình giả lập hoặc proxy di động không ghi đè cấu hình của máy khách kiểm thử.
5. Dự án đang hoạt động được mở trong không gian làm việc.

Nếu dùng Ogma Browser, mở một tab mới và xác nhận nhãn Qua proxy xuất hiện.

Yêu cầu HTTPS thất bại

Kiểm tra:

• Chứng chỉ CA Ogma được cài trong đúng kho chứng chỉ tin cậy.
• Bạn đã nhập CA vào hồ sơ trình duyệt thực sự đang sử dụng.
• Mục tiêu không dùng cơ chế ghim chứng chỉ.
• Quy tắc truyền thẳng TLS không loại trừ host.
• Yêu cầu về chứng chỉ máy khách được cấu hình trong Cài đặt > Chứng chỉ máy khách nếu mục tiêu yêu cầu mTLS.

Với ứng dụng di động hoặc máy tính dùng ghim chứng chỉ, bạn có thể cần thiết lập kiểm thử riêng cho ứng dụng bên ngoài Ogma.

Chặn bắt tạm dừng quá nhiều lưu lượng

Dùng các quy tắc chặn bắt hẹp hơn.

Các bước được khuyến nghị:

1. Tắt chặn bắt.
2. Xác định phạm vi.
3. Thêm điều kiện khớp theo host, phương thức, đường dẫn, kiểu nội dung hoặc header.
4. Bật lại chặn bắt.
5. Theo dõi kích thước hàng đợi.

Nếu hàng đợi đạt giới hạn, Ogma chuyển tiếp lưu lượng mới để tránh làm máy khách bị kẹt.

Trình quét báo cáo quá nhiều nhiễu

Với nhiễu từ trình quét thụ động:

• Kích hoạt phạm vi trước khi quét.
• Ưu tiên phát hiện có mức độ trung bình, cao và nghiêm trọng.
• Xem các phát hiện về header bị thiếu là phụ thuộc vào ngữ cảnh.
• Dùng quy tắc thụ động tùy chỉnh cho bằng chứng riêng của dự án.

Với nhiễu từ trình quét chủ động:

• Quét các yêu cầu đã chọn trước khi quét toàn bộ lịch sử.
• Xem các yêu cầu dùng làm bằng chứng và nội dung phản hồi.
• Xác nhận bằng chứng trong phản hồi chưa có trong phản hồi cơ sở.
• Kiểm tra độ tin cậy của phát hiện là có khả năng hay đã xác nhận.

Plugin không tải được

Kiểm tra:

1. Thư mục gốc của plugin chứa manifest.json.
2. Các đường dẫn điểm vào trong manifest tồn tại sau khi build.
3. Plugin được biên dịch thành JavaScript thuần.
4. Tài nguyên frontend được đưa vào gói plugin.
5. Các quyền cần thiết được khai báo và cấp.
6. Tab nhật ký plugin không có lỗi init() hoặc lỗi bridge.
7. Kích thước gói plugin thấp hơn giới hạn đã cấu hình.

Trợ lý MCP không thấy Ogma

Kiểm tra:

• HTTP tích hợp: MCP đang chạy trong Cài đặt > MCP và máy khách dùng endpoint Streamable HTTP đã sao chép, thường là http://127.0.0.1:3000/mcp.
• Stdio độc lập: đường dẫn tệp thực thi đúng và --api-url / OGMA_API_URL khớp với backend đang chạy. Các phiên proxy của ứng dụng máy tính có thể dùng cổng API động.
• Máy khách theo mọi con trỏ tools/list; chỉ trang đầu tiên không chứa tất cả công cụ.
• Công cụ ghi hoặc gửi yêu cầu cần quyền được cấp rõ ràng trong Cài đặt hoặc các cờ cho tệp thực thi độc lập.
• Kết nối lại sau khi MCP khởi động lại. ID phiên và token xác nhận cũ không còn hợp lệ.

Xem Cấu hình MCP.

Ogma Browser trống hoặc sai vị trí

Kiểm tra:

• Bạn đang chạy ứng dụng máy tính, không chỉ frontend web.
• Tab đang hoạt động có URL thực, không phải about:blank.
• Thử mở trình duyệt trong một cửa sổ riêng.
• Thay đổi kích thước cửa sổ Ogma để buộc tính lại kích thước và vị trí của trình duyệt.

JavaScript hoặc CSS tùy chỉnh làm hỏng giao diện

Dùng một trong các cách khôi phục:

• Nhấp Đặt lại giao diện tùy chỉnh.
• Nhấn Ctrl+Alt+Shift+R.

Thao tác này xóa JavaScript và CSS tùy chỉnh khỏi bộ nhớ cục bộ, cài đặt ứng dụng máy tính và tùy chọn backend, rồi tải lại Ogma.

Dữ liệu hoặc dự án có vẻ không đúng

Kiểm tra:

• Đúng phiên proxy đang được mở.
• Đúng dự án đang hoạt động.
• Tùy chọn khởi động không mở lại một phiên proxy khác.
• Bộ lọc hoặc phạm vi không ẩn các dòng bạn mong đợi.
• Chức năng ẩn tài nguyên tĩnh không loại trừ kiểu nội dung bạn đang tìm.

Tạo bản sao lưu trước khi thay đổi thủ công dữ liệu dự án.