Cấu hình Pano Client qua agent.env: Server URL, token và xử lý lỗi

Giải thích file agent.env trên Windows: tham số Server, token đăng ký, chu kỳ gửi dữ liệu, rollout hàng loạt và checklist khi máy không hiện trên Admin hoặc gallery không cập nhật.

Cấu hình Pano Client qua agent.env: Server URL, token và xử lý lỗi

Pano Client chạy nền trên máy Windows nhân viên, đọc cấu hình từ file agent.env trong thư mục cài đặt. File này xác định địa chỉ Pano Server, token đăng ký, chu kỳ gửi dữ liệu và một số tùy chọn mạng. Cấu hình sai là nguyên nhân phổ biến khiến Admin trống danh sách máy hoặc gallery không có ảnh mới. Bài viết mô tả từng tham số, quy trình triển khai hàng loạt và checklist xử lý lỗi kết nối.

Vị trí file agent.env

Sau khi cài Pano Client bằng installer hoặc gói ZIP Trial, file agent.env nằm cùng thư mục với binary agent, thường là thư mục Client trong gói giải nén hoặc Program Files tùy cách cài. Service Windows đọc file này khi khởi động. Sửa file cần quyền Administrator và khởi động lại service agent để áp dụng.

Không chia sẻ agent.env chứa token production qua email không mã hóa hoặc kênh chat công cộng.

Tham số cấu hình chính

Địa chỉ Server

Tham số chỉ định URL hoặc host và cổng của Pano Server mà agent gửi dữ liệu tới. Giá trị phải truy cập được từ máy client qua LAN hoặc VPN.

Ví dụ hợp lệ:

• http://192.168.1.50:8010
• http://pano-server.congty.local:8010

Không dùng localhost trên máy client trừ khi Server cài cùng máy đó trong lab. Máy nhân viên không có Server local.

Token đăng ký

Token lấy từ giao diện Admin sau khi cài Server, dùng để agent đăng ký máy vào fleet. Mỗi môi trường pilot hoặc production nên dùng token riêng. Token lộ cần tạo lại trên Admin và cập nhật agent.env trên toàn bộ máy.

Token sai biểu hiện: agent chạy nhưng máy không xuất hiện trên Admin hoặc báo lỗi xác thực trong log service.

Chu kỳ chụp và gửi dữ liệu

Chu kỳ do license và cấu hình Server quyết định. Trial thường khoảng 10 giây, Starter và Business khoảng 5 giây. Không nên chỉnh giảm chu kỳ trên client nếu license không hỗ trợ vì Server có thể từ chối hoặc bỏ qua.

Tùy chọn mạng và proxy

Môi trường chỉ LAN: agent kết nối trực tiếp IP nội bộ. Môi trường có proxy HTTP doanh nghiệp: cần whitelist đích Server hoặc cấu hình proxy trong tài liệu triển khai PANO nếu phiên bản hỗ trợ. VPN chi nhánh: client phải ping được IP Server qua tunnel trước khi cài agent.

Quy trình cấu hình chuẩn

Bước 1: Hoàn tất Server

Cài và khởi động Pano Server trước. Mở Admin trên cổng 8010 từ một máy trong LAN, xác nhận đăng nhập bằng token Admin hoạt động. Tạo hoặc copy token đăng ký agent từ Admin.

Bước 2: Pilot một máy

1. Cài Client trên một máy Windows trong cùng subnet với Server 2. Sửa agent.env với SERVER_URL và token đúng 3. Khởi động lại service Pano Client 4. Trên Admin, đợi vài chu kỳ chụp, kiểm tra máy chuyển online và gallery có ảnh mới

Pilot thành công trước khi rollout hàng chục máy.

Bước 3: Rollout hàng loạt

• Chuẩn hóa một file agent.env mẫu, chỉ khác hostname máy nếu cần
• Triển khai qua GPO, script PowerShell, SCCM hoặc công cụ MDM nội bộ
• Ghi log máy nào đã cài và ngày cài để đối chiếu Admin
• Trên gói Business, dùng push cập nhật agent từ Server sau khi fleet ổn định

Kiểm tra kết nối từ máy client

Trước khi sửa agent.env, chạy trên CMD hoặc PowerShell của máy nhân viên:

1. ping dia-chi-server 2. curl hoặc mở trình duyệt tới http://dia-chi-server:8010 nếu firewall cho phép

Nếu ping fail: lỗi mạng hoặc VPN, không phải lỗi Pano. Nếu ping ok nhưng Admin không mở từ client: kiểm tra firewall Windows trên Server và rule cổng 8010.

Lỗi thường gặp và cách xử lý

Máy không hiện trên Admin

• Kiểm tra service Pano Client đang Running trong services.msc
• Đọc log agent trong thư mục cài đặt hoặc Event Viewer
• Xác nhận SERVER_URL không thừa khoảng trắng, đúng http và cổng 8010
• Xác nhận token khớp Admin, không hết hạn license Trial 7 ngày

Gallery không có ảnh mới

• Máy offline trên Admin: kiểm tra mạng và service agent
• Máy online nhưng ảnh cũ: kiểm tra đồng hồ hệ thống client và server lệch quá lớn
• Ổ Server đầy: agent có thể không ghi được, giải phóng dung lượng hoặc rút retention

Lỗi sau khi đổi IP Server

Khi chuyển Server sang máy mới hoặc đổi IP:

1. Cập nhật agent.env trên toàn fleet hoặc dùng DNS nội bộ trỏ hostname ổn định 2. Khởi động lại service client 3. Xác nhận máy đăng ký lại trên Admin

Dùng hostname DNS nội bộ thay IP tĩnh giúp giảm sửa hàng loạt sau này.

Xung đột phần mềm bảo mật

Antivirus hoặc EDR có thể chặn agent chụp màn hình. Whitelist thư mục cài Pano Client và process agent theo khuyến nghị PANO. Bộ phận quản lý phối hợp đội bảo mật nội bộ trước go-live.

Bảo mật file agent.env

• Phân quyền NTFS chỉ Administrator và service account đọc được
• Không đặt token trong script login user thường
• Rotate token khi nhân sự triển khai nghỉ việc hoặc nghi ngờ lộ
• Trial hết hạn: gia hạn license hoặc gỡ agent theo chính sách công ty

Khác biệt Trial và bản license trả phí

Trial giới hạn 10 máy và 7 ngày. agent.env cấu hình giống bản trả phí nhưng Server từ chối đăng ký máy thứ 11 hoặc sau ngày hết hạn. Khi mua Starter hoặc Business, cập nhật license trên Server theo hướng dẫn PANO, agent.env trên client thường không cần đổi nếu Server URL và token vẫn hợp lệ.

Phối hợp quản lý và người triển khai

Người triển khai giữ bản agent.env mẫu, script cài và log rollout. Bộ phận quản lý xác nhận danh sách máy pilot và phạm vi phòng ban trước khi gắn agent. HR đảm bảo thông báo nhân viên đã hoàn tất trước khi bật giám sát trên máy làm việc.

Tài liệu liên quan

• Hướng dẫn cài PANO Trial 7 ngày trên blog PANO
• Bài viết triển khai Server trước Client sau
• Trang tải chính thức: panosoftware.com/trial