swap-setup — Thêm swap cho VPS qua chat (không cần terminal)
Giúp người dùng không rành kỹ thuật thêm dung lượng swap cho VPS mà không phải gõ lệnh. Người dùng chỉ làm một việc duy nhất bằng click chuột (dán public key vào panel VPS).
⚠️ CẢNH BÁO — ĐỌC KỸ TRƯỚC KHI CHẠY
Việc này thay đổi hệ thống của VPS:
Agent cần quyền SSH (qua key) vào VPS để chạy lệnh với quyền sudo/root.
Agent sẽ sửa /etc/fstab (thêm 1 dòng cho swap) — file ảnh hưởng tới lúc khởi động máy.
Agent sẽ tạo/xóa file /swapfile trên ổ đĩa của VPS.
Chỉ chạy khi người dùng hiểu và đồng ý. Agent phải nêu rõ các điểm trên và chờ người dùng xác nhận trước khi làm.
Phạm vi (scope) — chỉ đúng việc này:
Tạo một swapfile và bật nó.
Thêm đúng 1 dòng vào /etc/fstab để swap tự bật lại sau reboot.
Không cài phần mềm, không đụng dữ liệu, không sửa dịch vụ khác, không đổi cấu hình SSH.
🔑 CƠ CHẾ: KEY-ONLY, DÙNG MỘT LẦN (THU HỒI SAU KHI XONG).
Agent tự tạo một cặp SSH key dùng riêng cho việc này. Agent giữ private key, chỉ đưa public key cho người dùng. Người dùng copy public key rồi dán vào ô SSH Keys trong panel quản trị VPS (Vultr, DigitalOcean, AWS Lightsail, aCloud, Vietnix, AZDIGI, ...). Không có bí mật nào đi qua chat; không có mật khẩu; người dùng không mở terminal.
⏹ Thu hồi khi xong (bắt buộc): sau khi tạo swap thành công, agent xóa cặp key dùng riêng cho việc này khỏi máy agent và hướng dẫn người dùng xóa key đó khỏi panel VPS. Key sinh ra chỉ để chạy một lần, không giữ lại quyền truy cập thường trực.
Khi nào dùng
Người dùng nói kiểu:
"VPS em yếu quá, thêm swap giúp"
"Máy 1GB RAM, tạo swap 2GB"
"Cài swap cho VPS giúp em, em không biết dùng terminal"
"Thêm swap mà không cần mở SSH"
Input cần thu thập (từ người dùng)
Host/IP VPS (số hoặc tên miền).
Port (mặc định 22 nếu không nói).
User đăng nhập (thường root, hoặc user có sudo; nếu không rõ → hỏi hoặc thử root).
Swap size mong muốn (nếu không nói → mặc định theo RAM: RAM ≤2GB → swap = 2× RAM, cap 4GB; RAM >2GB → swap = RAM, cap 4GB; RAM ≥8GB → 2–4GB).
Nhà cung cấp VPS (nếu biết) → để hướng dẫn đúng giao diện panel.
Nếu thiếu host/user → hỏi lại đúng cái thiếu. KHÔNG tự đoán IP.
Quy trình agent PHẢI làm (theo đúng thứ tự)
Bước 0 — Xác nhận danh tính + xin đồng ý
Chỉ thực thi khi người yêu cầu là owner. Nếu không chắc → hỏi xác nhận trước.
Nêu rõ cảnh báo ở đầu bài (SSH + sudo/root + sửa /etc/fstab + tạo/xóa /swapfile) và chờ người dùng đồng ý.
Nói rõ: "Em sẽ tạo swap giúp anh/chị. Anh/chị chỉ cần copy đoạn key em đưa rồi dán vào mục SSH Keys trong panel VPS. Xong việc em hướng dẫn xóa key đó đi."
Bước 1 — Tạo cặp key DÙNG RIÊNG + đưa public key
Tạo key riêng, đặt tên riêng để xóa dễ (không ghi đè key khác):
bash
Kiểm tra đã có dòng /swapfile chưa (tránh trùng):
grep -nE '^[^#]*swap' /etc/fstab
Chỉ append nếu CHƯA có:
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
VALIDATE trước khi reboot — BẮT BUỘC:sudo findmnt --verify --verbose (hoặc sudo mount -a — lỗi thì DỪNG và khôi phục backup)
sudo swapon -a để chắc chắn nạp lại không lỗi.
Nếu mount -a báo lỗi → restore fstab.bak ngay, báo người dùng. Sai fstab = máy không boot.
(Khuyến nghị) giảm swappiness: đặt vm.swappiness=10 qua /etc/sysctl.d/99-swap.conf, rồi sudo sysctl --system.
Bước 6 — THU HỒI KEY (bắt buộc — không để lại quyền truy cập thường trực)