README

Mở rộng opcodesio/log-viewer cho mô hình "một Log Viewer xem log của nhiều host":

Auth thống nhất. Request server-to-server giữa các host đi bằng Authorization: Bearer <shared secret>. Người dùng thật thì hỏi Gate viewLogViewer.
Tải file log của host ở xa. Package gốc không tải được: nút Download gọi XHR sang origin khác (CORS chặn), và route download bên đó vẫn có AuthorizeLogViewer nên trình duyệt không có session cũng 403. Package viết lại download_url về origin hiện tại rồi tải hộ server-to-server, stream về client.
Bớt cấu hình tay. Hosts khai bằng env, api_stateful_domains mặc định theo APP_URL.

Cài

Trên mọi host (host xem và host bị xem):

composer require hocvt/log-viewer-remote
php artisan log-viewer-remote:secret     # sinh LOG_VIEWER_SHARED_SECRET, copy sang các host khác

Trên host xem log, thêm vào .env:

LOG_VIEWER_HOSTS="web=https://app.example.com/log-viewer,api=https://api.example.com/log-viewer"

Trên host chạy production, mở quyền xem trong AppServiceProvider::boot():

Gate::define('viewLogViewer', fn (?User $user): bool => (bool) $user?->isAdmin());

Mặc định của package: local cho qua, môi trường khác chặn hết.

App không dùng Gate được

Có app mà mọi lần gọi Gate với user đã đăng nhập đều ném TypeError: cài spatie/laravel-permission (nó đăng ký một Gate::before nhận Illuminate\Contracts\Auth\Access\Authorizable) trong khi model User không implement contract đó. Thường gặp ở codebase cũ tự làm tầng phân quyền riêng và đã có sẵn User::can() với ngữ nghĩa khác, nên không thể implement Authorizable mà không làm gãy chỗ khác.

Những app đó bỏ qua tầng Gate bằng cách cắm callback riêng, đường shared secret giữa các host vẫn giữ nguyên:

use HocVT\LogViewerRemote\LogViewerRemote;

LogViewerRemote::authorizeUsing(
    fn (Request $request): bool => app()->isLocal() || access()->hasRoles(['Administrator'])
);

Cắm callback thì Gate viewLogViewer không còn được hỏi tới.

Kiểm tra kết nối:

php artisan log-viewer-remote:check

Đổi prefix mặc định

Nên đổi. Mặc định Log Viewer nằm ở /log-viewer — ai cũng đoán được, và trang này phơi toàn bộ log ứng dụng. Gate chặn người lạ, nhưng một URL không đoán được sẽ cắt luôn lượt dò của bot trước khi chạm tới tầng xác thực. Publish config rồi đổi:

php artisan vendor:publish --tag=log-viewer-config

// config/log-viewer.php
'route_path' => 'sys/x9f2logs',   // nhiều đoạn cũng được

route_path không đọc env, nên bắt buộc publish config mới đổi được. Đổi xong nhớ php artisan optimize:clear (hoặc route:cache lại nếu đang cache route).

Toàn bộ route đi theo prefix mới, kể cả hai route của package này, và thứ tự vẫn đúng — chúng vẫn đứng trước route bắt-tất {prefix}/{view?}.

Ba điều cần nhớ khi đã đổi:

Prefix của mỗi host là độc lập. Host A xem log host B thì chỉ cần URL trong LOG_VIEWER_HOSTS trỏ đúng gốc Log Viewer của B. Hai bên đặt prefix khác nhau vẫn chạy.
Khai host phải kèm prefix. Chỉ URL trần mới được tự bù, và giá trị bù là route_path của chính host đang khai — tức đoán cả cụm dùng chung quy ước:
```
LOG_VIEWER_HOSTS="a=https://a.example.com/sys/x9f2logs,b=https://b.example.com"
```
b sẽ thành https://b.example.com/<route_path của host này>. Nếu b đặt prefix khác, phải viết đủ. Sai prefix thì log-viewer-remote:check báo 404 — sai route_path.
Đừng hardcode /log-viewer trong test hay link. Dùng config('log-viewer.route_path'), không thì đổi prefix là gãy hàng loạt.

Cấu hình

php artisan vendor:publish --tag=log-viewer-remote-config nếu cần đổi timeout. Các key:

Key	Env	Ý nghĩa
`shared_secret`	`LOG_VIEWER_SHARED_SECRET` (fallback `LOG_VIEWER_PRODUCTION_TOKEN`)	Bearer token giữa các host
`hosts`	`LOG_VIEWER_HOSTS`	`id=url,id2=url2`; merge vào `log-viewer.hosts`, không ghi đè host đã khai tay
`timeout.request` / `timeout.download`	—	Giây, gọi sang host xa

Host cần tên đẹp, basic auth hay header riêng thì khai trong config/log-viewer.php như bình thường; package chỉ điền những id chưa có.

Những chỗ dễ làm hỏng khi sửa

Route nạp ở register(), không ở boot(). Package gốc đăng ký route bắt-tất log-viewer/{view?} (where '.*') trong boot(); mọi route dưới /log-viewer khai sau nó đều bị nuốt.
Thay middleware vendor bằng container binding. ForwardRequestToHostMiddleware được gắn cứng trong routes/api.php của package gốc; Pipeline resolve middleware bằng container->make() nên bind() là đủ.
Không gửi X-Forwarded-Host khi xin link ký. Host xa phải ký URL bằng domain của chính nó, nếu không chữ ký hỏng khi gọi lại.
Stream theo chunk, không ->body(). Log production có thể vài trăm MB.
Gate mặc định định nghĩa trong boot() của package. App provider boot sau nên Gate::define trong AppServiceProvider ghi đè được.

Gỡ rối

File tải về bị chèn rác ở đầu (vài byte khoảng trắng), md5 không khớp. App có output lọt ra trước response — thường là file PHP có khoảng trắng trước <?php hoặc sau ?>, và file đó được nạp ở mọi request (route file, config, helper). Rác đó chui vào đầu MỌI response tải file của app, không riêng Log Viewer. Tìm bằng:

php -r '$b=file_get_contents($argv[1]); exit(str_starts_with($b,"<?php")?0:1);' <file>

Đi qua proxy thì rác nhân đôi, vì cả host xem lẫn host xa đều thêm phần của mình.

UI 403 toàn bộ API. EnsureFrontendRequestsAreStateful chưa nhận domain hiện tại. Package tự điền theo APP_URL; nếu truy cập bằng domain khác thì khai LOG_VIEWER_API_STATEFUL_DOMAINS.

log-viewer-remote:check báo 403. Token hai bên lệch, hoặc host xa chưa cài package.

Identifier file khác nhau giữa CLI và web. Identifier là hash của đường dẫn tuyệt đối, mà CLI và php-fpm có thể resolve storage_path() khác nhau. Luôn lấy identifier từ cùng tiến trình sẽ tải — luồng UI vốn đã đúng, chỉ sai khi copy tay từ tinker.

Mặc định package gốc quét cả /var/log/nginx/* và vài đường dẫn hệ thống. Nếu không muốn, publish config/log-viewer.php rồi thu hẹp include_files.

Test

Chưa có test riêng trong package (cần orchestra/testbench). Test tích hợp nằm ở project dùng package: tests/Feature/LogViewer/.

hocvt / log-viewer-remote

Package info

Security

Statistics