Máy và trình duyệt

Mục tiêu

Tạo máy và instance trình duyệt, đồng thời duy trì phiên bản gói runtime trình duyệt cho truy cập trình duyệt từ xa, đăng nhập site và chạy workspace.

Điều kiện

• Đã đăng nhập trang quản trị.
• Tài khoản hiện tại có quyền liên quan đến "Quản lý trình duyệt".
• Đã chuẩn bị node máy hoặc môi trường chạy trình duyệt khả dụng.
• Dịch vụ quản trị đã cấu hình app.keeperbase để lưu gói browser client và engine.

Các bước thao tác

1. Vào "Quản lý trình duyệt > Danh sách máy".

2. Nhấp "Thêm máy", điền địa chỉ máy và số port.

   • Địa chỉ máy: điền địa chỉ dịch vụ keeper. Mặc định keeper nằm trên server cài đặt; thường điền địa chỉ intranet của server.
   • Số port: mặc định là 7000.
   • Phiên bản tích hợp: khi thêm hoặc cập nhật máy, hệ thống gọi interface bind của keeper để tự động lấy và lưu giá trị này. Không cần nhập thủ công trên trang.

3. Sau khi lưu, xác nhận bản ghi máy tồn tại và dịch vụ keeper có thể truy cập, có thể điều phối.

4. Vào "Quản lý trình duyệt > Danh sách trình duyệt".

5. Tạo instance trình duyệt, chọn máy, điền mã trình duyệt và chọn phiên bản trình duyệt.

   • Máy: trình duyệt tạo ra sẽ chạy trên máy đã chọn.
   • Mã trình duyệt: đặt nội dung dễ nhớ, duy nhất, gồm chữ hoặc ký tự không có khoảng trắng, ví dụ chrome100.
   • Phiên bản trình duyệt: chọn phiên bản trong quản lý phiên bản, hoặc chọn "Phiên bản tích hợp". Khi chọn, hệ thống dùng phiên bản tích hợp đã lưu trên máy được chọn.
   • Chế độ mạng:
     • Mạng thường: sử dụng mạng trình duyệt thông thường. Có thể cấu hình proxy HTTP/SOCKS5, phù hợp với các tình huống sử dụng phổ biến.
     • Mạng cách ly: tạo môi trường mạng độc lập cho trình duyệt, tiếp quản toàn bộ lưu lượng mạng của trình duyệt và hỗ trợ cách ly DNS, UDP, WebRTC cùng các hành vi mạng khác đầy đủ hơn. Dùng cho tình huống cần cách ly mạnh hơn.
   • Khe mạng: chỉ bắt buộc với Mạng cách ly. Nhập một số duy nhất lớn hơn 0.
   • Cấu hình DNS: chỉ bắt buộc với Mạng cách ly. Chọn tcp hoặc udp, nhập IP và port DNS, rồi chọn DNS có đi qua proxy hay không bằng direct hoặc proxy. direct gửi yêu cầu DNS trực tiếp; proxy gửi yêu cầu DNS qua proxy.
   • Cấu hình proxy: chỉ bắt buộc với Mạng cách ly. Chọn socks5 hoặc http, sau đó nhập host và port proxy. Username và password là tùy chọn.

6. Sau khi tạo trình duyệt, có thể sửa chế độ mạng và cấu hình mạng cách ly từ danh sách trình duyệt.

7. Nhấp nút "Bắt đầu" để khởi động trình duyệt cho đến khi trạng thái thành running.

Cấu hình trình duyệt

Từ danh sách trình duyệt, nhấp thao tác cấu hình của một instance trình duyệt để điều chỉnh cách trình duyệt khởi chạy và nhận diện môi trường.

• Cấu hình cơ bản:
  • Phiên bản kernel: chọn phiên bản runtime Chromium mà instance trình duyệt sử dụng. Dùng "Sửa" bên cạnh trường này để quản lý các phiên bản Chromium khả dụng.
  • OS: chọn profile hệ điều hành. Dùng "Sửa" để quản lý danh sách OS.
  • Brand và phiên bản brand: chọn brand trình duyệt như Google Chrome, Microsoft Edge, Opera hoặc Vivaldi, rồi chọn phiên bản brand phù hợp. Khi đổi brand, phiên bản brand đã chọn sẽ bị xóa.
  • Model mobile: chọn profile thiết bị mobile khi trình duyệt cần mô phỏng môi trường mobile. Dùng "Sửa" để quản lý tùy chọn model.
  • Múi giờ: tìm kiếm và chọn múi giờ của trình duyệt, hoặc reset về múi giờ local.
• Cấu hình nâng cao:
  • Tùy chọn boot: thêm, sửa hoặc xóa tham số khởi chạy Chromium dưới dạng cặp key-value. Các giá trị mặc định thường gặp gồm disable-gpu, no-sandbox, ignore-certificate-errors, lang và autoplay-policy. Để xem thêm command-line switch của Chromium, tham khảo List of Chromium Command Line Switches.
  • Thư mục temp và thư mục cache: thiết lập nơi trình duyệt ghi file tạm và dữ liệu cache.
  • Kích thước ảnh tối đa: thiết lập kích thước ảnh tối đa, tính bằng pixel, dùng khi trình duyệt lấy ảnh.
  • Tăng tốc phần cứng: chỉ bật khi môi trường runtime hỗ trợ GPU acceleration ổn định.
  • Xóa dữ liệu người dùng: xóa dữ liệu người dùng của trình duyệt khi cần một session sạch.

Nhấp "Lưu" sau khi thay đổi cấu hình trình duyệt. Khởi động lại instance trình duyệt nếu thay đổi cần có hiệu lực trong process trình duyệt mới.

Quản lý phiên bản trình duyệt

Trong "Quản lý trình duyệt > Danh sách trình duyệt", nhấp "Quản lý phiên bản" để mở trang quản lý phiên bản.

Trang hiển thị tên phiên bản, trạng thái engine, trạng thái client và thao tác tải xuống.

Trạng thái	Ý nghĩa
Chưa tải	Dịch vụ license trả về phiên bản này, nhưng không có gói cùng loại trong app.keeperbase
Có cập nhật	Gói local tồn tại, nhưng dịch vụ license có buildVersion cao hơn
Mới nhất	Build local lớn hơn hoặc bằng build của dịch vụ license, hoặc phiên bản local không có trong phản hồi dịch vụ

Tải xuống chạy ở background và trang hiển thị tiến độ. Quá trình tải hỗ trợ resume bằng HTTP Range. File được ghi trước vào thư mục tạm; sau khi hoàn tất sẽ chuyển tới app.keeperbase/<version>/ và xóa gói cũ cùng loại.

Định dạng tên file:

client_<version>_<buildVersion>.tar.gz
engine_<version>_<buildVersion>.tar.gz

API nội bộ Keeper

Dịch vụ quản trị cung cấp API nội bộ để node engine và client tự kiểm tra phiên bản và tải gói. Các API này cần JWT token nội bộ.

API	Mô tả
GET /internal/navi/keepers	Thu thập gói local từ app.keeperbase, trả về version, type, buildVersion và fileName
GET /internal/navi/downKeeper?version=<version>&type=<type>	Tải gói local theo version và type chỉ định, hỗ trợ HTTP Range

Node engine và client định kỳ gọi /internal/navi/keepers, so sánh file BUILD của phiên bản local, rồi gọi /internal/navi/downKeeper nếu chưa có phiên bản hoặc build local thấp hơn.

Xác minh kết quả

• Danh sách máy hiển thị máy mới.
• Danh sách máy hiển thị phiên bản tích hợp lấy từ keeper bind.
• Danh sách trình duyệt hiển thị instance mới.
• Danh sách trình duyệt hiển thị phiên bản trình duyệt. Nếu dùng "Phiên bản tích hợp", phiên bản tích hợp của máy liên quan cũng được hiển thị.
• Danh sách trình duyệt hiển thị chế độ mạng và khe mạng. Với trình duyệt mạng cách ly, nhấp "Chi tiết mạng" để kiểm tra DNS, việc DNS có đi qua proxy hay không, và chi tiết proxy.
• Quản lý phiên bản hiển thị trạng thái client và engine sau khi so sánh gói local với dịch vụ license.
• Khi người dùng truy cập site hoặc workspace, hệ thống có thể phân phối môi trường trình duyệt khả dụng.

Vấn đề thường gặp

• Instance trình duyệt cần khớp với node máy; máy hoặc keeper không khả dụng sẽ ảnh hưởng truy cập từ xa.
• Phiên bản trình duyệt, phiên bản thương hiệu và cấu hình OS ảnh hưởng nhận diện và tương thích site.
• Nếu trang phiên bản luôn hiển thị "Chưa tải", hãy kiểm tra quyền app.keeperbase, kết nối dịch vụ license và trạng thái tác vụ tải.
• Nếu tự động cập nhật không có hiệu lực, hãy kiểm tra node có truy cập được /internal/navi/keepers và /internal/navi/downKeeper hay không, đồng thời xác nhận JWT token đúng.
• Danh sách cửa sổ dùng để quan sát cửa sổ trình duyệt đang chạy và kiểm tra chiếm dụng.