@softtynet/zplus-worker 1.0.54 → 1.0.56
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -27
- package/dist/cli.js +132 -237
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -9,9 +9,8 @@ ZPlus 24/7 Headless Personal Zalo Automation & Cloud Sync Worker Daemon.
|
|
|
9
9
|
`@softtynet/zplus-worker` là tiến trình chạy nền độc lập 24/7 cho hệ sinh thái ZPlus Enterprise. Phân hệ chịu trách nhiệm duy trì phiên kết nối tài khoản Zalo cá nhân, tiếp nhận tin nhắn và thực thi kịch bản tự động hóa liên tục ngay cả khi người dùng tắt máy tính cá nhân.
|
|
10
10
|
|
|
11
11
|
- **100% Headless**: Chạy trên mọi VPS Linux không cần màn hình hay trình duyệt.
|
|
12
|
-
- **Bảo Mật
|
|
13
|
-
- **
|
|
14
|
-
- **Ghép Nối 1-Click**: Tạo mã ghép nối trực tiếp từ ZPlus Desktop.
|
|
12
|
+
- **Bảo Mật OAuth 2.0 Device Flow (RFC 8628)**: Đăng nhập an toàn qua `zplus login` (Quét mã QR hoặc nhập mã 8 ký tự trên điện thoại / trình duyệt), không cần API Key backend.
|
|
13
|
+
- **Hỗ Trợ Mọi Gói Cước**: Cho phép cả tài khoản Miễn phí (Free Tier - Đệm Cloud 7 ngày) và gói Doanh Nghiệp / Premium (Trực ban 24/7 không giới hạn).
|
|
15
14
|
|
|
16
15
|
---
|
|
17
16
|
|
|
@@ -24,7 +23,8 @@ ZPlus 24/7 Headless Personal Zalo Automation & Cloud Sync Worker Daemon.
|
|
|
24
23
|
Mở **PowerShell** và chạy:
|
|
25
24
|
|
|
26
25
|
```powershell
|
|
27
|
-
& { irm https://zplus.softty.net/install.ps1 | iex }
|
|
26
|
+
& { irm https://zplus.softty.net/install.ps1 | iex }
|
|
27
|
+
zplus login
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
> Tự động cài Node.js, thiết lập Task Scheduler (`onstart`). Mất điện hay khởi động lại máy thì Worker **tự động chạy ngầm ngay từ màn hình boot**.
|
|
@@ -35,10 +35,10 @@ Mở **Terminal** và chạy:
|
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
37
|
# Cài đặt tự động bằng Systemd/LaunchAgent (Khuyên dùng):
|
|
38
|
-
curl -fsSL https://zplus.softty.net/install.sh | bash
|
|
38
|
+
curl -fsSL https://zplus.softty.net/install.sh | bash && zplus login
|
|
39
39
|
|
|
40
40
|
# Hoặc cài đặt tự động bằng Docker Container:
|
|
41
|
-
curl -fsSL https://zplus.softty.net/install-docker.sh | bash
|
|
41
|
+
curl -fsSL https://zplus.softty.net/install-docker.sh | bash && zplus login
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
---
|
|
@@ -46,34 +46,37 @@ curl -fsSL https://zplus.softty.net/install-docker.sh | bash -s -- --pair="<TOKE
|
|
|
46
46
|
### Cách 2: Cài Đặt Toàn Cục Bằng NPM & Vận Hành Thủ Công
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
|
-
# Cài đặt qua NPM
|
|
49
|
+
# Cài đặt qua NPM (cung cấp lệnh ngắn gọn `zplus` và bí danh `zplus-worker`)
|
|
50
50
|
npm install -g @softtynet/zplus-worker
|
|
51
51
|
|
|
52
|
-
#
|
|
53
|
-
|
|
52
|
+
# Xem bảng trợ giúp:
|
|
53
|
+
zplus help
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
####
|
|
56
|
+
#### Đăng Nhập Cho Worker Trên VPS / Máy Chủ (OAuth 2.0 Device Flow - RFC 8628)
|
|
57
57
|
|
|
58
|
-
|
|
58
|
+
Chạy lệnh sau trên Terminal của VPS hoặc máy tính:
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
|
-
|
|
61
|
+
zplus login
|
|
62
62
|
```
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
Hệ thống sẽ hiển thị đồng thời **Mã QR Dương bản** ngay trên Terminal (để đưa Camera điện thoại hoặc Zalo quét 1-chạm) và **Mã xác nhận 8 ký tự (`XXXX-XXXX`)** tại `https://accounts.softty.net/device`.
|
|
65
|
+
|
|
66
|
+
> 🛡️ **Tự động gia hạn 24/7:** Phiên đăng nhập tích hợp OAuth 2.0 Refresh Token Rotation (RTR) và Dedicated Cluster Session (365 ngày). Worker sẽ tự động làm mới phiên ngầm mà không cần đăng nhập lại.
|
|
65
67
|
|
|
66
68
|
#### Kiểm tra trạng thái xác thực & phân quyền
|
|
67
69
|
|
|
68
70
|
```bash
|
|
69
|
-
|
|
71
|
+
zplus status
|
|
72
|
+
zplus whoami
|
|
70
73
|
```
|
|
71
74
|
|
|
72
75
|
#### Khởi chạy 24/7 với PM2
|
|
73
76
|
|
|
74
77
|
```bash
|
|
75
78
|
npm install -g pm2
|
|
76
|
-
pm2 start zplus
|
|
79
|
+
pm2 start zplus --name "zplus-worker" --time -- start
|
|
77
80
|
pm2 save && pm2 startup
|
|
78
81
|
```
|
|
79
82
|
|
|
@@ -81,18 +84,21 @@ pm2 save && pm2 startup
|
|
|
81
84
|
|
|
82
85
|
## 📖 Bảng Lệnh CLI (Command Cheatsheet)
|
|
83
86
|
|
|
84
|
-
| Lệnh
|
|
85
|
-
|
|
|
86
|
-
| `zplus
|
|
87
|
-
| `zplus
|
|
88
|
-
| `zplus
|
|
89
|
-
| `zplus
|
|
90
|
-
| `zplus
|
|
91
|
-
| `zplus
|
|
92
|
-
| `zplus
|
|
93
|
-
| `zplus
|
|
94
|
-
| `zplus
|
|
95
|
-
| `zplus
|
|
87
|
+
| Lệnh | Ý nghĩa |
|
|
88
|
+
| :----------------------------- | :----------------------------------------------------------------- |
|
|
89
|
+
| `zplus help` | Hiển thị bảng trợ giúp và các tùy chọn |
|
|
90
|
+
| `zplus login` | Đăng nhập qua OAuth 2.0 Device Flow (Quét QR / Mã 8 ký tự) |
|
|
91
|
+
| `zplus logout` | Đăng xuất và thu hồi phiên lưu trữ trên máy chủ |
|
|
92
|
+
| `zplus status` | Kiểm tra trạng thái đăng nhập, vai trò Owner/Member, gói dịch vụ |
|
|
93
|
+
| `zplus whoami` | Xem thông tin định danh Worker, Doanh nghiệp (Team) và Gói cước |
|
|
94
|
+
| `zplus accounts` | Liệt kê chi tiết danh sách tài khoản Zalo đang trực chiến WSS 24/7 |
|
|
95
|
+
| `zplus doctor` | Chẩn đoán sức khỏe toàn diện: OS, RAM, Cloud API, Mạng, File |
|
|
96
|
+
| `zplus health` (hoặc `ping`) | Kiểm tra nhịp tim: Uptime, Nick đang chạy WSS, RAM chiếm dụng |
|
|
97
|
+
| `zplus logs` | Xem trực tiếp live logs tiến trình nền đang chạy (PM2 / Docker) |
|
|
98
|
+
| `zplus stop` / `zplus restart` | Dừng hoặc khởi động lại tiến trình Worker chạy nền |
|
|
99
|
+
| `zplus uninstall` | Dừng tiến trình PM2/Docker/Systemd và gỡ bỏ Worker an toàn |
|
|
100
|
+
| `zplus uninstall --purge` | Gỡ bỏ hoàn toàn kèm xóa sạch cache, dữ liệu & logs (~/.zplus) |
|
|
101
|
+
| `zplus start` (mặc định) | Khởi chạy Worker Daemon 24/7 |
|
|
96
102
|
|
|
97
103
|
> 💡 **Gỡ cài đặt 1-Click tự động:** Bạn cũng có thể chạy lệnh sau trên VPS:
|
|
98
104
|
> `curl -fsSL https://zplus.softty.net/uninstall.sh | bash` (hoặc thêm `--purge` để xóa toàn bộ dữ liệu).
|