---
url: https://docs.ogmabox.com/vi/app/settings.md
description: >-
  Cấu hình giao diện, phím tắt, mạng, DNS, chứng chỉ, AI, MCP, trình quét, TLS,
  trình duyệt và tùy chỉnh dành cho nhà phát triển trong Ogma.
---

# Cài đặt {#settings}

Cài đặt kiểm soát giao diện Ogma, cách ghi nhận lưu lượng, xử lý TLS, định tuyến kết nối đi ra và cung cấp tính năng AI hoặc MCP. Giữ các quyền nhạy cảm về bảo mật ở trạng thái tắt trừ khi quy trình cần chúng.

## Giao diện {#appearance}

Dùng **Giao diện** để điều chỉnh không gian làm việc cho thoải mái và dễ đọc.

| Phần | Nội dung điều khiển |
| --- | --- |
| Chủ đề | Chế độ màu Sáng, Tối hoặc Hệ thống. |
| Chủ đề tô sáng cú pháp | Màu dùng trong trình xem nội dung, trình soạn thảo Replay và trình kiểm tra WebSocket. |
| Bố cục | Mật độ bảng, tự động cuộn Lịch sử HTTP, hướng trình kiểm tra và vị trí thanh bên. |
| Kiểu chữ | Phông chữ giao diện, cỡ chữ giao diện và cỡ chữ trình soạn thảo. |
| Dấu thời gian | Định dạng 12 giờ hoặc 24 giờ, múi giờ địa phương hoặc UTC và xem trước trực tiếp. |

## Phím tắt {#shortcuts}

Trang **Phím tắt** liệt kê mọi thao tác được gán phím và cho phép gán lại. Nhấp **Chỉnh sửa**, nhấn tổ hợp phím mới hoặc dùng **Đặt lại** để khôi phục mặc định.

Các phím mặc định phổ biến gồm:

| Thao tác | Mặc định |
| --- | --- |
| Mở Chặn bắt | `I` |
| Mở Replay | `R` |
| Mở Tìm kiếm | `/` |
| Chuyển tiếp yêu cầu bị chặn bắt | `F` |
| Gửi đến Replay | `Ctrl+R` |
| Mở bảng lệnh | `Ctrl+K` |

## Khởi động và hiển thị {#startup-and-rendering}

| Trang | Mục đích sử dụng |
| --- | --- |
| Khởi động | Chọn phiên proxy mặc định để mở khi Ogma khởi động và điều khiển hành vi cửa sổ khi khởi động. |
| Hiển thị | Giảm chuyển động để hỗ trợ khả năng tiếp cận hoặc hiệu năng và kiểm tra cách tăng tốc phần cứng hoạt động. |

## Mạng {#network}

Dùng **Mạng** khi Ogma phải gửi lưu lượng đi ra qua proxy khác.

| Loại proxy | Cách hoạt động |
| --- | --- |
| Proxy HTTP | Định tuyến lưu lượng HTTP và HTTPS đi ra qua proxy HTTP thượng nguồn. |
| Proxy SOCKS5 | Định tuyến lưu lượng đi ra qua máy chủ SOCKS5; DNS được phân giải qua máy chủ SOCKS5. |
| Proxy plugin | Định tuyến lưu lượng qua proxy thượng nguồn do plugin Ogma định nghĩa. |

Mỗi mục proxy thượng nguồn có thể được bật hoặc tắt và sắp xếp theo độ ưu tiên. Dùng cho proxy doanh nghiệp, thiết lập kiểm thử nối chuỗi hoặc định tuyến lưu lượng qua công cụ kiểm tra khác.

## DNS {#dns}

| Phần | Mục đích sử dụng |
| --- | --- |
| Ánh xạ lại máy chủ tĩnh | Ánh xạ tên máy chủ đến địa chỉ IP cụ thể mà không sửa tệp hosts của hệ điều hành. Ký tự đại diện như `*.example.com` khớp một cấp tên miền phụ. |
| Máy chủ DNS thượng nguồn | Định tuyến truy vấn DNS qua bộ phân giải tùy chỉnh. Để trống mẫu máy chủ để áp dụng bộ phân giải trên toàn cục. |

Ánh xạ lại DNS hữu ích khi kiểm thử dịch vụ staging bằng tên máy chủ của môi trường production hoặc chuyển lưu lượng đến điểm cuối trong môi trường thử nghiệm được kiểm soát.

## Chứng chỉ và TLS {#certificates-and-tls}

### Tổ chức cấp chứng chỉ {#certificate-authority}

Ogma tạo CA cục bộ ở lần khởi động đầu tiên. Để chặn bắt lưu lượng HTTPS, trình duyệt hoặc hệ điều hành phải tin cậy chứng chỉ CA đã xuất.

1. Mở **Cài đặt > Chứng chỉ**.
2. Tải chứng chỉ CA công khai để thiết lập tin cậy trong trình duyệt hoặc hệ điều hành.
3. Cài vào kho tin cậy của trình duyệt hoặc hệ điều hành.

Trang này cũng có thể xuất bản sao lưu CA đầy đủ, nhập bản sao lưu CA từ phiên proxy Ogma khác, quản lý CA có tên để chặn bắt theo từng điểm lắng nghe hoặc tạo lại CA đang hoạt động. Bản sao lưu CA chứa dữ liệu khóa riêng; lưu trữ như dữ liệu bí mật.

### Chứng chỉ máy khách {#client-certificates}

Dùng **Chứng chỉ máy khách** cho mục tiêu yêu cầu mTLS. Mỗi mục ánh xạ một mẫu máy chủ, như `*.internal.corp`, đến chứng chỉ PEM và khóa riêng.

### Bỏ qua TLS {#tls-bypass}

Dùng **Bỏ qua kiểm tra TLS** cho máy chủ cần truyền qua đường hầm mà không kiểm tra TLS. Điều này hữu ích cho ứng dụng ghim chứng chỉ hoặc lưu lượng bạn chủ ý không cần giải mã.

### Chẩn đoán TLS {#tls-diagnostics}

Dùng **Chẩn đoán TLS** để kiểm tra chủ thể CA Ogma, dấu vân tay SHA-256, thời hạn hiệu lực, phiên bản lược đồ cơ sở dữ liệu và kết quả kiểm thử kết nối TLS trực tiếp. Kiểm thử kết nối báo phiên bản TLS đã thương lượng, bộ mã, chủ thể chứng chỉ thượng nguồn, chủ thể chứng chỉ MITM và thời gian khứ hồi.

## WebSockets {#websockets}

| Cài đặt | Mô tả |
| --- | --- |
| Ghi nhận | Kiểm soát việc ghi lại tin nhắn WebSocket. |
| Chặn bắt tin nhắn WebSocket | Đưa tin nhắn WebSocket vào hàng đợi trong bảng Chặn bắt khi bật. |

Xem [Lịch sử WebSocket và SSE](./ws-sse-history.md) để biết quy trình kiểm tra và phát lại.

## AI {#ai}

| Tùy chọn | Mô tả |
| --- | --- |
| Nhà cung cấp | Anthropic, OpenAI, Google Gemini hoặc điểm cuối tùy chỉnh tương thích OpenAI. |
| Điểm cuối API | Điểm cuối mặc định của nhà cung cấp hoặc URL cơ sở tùy chỉnh. |
| Khóa API | Khóa bí mật cho nhà cung cấp được chọn. Được lưu cục bộ. |
| Mô hình | ID mô hình do trợ lý Ask Bob dùng. |
| Proxy HTTP | Trường tham khảo; lệnh gọi nhà cung cấp từ trình duyệt tuân theo hành vi proxy hệ thống. |
| Tùy chọn nâng cao | Số token đầu ra tối đa, nhiệt độ, thời gian chờ yêu cầu, số yêu cầu trong ngữ cảnh trực tiếp, tin nhắn ngữ cảnh công cụ và số vòng lặp công cụ tối đa. |

Xem [AI trong không gian làm việc](../guide/workspace-ai.md) để biết cách trợ lý dùng ngữ cảnh lưu lượng và công cụ.

## MCP {#mcp}

Dùng cài đặt **Model Context Protocol** để khởi động hoặc dừng máy chủ MCP và chọn các quyền được bật cho tác nhân bên ngoài.

| Tùy chọn | Mô tả |
| --- | --- |
| Địa chỉ lắng nghe | Chỉ loopback: `127.0.0.1`, `localhost` hoặc `::1`. Địa chỉ lắng nghe công khai bị từ chối. |
| Cổng | Cổng MCP Streamable HTTP riêng; mặc định `3000`. Sao chép điểm cuối `/mcp` đầy đủ hiển thị trong Cài đặt. |
| Công cụ lưu lượng chỉ đọc | Luôn có sẵn: đọc ngữ cảnh dự án, lịch sử HTTP, phát hiện, quy trình và siêu dữ liệu liên quan. |
| Ghi phát hiện | Cho phép tạo, cập nhật, gắn thẻ và liên kết phát hiện. |
| Xuất dữ liệu | Cho phép tạo tác vụ xuất. |
| Đọc giá trị bí mật | Cho phép đọc giá trị biến môi trường không bị che, tách biệt với quyền chỉnh sửa biến. |
| Gửi từ Replay | Cho phép công cụ gửi yêu cầu, điều hướng trình duyệt, thu thập dữ liệu, thăm dò chủ động, kiểm thử WebSocket và các công cụ hỗ trợ hồ sơ xác thực. |
| Chạy quy trình | Cho phép xem trước, thực thi và hủy quy trình. |
| Điều khiển chặn bắt | Cho phép bật, tạm dừng, chỉnh sửa, chuyển tiếp hoặc loại bỏ lưu lượng đang bị chặn bắt trực tiếp. |

Tắt các quyền không cần. Xem [Thiết lập MCP](../mcp-setup.md) và [Tài nguyên và công cụ MCP](../reference/mcp-tools.md).

Lưu tự động khởi động lại máy chủ MCP đang chạy. Kết nối lại máy khách sau khi lưu; dùng Chẩn đoán khi chạy để điều tra lỗi khởi động. Các khả năng đã bật không có hạn ngạch hoạt động theo phút hoặc theo phiên, dù giới hạn của từng công cụ vẫn áp dụng.

## Trình quét {#scanner}

Trang **Trình quét** chứa trình chỉnh sửa quy tắc thụ động tùy chỉnh. Quy tắc chạy trên lưu lượng HTTP đã ghi nhận và đưa ra phát hiện. Xem [Trình quét](./utilities/scanner.md) để biết cấu trúc và cách dùng quy tắc.

## Thời gian chờ {#timeouts}

Dùng **Thời gian chờ** để điều chỉnh hành vi kết nối đi ra.

| Cài đặt | Mặc định | Mô tả |
| --- | --- | --- |
| Thời gian chờ kết nối | `30000ms` | Thời gian cho phép để thiết lập kết nối TCP đến máy chủ thượng nguồn. |
| Thời gian chờ đọc | `60000ms` | Thời gian cho phép để nhận dữ liệu phản hồi sau khi mở kết nối. |
| Thời gian chờ ghi | `60000ms` | Thời gian cho phép để gửi dữ liệu yêu cầu đến máy chủ thượng nguồn. |

Các cấu hình đặt sẵn áp dụng nhanh những bộ thời gian chờ phổ biến. Tăng giá trị cho mục tiêu chậm; giảm khi cần các lượt quét lớn thất bại nhanh.

## Bảo mật {#security}

| Phần | Mô tả |
| --- | --- |
| Xác minh TLS thượng nguồn | Kiểm soát việc Ogma kiểm tra chứng chỉ TLS thượng nguồn. Giữ bật trừ khi bạn kiểm thử môi trường thử nghiệm hoặc mục tiêu có TLS lỗi. |
| Xác thực API | Bảo vệ API Ogma bằng bearer token. Bắt buộc khi lắng nghe trên địa chỉ không phải localhost. |
| Yêu cầu của quy trình | Cảnh báo rằng nút yêu cầu trong quy trình bỏ qua cài đặt proxy và bộ lọc phạm vi. Kiểm tra quy trình trước khi chạy định nghĩa không đáng tin cậy. |

## Lược đồ Protobuf {#protobuf-schemas}

Dùng **Lược đồ Protobuf** để tải lên tệp nhị phân `FileDescriptorSet` được biên dịch từ mã nguồn `.proto`. Ogma dùng các lược đồ này để giải mã theo lược đồ trong ngăn phản hồi và công cụ protobuf.

## Tùy chỉnh dành cho nhà phát triển {#developer-customization}

| Trang | Mô tả |
| --- | --- |
| CSS tùy chỉnh | Áp dụng kiểu tùy chỉnh cho giao diện Ogma. Thay đổi áp dụng trực tiếp. |
| JavaScript tùy chỉnh | Chạy JavaScript trong ngữ cảnh ứng dụng. Script có thể in đầu ra và được cấu hình tự chạy khi khởi động. |

Dùng tùy chỉnh dành cho nhà phát triển để cá nhân hóa không gian làm việc cục bộ, không dùng cho trạng thái dự án chung.

## Khắc phục sự cố và Giới thiệu {#troubleshooting-and-about}

| Trang | Mô tả |
| --- | --- |
| Khắc phục sự cố | Hiển thị phiên bản máy chủ và Electron, đặt lại cài đặt giao diện và hiển thị vị trí nhật ký. |
| Giới thiệu | Hiển thị thông tin nhận diện sản phẩm, phiên bản hiện tại, commit bản dựng, trạng thái cập nhật và liên kết bản phát hành. |

## Trang liên quan {#related-pages}

* [Thiết lập MCP](../mcp-setup.md)
* [Mô hình bảo mật](../security.md)
* [Khắc phục sự cố](../troubleshooting.md)