Terminal
HƯỚNG DẪN TERMINAL TRÊN VPANEL
Tính năng Terminal cho bạn một shell Linux thực ngay trong trình duyệt — dùng xterm.js phía client và jailed shell phía server. Bạn có thể ls, find, grep, tar, wp, composer, npm và quản lý file như đã quen khi SSH. Session bị giới hạn trong home directory của account nên không đụng chạm tenant khác.
1. Mở Terminal
Đăng nhập User Panel cổng :2083. Ở thanh bên, chọn Terminal trong nhóm Advanced.
Giao diện
| Thành phần | Mô tả |
|---|---|
| Terminal Canvas | Vùng xterm.js. Hỗ trợ ANSI color đầy đủ, font co giãn được. |
| Prompt | Prompt bash đã cd sẵn vào home. |
| Toolbar | Copy, Paste, Clear, Reconnect, Fullscreen. |
| Status Bar | Trạng thái kết nối (Connected / Reconnecting / Disconnected). |
Nhấn vào vùng canvas để focus rồi gõ lệnh. Kết nối dùng websocket xác thực qua session vPanel — không cần đăng nhập SSH riêng.
2. Có thể làm gì
Mọi thứ bash thường làm, nhưng giới hạn trong home:
| Việc | Lệnh |
|---|---|
| Di chuyển | cd www/wordpress, pwd, ls -lah |
| Tìm file | find . -name "*.php" -newer wp-config.php |
| Tìm text | grep -R "TODO" src/ |
| Nén / giải nén | tar czf backup.tgz public_html/, unzip theme.zip |
| WP-CLI | wp core update, wp plugin list, wp db export dump.sql |
| Composer | composer install, composer update vendor/pkg |
| npm/pnpm | npm ci, npm run build |
| Sửa file | nano wp-config.php, vim .env |
Shell kế thừa PATH, HOME, và một số biến môi trường cơ bản. Alias muốn giữ vĩnh viễn cho vào ~/.bashrc.
3. Copy / Paste
Sandbox trình duyệt chặn shortcut gốc. Dùng toolbar:
- Copy — chép vùng đang chọn.
- Paste — dán clipboard tại con trỏ.
Hoặc dùng các phím tắt xterm chuẩn:
| Phím tắt | Hành động |
|---|---|
| Ctrl + Insert | Copy |
| Shift + Insert | Paste |
| Ctrl + Shift + C | Copy (một số trình duyệt) |
| Ctrl + Shift + V | Paste (một số trình duyệt) |
4. Vòng đời session
Websocket bị đóng sau 15 phút không hoạt động. Khi status bar báo Disconnected, bấm Reconnect — vPanel spawn shell mới trong home. Mọi thứ đang lưu trong bộ nhớ (biến đặt tay, job background) sẽ mất.
Lệnh chạy dài chỉ tồn tại qua reload nếu bạn khởi chạy bằng nohup … & hoặc trong tmux / screen.
5. Bảo mật & cô lập
- Shell chạy với Linux user của bạn, không phải root.
- Bị sandbox của panel giới hạn — không ghi được
/etc,/usr, home của tenant khác. - Package manager (
apt,dnf) không hoạt động — cần root. Dùng công cụ đã duyệt:wp,composer,npm. - Mọi lệnh được ghi log để audit; admin có thể xem lại khi cần.
6. Xử lý sự cố
Terminal báo "Disconnected" ngay
- Nguyên nhân: Trình duyệt chặn websocket (VPN, proxy công ty) hoặc phiên vPanel hết hạn.
- Cách xử lý: Reload trang, đăng nhập lại nếu bị yêu cầu, rồi Reconnect.
Lệnh chạy xong nhưng output bị cắt
- Nguyên nhân: Kích thước terminal không khớp.
- Cách xử lý: Đổi kích thước trình duyệt; xterm sẽ tự thương lượng. Hoặc chạy
stty rows 40 cols 120.
sudo báo "command not found"
- Nguyên nhân:
sudokhông có trong jailed shell (theo thiết kế). - Cách xử lý: Liên hệ admin nếu cần thao tác root.
Màu hiển thị lỗi
- Nguyên nhân: Sai
TERM. - Cách xử lý: Chạy
export TERM=xterm-256color.
Chúc bạn quản trị Server an toàn và hiệu quả!