Hướng dẫn KumoKumo guideKumo ガイド

• VPS mới cài OS, chưa có Apache, Nginx hay MySQL: Ubuntu 22.04/24.04, Debian 12/13, AlmaLinux hoặc Rocky Linux 8/9.
• Tối thiểu 1GB RAM (khuyên dùng 2GB), 5GB ổ trống, kiến trúc x86_64 hoặc ARM64.
• Quyền root (hoặc user có sudo).
• Cổng 80 và 443 mở ra Internet (để cấp SSL).

• A freshly installed VPS without Apache, Nginx or MySQL: Ubuntu 22.04/24.04, Debian 12/13, AlmaLinux or Rocky Linux 8/9.
• At least 1GB RAM (2GB recommended), 5GB free disk, x86_64 or ARM64.
• Root access (or a user with sudo).
• Ports 80 and 443 reachable from the Internet (for SSL).

• Apache、Nginx、MySQL が入っていない、OS をインストールしたばかりの VPS: Ubuntu 22.04/24.04、Debian 12/13、AlmaLinux または Rocky Linux 8/9。
• メモリ 1GB 以上（2GB 推奨）、空きディスク 5GB 以上、x86_64 または ARM64。
• root 権限（または sudo が使えるユーザー）。
• インターネットからポート 80 と 443 に到達できること（SSL 発行のため）。

1. Đăng nhập VPS qua SSH bằng root: ssh root@IP-VPS
2. Tải script cài đặt:

   curl -fsSL https://kumovps.xyz/install -o install

   Script rất ngắn. Bạn nên mở ra đọc trước (less install): nó chỉ tải bản Kumo đã đóng gói, kiểm tra SHA256 rồi chạy trình cài đặt.
3. Chạy:

   sudo bash install

4. Trả lời các câu hỏi: ngôn ngữ, phiên bản PHP, phiên bản MariaDB, email, cổng trang quản trị, có đổi cổng SSH không, múi giờ, domain chính (có thể để trống), có bật AIDE không.
5. Đợi khoảng 10-20 phút. Khi thấy CÀI ĐẶT THÀNH CÔNG, hãy lưu lại thông tin đăng nhập được in ra.

Tự kiểm tra checksum (tùy chọn)

Mã băm SHA256 của mọi bản phát hành nằm ở /releases/SHA256SUMS. Để tự tải và kiểm tra:

curl -fsSLO https://kumovps.xyz/releases/kumo-1.0.4.tar.gz
curl -fsSL https://kumovps.xyz/releases/SHA256SUMS | sha256sum -c --ignore-missing
tar -xzf kumo-1.0.4.tar.gz && cd kumo-1.0.4 && sudo bash install.sh

Cài không tương tác

Dùng cho script tự động hoặc cloud-init. Đặt biến môi trường trước lệnh cài:

1. Log in to your VPS as root: ssh root@VPS-IP
2. Download the installer:

   curl -fsSL https://kumovps.xyz/install -o install

   It is short; read it first (less install). It only downloads the packaged Kumo release, checks its SHA256 and runs the installer.
3. Run it:

   sudo bash install

4. Answer the questions: language, PHP version, MariaDB version, email, admin panel port, whether to move SSH to a new port, timezone, main domain (optional), AIDE.
5. Wait about 10-20 minutes. When you see INSTALLATION COMPLETE, save the credentials it prints.

Verify the checksum yourself (optional)

SHA256 hashes of every release are in /releases/SHA256SUMS. To download and verify manually:

curl -fsSLO https://kumovps.xyz/releases/kumo-1.0.4.tar.gz
curl -fsSL https://kumovps.xyz/releases/SHA256SUMS | sha256sum -c --ignore-missing
tar -xzf kumo-1.0.4.tar.gz && cd kumo-1.0.4 && sudo bash install.sh

Unattended install

For automation or cloud-init, set environment variables before the install command:

1. root で VPS に SSH ログインします: ssh root@VPS の IP
2. インストーラーをダウンロードします:

   curl -fsSL https://kumovps.xyz/install -o install

   短いスクリプトなので、先に中身を確認してください（less install）。Kumo のリリースをダウンロードし、SHA256 を確認してからインストーラーを実行するだけです。
3. 実行します:

   sudo bash install

4. 質問に答えます: 言語、PHP バージョン、MariaDB バージョン、メール、管理画面のポート、SSH ポートを変更するか、タイムゾーン、メインドメイン（任意）、AIDE。
5. 10〜20 分ほど待ちます。インストール完了 と表示されたら、表示された認証情報を保存してください。

チェックサムを自分で確認する（任意）

全リリースの SHA256 は /releases/SHA256SUMS にあります。手動でダウンロードして確認する場合:

curl -fsSLO https://kumovps.xyz/releases/kumo-1.0.4.tar.gz
curl -fsSL https://kumovps.xyz/releases/SHA256SUMS | sha256sum -c --ignore-missing
tar -xzf kumo-1.0.4.tar.gz && cd kumo-1.0.4 && sudo bash install.sh

無人インストール

自動化や cloud-init 用に、インストールコマンドの前に環境変数を設定します:

• Gõ kumo để mở menu quản lý. Nhấn Ctrl+C để thoát bất cứ lúc nào.
• Mọi mật khẩu được lưu trong /root/kumo-credentials.txt (chỉ root đọc được). Xem bằng cat /root/kumo-credentials.txt.
• Trang quản trị: https://IP-VPS:CỔNG/ (user admin). Trình duyệt sẽ cảnh báo vì dùng chứng chỉ tự ký, hãy chấp nhận. Trong trang có phpMyAdmin, trạng thái server, OPcache.

• Type kumo to open the management menu. Press Ctrl+C to exit at any time.
• All passwords are saved in /root/kumo-credentials.txt (readable by root only). View it with cat /root/kumo-credentials.txt.
• Admin panel: https://VPS-IP:PORT/ (user admin). Your browser will warn about the self-signed certificate; accept it. The panel links to phpMyAdmin, server status and OPcache.

• kumo と入力すると管理メニューが開きます。Ctrl+C でいつでも終了できます。
• パスワードはすべて /root/kumo-credentials.txt（root のみ読み取り可）に保存されます。cat /root/kumo-credentials.txt で確認できます。
• 管理画面: https://VPS の IP:ポート/（ユーザー admin）。自己署名証明書のためブラウザに警告が出ますが、承認して進んでください。phpMyAdmin、サーバー状態、OPcache へのリンクがあります。

1. Tại nơi quản lý DNS, tạo bản ghi A cho example.com và www.example.com trỏ về IP VPS.
2. Chạy kumo > Quản lý website > Thêm website, nhập domain.
3. Kumo tạo user Linux riêng, pool PHP riêng và thư mục /home/example.com/public_html, rồi hỏi có cài SSL luôn không.
4. Upload code qua SFTP vào public_html.

Park domain và redirect domain

• Park domain: domain phụ hiển thị cùng nội dung với site chính (vd example.net dùng chung code với example.com).
• Redirect domain: domain chuyển hướng 301 sang URL khác, có thể giữ nguyên đường dẫn.

Rule nginx riêng

Đừng sửa file trong /etc/nginx/sites/ vì Kumo sẽ sinh lại chúng. Hãy đặt rule riêng (rewrite, location...) vào /etc/nginx/custom/DOMAIN.conf, rồi chạy nginx -t && systemctl reload nginx.

Phân quyền

Nếu website báo lỗi không ghi được file sau khi upload, vào Quản lý website > Phân quyền webserver để đặt lại chủ sở hữu và quyền chuẩn.

1. In your DNS provider, create A records for example.com and www.example.com pointing to the VPS IP.
2. Run kumo > Websites > Add website and enter the domain.
3. Kumo creates a dedicated Linux user, a PHP pool and /home/example.com/public_html, then offers to install SSL right away.
4. Upload your code to public_html via SFTP.

Parked and redirect domains

• Parked domain: an extra domain that serves the same content (e.g. example.net sharing the code of example.com).
• Redirect domain: a domain that 301-redirects to another URL, optionally keeping the path.

Custom nginx rules

Do not edit files in /etc/nginx/sites/: Kumo regenerates them. Put your own rules (rewrites, locations...) in /etc/nginx/custom/DOMAIN.conf, then run nginx -t && systemctl reload nginx.

Permissions

If a website cannot write files after an upload, use Websites > Fix web server permissions to reset ownership and modes.

1. DNS 管理画面で example.com と www.example.com の A レコードを VPS の IP に向けます。
2. kumo > ウェブサイト管理 > ウェブサイトを追加 を選び、ドメインを入力します。
3. Kumo が専用の Linux ユーザー、PHP プール、/home/example.com/public_html を作成し、続けて SSL をインストールするか尋ねます。
4. SFTP で public_html にコードをアップロードします。

パークドメインとリダイレクトドメイン

• パークドメイン: 同じ内容を表示する追加ドメイン（例: example.net が example.com のコードを共有）。
• リダイレクトドメイン: 別の URL へ 301 リダイレクトするドメイン。パスを維持することもできます。

独自の nginx ルール

/etc/nginx/sites/ のファイルは Kumo が再生成するため編集しないでください。独自ルール（rewrite、location など）は /etc/nginx/custom/DOMAIN.conf に書き、nginx -t && systemctl reload nginx を実行します。

権限

アップロード後にサイトがファイルを書き込めない場合は、ウェブサイト管理 > Web サーバーの権限を修正 で所有者と権限を元に戻します。

• Menu SSL > Cài / cấp lại SSL. Kumo kiểm tra DNS từng tên (domain, www, park domain) trước khi xin chứng chỉ.
• Chứng chỉ tự gia hạn. Kiểm tra bằng SSL > Kiểm tra gia hạn tự động.
• Nếu dùng Cloudflare với đám mây cam (proxy), Kumo sẽ cảnh báo IP không khớp. Bạn vẫn có thể chọn thử cấp; nếu lỗi, hãy tạm tắt proxy khi cấp.

• SSL menu > Issue / renew. Kumo checks the DNS of every name (domain, www, parked domains) before requesting a certificate.
• Certificates renew automatically. Check with SSL > Test automatic renewal.
• With Cloudflare's orange-cloud proxy, Kumo warns that the IP does not match. You can still try; if it fails, pause the proxy while issuing.

• SSL メニュー > SSL を発行 / 再発行。証明書をリクエストする前に、各名前（ドメイン、www、パークドメイン）の DNS を確認します。
• 証明書は自動更新されます。SSL > 自動更新をテスト で確認できます。
• Cloudflare のプロキシ（オレンジの雲）を使っていると IP 不一致の警告が出ます。そのまま試すこともできますが、失敗した場合は発行中だけプロキシを停止してください。

Tạo website trước, rồi chọn Quản lý website > Cài WordPress. Kumo tự tạo database, tải WordPress đúng ngôn ngữ, tạo tài khoản admin với mật khẩu mạnh và bật permalink đẹp. Site phải trống (chỉ có trang mặc định).

Mặc định Kumo chặn các hàm PHP nguy hiểm (exec, shell_exec...). Nếu plugin cần, tắt chặn cho riêng site đó ở Quản lý website > Bật/tắt chặn hàm PHP nguy hiểm.

Create the website first, then choose Websites > Install WordPress. Kumo creates the database, downloads WordPress in your language, creates an admin account with a strong password and enables pretty permalinks. The site must be empty (only the default page).

By default Kumo blocks dangerous PHP functions (exec, shell_exec...). If a plugin needs them, unblock them for that site only in Websites > Block/allow dangerous PHP functions.

先にウェブサイトを作成してから、ウェブサイト管理 > WordPress をインストール を選びます。Kumo がデータベースを作成し、選択した言語の WordPress をダウンロードして、強力なパスワードの管理者アカウントを作り、パーマリンクを設定します。サイトは空（デフォルトページのみ）である必要があります。

Kumo は危険な PHP 関数（exec、shell_exec など）を標準でブロックします。プラグインが必要とする場合は、ウェブサイト管理 > 危険な PHP 関数のブロック切替 でそのサイトだけ解除してください。

Quản lý website > Tài khoản SFTP. Mỗi site có tài khoản riêng, chỉ thấy thư mục của site đó. Dùng FileZilla, WinSCP hoặc VS Code với giao thức SFTP, host là IP VPS, cổng là cổng SSH, thư mục code là /public_html.

Websites > SFTP account. Each site gets its own account that can only see that site's folder. Use FileZilla, WinSCP or VS Code with the SFTP protocol, the VPS IP as host, the SSH port, and /public_html as the code folder.

ウェブサイト管理 > ウェブサイトの SFTP アカウント。サイトごとに専用アカウントがあり、そのサイトのフォルダーだけが見えます。FileZilla、WinSCP、VS Code などで SFTP プロトコルを選び、ホストに VPS の IP、ポートに SSH ポートを指定します。コードのフォルダーは /public_html です。

• Quản lý database: tạo (sinh mật khẩu mạnh), xóa (có sao lưu trước), đổi mật khẩu, import file .sql / .sql.gz.
• phpMyAdmin ở https://IP-VPS:CỔNG/phpmyadmin/, đăng nhập bằng user database (hoặc kumo_dba có toàn quyền).
• MariaDB chỉ nghe ở 127.0.0.1, không mở ra Internet.

• Databases: create (with a strong generated password), delete (backed up first), change password, import .sql / .sql.gz.
• phpMyAdmin is at https://VPS-IP:PORT/phpmyadmin/; log in with a database user (or kumo_dba, which has full access).
• MariaDB only listens on 127.0.0.1; it is never exposed to the Internet.

• データベース管理: 作成（強力なパスワードを自動生成）、削除（事前にバックアップ）、パスワード変更、.sql / .sql.gz のインポート。
• phpMyAdmin は https://VPS の IP:ポート/phpmyadmin/ にあります。DB ユーザー（または全権限を持つ kumo_dba）でログインします。
• MariaDB は 127.0.0.1 でのみ待ち受け、インターネットには公開されません。

• Bản sao lưu nằm ở /var/backups/kumo/NGÀY_GIỜ/: code-DOMAIN.tar.gz, db-TÊN.sql.gz, config.tar.gz.
• Sao lưu tự động: Sao lưu > Bật sao lưu tự động, chọn giờ chạy và số ngày giữ lại.
• Khôi phục code giữ lại bản hiện tại dưới tên public_html.before-restore-*. Khôi phục database sẽ sao lưu bản hiện tại trước khi ghi đè.

Đẩy lên Google Drive / S3 bằng rclone

1. Chạy rclone config và tạo một remote, ví dụ tên gdrive. Với VPS không có trình duyệt, làm theo hướng dẫn "remote setup" của rclone.
2. Vào Sao lưu > Bật sao lưu tự động, trả lời "có" ở câu hỏi rclone và nhập gdrive:kumo-backup.

• Backups are stored in /var/backups/kumo/DATE_TIME/: code-DOMAIN.tar.gz, db-NAME.sql.gz, config.tar.gz.
• Scheduled backup: Backup > Enable scheduled backup, choose the time and how many days to keep.
• Restoring code keeps the current code as public_html.before-restore-*. Restoring a database backs up the current one before overwriting it.

Upload to Google Drive / S3 with rclone

1. Run rclone config and create a remote, e.g. gdrive. On a VPS without a browser, follow rclone's "remote setup" guide.
2. Go to Backup > Enable scheduled backup, answer yes to the rclone question and enter gdrive:kumo-backup.

• バックアップは /var/backups/kumo/日付_時刻/ に保存されます: code-DOMAIN.tar.gz、db-NAME.sql.gz、config.tar.gz。
• 定期バックアップ: バックアップ > 定期バックアップを有効化 で、実行時刻と保存日数を設定します。
• コードを復元すると、現在のコードは public_html.before-restore-* として残ります。DB を復元する前には現在の DB をバックアップします。

rclone で Google Drive / S3 にアップロード

1. rclone config を実行してリモート（例: gdrive）を作成します。ブラウザのない VPS では rclone の「remote setup」手順に従ってください。
2. バックアップ > 定期バックアップを有効化 で rclone の質問に「はい」と答え、gdrive:kumo-backup と入力します。

• Cài thêm phiên bản: PHP > Cài thêm phiên bản PHP (8.1 – 8.5).
• Đổi phiên bản cho một website: PHP > Đổi phiên bản PHP cho website. Không ảnh hưởng site khác.
• Chỉnh upload_max_filesize, memory_limit, max_execution_time cho mọi phiên bản ở PHP > Thiết lập.
• Cấu hình riêng thêm vào file 99-zz-custom.ini trong thư mục conf.d / php.d của phiên bản đó.

• Install another version: PHP > Install another PHP version (8.1 – 8.5).
• Switch one website's version: PHP > Change a website's PHP version. Other sites are not affected.
• Set upload_max_filesize, memory_limit and max_execution_time for all versions in PHP > Settings.
• For other settings, create 99-zz-custom.ini in that version's conf.d / php.d folder.

• バージョンの追加: PHP > PHP バージョンを追加インストール（8.1〜8.5）。
• サイト単位の切り替え: PHP > ウェブサイトの PHP バージョンを変更。他のサイトには影響しません。
• upload_max_filesize、memory_limit、max_execution_time は PHP > 設定 で全バージョンに適用できます。
• その他の設定は、各バージョンの conf.d / php.d に 99-zz-custom.ini を作成してください。

Nếu ứng dụng của bạn tự chạy ở một cổng (vd Node.js ở cổng 3000), Kumo đặt Nginx phía trước để có domain, SSL, WebSocket và bảo mật.

1. Chạy ứng dụng, chỉ lắng nghe ở 127.0.0.1:3000 (dùng pm2, systemd hoặc Docker với -p 127.0.0.1:3000:3000).
2. kumo > Quản lý website > Thêm site ứng dụng, nhập domain và địa chỉ http://127.0.0.1:3000.
3. Cài SSL như site thường.

If your app listens on its own port (e.g. Node.js on port 3000), Kumo puts Nginx in front of it for the domain, SSL, WebSocket and security.

1. Run your app listening only on 127.0.0.1:3000 (pm2, systemd, or Docker with -p 127.0.0.1:3000:3000).
2. kumo > Websites > Add app site, enter the domain and http://127.0.0.1:3000.
3. Issue SSL as for any site.

アプリが独自のポートで動いている場合（例: ポート 3000 の Node.js）、Kumo が前段に Nginx を置き、ドメイン、SSL、WebSocket、セキュリティを提供します。

1. アプリを 127.0.0.1:3000 だけで待ち受けるように起動します（pm2、systemd、または Docker の -p 127.0.0.1:3000:3000）。
2. kumo > ウェブサイト管理 > アプリサイトを追加 で、ドメインと http://127.0.0.1:3000 を入力します。
3. 通常のサイトと同じように SSL を発行します。

Quản lý website > Bộ nhớ đệm trang. Nginx giữ bản sao mỗi trang trong 10 phút, nên website tải nhanh hơn nhiều và chịu được lượng truy cập lớn.

• Không cache: request POST, URL có tham số, trang quản trị và đăng nhập, giỏ hàng/thanh toán, người đã đăng nhập hoặc vừa bình luận.
• Sau khi sửa nội dung, xóa cache bằng kumo cache purge example.com. Nếu không xóa, trang mới sẽ hiện sau tối đa 10 phút.
• Kiểm tra cache hoạt động: curl -I https://example.com rồi xem header X-Kumo-Cache: HIT.

Websites > Page cache. Nginx keeps a copy of each page for 10 minutes, so the site loads much faster and handles traffic spikes.

• Never cached: POST requests, URLs with query strings, admin and login pages, cart/checkout, and logged-in or commenting users.
• After editing content, clear it with kumo cache purge example.com; otherwise changes appear within 10 minutes.
• Check it works: curl -I https://example.com and look for X-Kumo-Cache: HIT.

ウェブサイト管理 > ページキャッシュ。Nginx が各ページのコピーを 10 分間保持するため、表示が大幅に速くなり、アクセス集中にも強くなります。

• キャッシュしないもの: POST リクエスト、クエリ付き URL、管理・ログインページ、カート/決済、ログイン中またはコメントしたユーザー。
• 内容を更新したら kumo cache purge example.com で削除します。削除しない場合も 10 分以内に反映されます。
• 動作確認: curl -I https://example.com を実行し、X-Kumo-Cache: HIT ヘッダーを確認します。

Quản lý website > Đặt mật khẩu bảo vệ. Khách phải nhập tên và mật khẩu mới xem được site, phù hợp cho site đang phát triển hoặc nội bộ. Gia hạn SSL vẫn hoạt động bình thường.

Websites > Password-protect a website. Visitors must enter a user name and password, which is handy for staging or private sites. SSL renewal keeps working.

ウェブサイト管理 > パスワードで保護。訪問者はユーザー名とパスワードの入力が必要になり、開発中や非公開のサイトに便利です。SSL の更新はそのまま動作します。

Chạy kumo doctor bất cứ lúc nào, hoặc chọn mục cuối của menu chính. Kumo kiểm tra dịch vụ, cấu hình Nginx/PHP/SSH, ổ đĩa, RAM, tải CPU, hạn SSL, DNS của từng domain, sao lưu, cổng SSH cũ và việc cần khởi động lại. Mỗi lỗi kèm gợi ý cách sửa.

Run kumo doctor at any time, or pick the last item of the main menu. It checks services, Nginx/PHP/SSH configs, disk, RAM, CPU load, SSL expiry, DNS of every domain, backups, the old SSH port and pending reboots. Every problem comes with a hint on how to fix it.

kumo doctor をいつでも実行するか、メインメニューの最後の項目を選びます。サービス、Nginx/PHP/SSH の設定、ディスク、メモリ、CPU 負荷、SSL の期限、各ドメインの DNS、バックアップ、旧 SSH ポート、再起動の要否を確認し、問題ごとに対処法を示します。

1. Trong Telegram, mở @BotFather, gửi /newbot, đặt tên và chép bot token.
2. Gửi một tin bất kỳ cho bot vừa tạo. Mở @userinfobot để lấy chat ID của bạn.
3. kumo > Bảo mật > Cảnh báo qua Telegram, nhập token và chat ID. Kumo gửi tin nhắn thử ngay.

Kumo kiểm tra mỗi 15 phút. Cùng một sự cố chỉ được nhắc lại sau 6 giờ, và khi mọi thứ ổn trở lại bạn nhận một tin báo. Sao lưu lỗi được báo ngay lập tức.

1. In Telegram, open @BotFather, send /newbot, choose a name and copy the bot token.
2. Send any message to your new bot. Open @userinfobot to get your chat ID.
3. kumo > Security > Telegram alerts, enter the token and chat ID. Kumo sends a test message right away.

Kumo checks every 15 minutes. The same problem is repeated at most every 6 hours, and you get one message when everything is fine again. Failed backups are reported immediately.

1. Telegram で @BotFather を開き、/newbot を送って名前を決め、ボットトークンをコピーします。
2. 作成したボットに何かメッセージを送ります。@userinfobot で自分のチャット ID を確認します。
3. kumo > セキュリティ > Telegram 通知 でトークンとチャット ID を入力すると、すぐにテストメッセージが届きます。

15 分ごとに確認します。同じ問題の再通知は最短 6 時間おきで、問題が解決すると 1 回お知らせします。バックアップの失敗はすぐに通知されます。

• Firewall: UFW (Ubuntu/Debian) hoặc firewalld (Alma/Rocky); chỉ mở SSH, 80, 443 và cổng quản trị. Mở/đóng cổng, chặn IP ở Bảo mật > Firewall.
• Fail2ban: chặn dò mật khẩu SSH, trang quản trị, bot quét lỗ hổng, IP gửi quá nhiều request. IP tái phạm bị chặn 1 tuần.
• Đăng nhập bằng SSH key: thêm key vào /root/.ssh/authorized_keys, rồi bật Bảo mật > Root chỉ đăng nhập bằng SSH key.
• Cập nhật bảo mật tự động được bật sẵn (unattended-upgrades / dnf-automatic).
• AIDE (tùy chọn) kiểm tra file hệ thống bị sửa đổi lúc 3 giờ sáng mỗi ngày.

• Firewall: UFW (Ubuntu/Debian) or firewalld (Alma/Rocky); only SSH, 80, 443 and the admin port are open. Manage ports and block IPs in Security > Firewall.
• Fail2ban: blocks SSH and admin panel brute force, vulnerability scanners and request floods. Repeat offenders are banned for a week.
• SSH key login: add your key to /root/.ssh/authorized_keys, then enable Security > Root login with SSH key only.
• Automatic security updates are enabled (unattended-upgrades / dnf-automatic).
• AIDE (optional) checks for modified system files every day at 3 AM.

• ファイアウォール: UFW（Ubuntu/Debian）または firewalld（Alma/Rocky）。開放するのは SSH、80、443、管理ポートのみです。ポートの開閉や IP のブロックは セキュリティ > ファイアウォール で行います。
• Fail2ban: SSH と管理画面へのブルートフォース、脆弱性スキャン、大量リクエストをブロックします。繰り返す IP は 1 週間 BAN されます。
• SSH 鍵ログイン: /root/.ssh/authorized_keys に鍵を追加してから、セキュリティ > root を SSH 鍵ログインのみにする を有効にします。
• 自動セキュリティ更新は有効になっています（unattended-upgrades / dnf-automatic）。
• AIDE（任意）が毎日午前 3 時にシステムファイルの改ざんをチェックします。

Đổi trong menu Hệ thống > Ngôn ngữ, hoặc chạy một lần với KUMO_LANG=en kumo. Trang quản trị và phpMyAdmin dùng cùng ngôn ngữ.

Change it in System > Language, or for a single run with KUMO_LANG=ja kumo. The admin panel and phpMyAdmin follow the same language.

システム > 言語 で変更するか、KUMO_LANG=vi kumo のように 1 回だけ指定できます。管理画面と phpMyAdmin も同じ言語になります。

• Kumo: Cập nhật / nâng cấp > Cập nhật Kumo. Kumo đọc https://kumovps.xyz/latest.txt, tải bản mới, kiểm tra SHA256 rồi sinh lại cấu hình. Dữ liệu website không bị động tới.
• Phần mềm: cùng menu có cập nhật OS, Nginx, PHP, MariaDB (bản vá hoặc lên phiên bản chính, có sao lưu trước), phpMyAdmin, WP-CLI.

• Kumo: Updates > Update Kumo. Kumo reads https://kumovps.xyz/latest.txt, downloads the new release, verifies its SHA256 and regenerates the configuration. Website data is not touched.
• Software: the same menu updates the OS, Nginx, PHP, MariaDB (patch or major upgrade, with a backup first), phpMyAdmin and WP-CLI.

• Kumo 本体: 更新 / アップグレード > Kumo を更新。https://kumovps.xyz/latest.txt を確認して新しいリリースをダウンロードし、SHA256 を検証してから設定を再生成します。ウェブサイトのデータには触れません。
• ソフトウェア: 同じメニューから OS、Nginx、PHP、MariaDB（パッチ版、または事前バックアップ付きのメジャーアップグレード）、phpMyAdmin、WP-CLI を更新できます。

Mọi việc thường làm đều có lệnh ngắn. Nhấn Tab để tự hoàn thành lệnh và tên domain.

Every common task has a short command. Press Tab to complete commands and domain names.

よく使う操作には短いコマンドがあります。Tab キーでコマンドとドメイン名を補完できます。

Cài đặt bị dừng giữa chừng

Xem /var/log/kumo/install.log. Cách chắc chắn nhất là cài lại OS cho VPS rồi chạy lại.

Không vào được trang quản trị

Kiểm tra cloud firewall của nhà cung cấp đã mở cổng chưa. Truy cập bằng https://IP:CỔNG, không qua domain đang bật proxy Cloudflare (Cloudflare chặn cổng lạ).

Không cấp được SSL

Kiểm tra bản ghi A đã trỏ đúng IP (dig +short example.com) và cổng 80 mở. Let's Encrypt giới hạn số lần thử, hãy đợi một lúc nếu thử sai nhiều lần.

Bị khóa ngoài SSH

Dùng console (VNC) trên trang của nhà cung cấp VPS, đăng nhập root, rồi chạy kumo > Bảo mật để sửa cổng hoặc bỏ chặn IP (fail2ban-client unban IP).

Website lỗi 502

PHP-FPM của site không chạy. Xem Hệ thống > Trạng thái server, và log /var/log/kumo/php/DOMAIN.error.log.

Installation stopped halfway

Check /var/log/kumo/install.log. The safest fix is to reinstall the VPS OS and run the installer again.

Cannot open the admin panel

Make sure your provider's cloud firewall allows the port. Use https://IP:PORT, not a domain behind the Cloudflare proxy (Cloudflare blocks unusual ports).

SSL issuance fails

Check that the A record points to the right IP (dig +short example.com) and port 80 is open. Let's Encrypt rate-limits failed attempts; wait a while after several failures.

Locked out of SSH

Use the VNC console in your provider's dashboard, log in as root, then run kumo > Security to fix the port or unban your IP (fail2ban-client unban IP).

Website shows 502

The site's PHP-FPM is not running. Check System > Server status and /var/log/kumo/php/DOMAIN.error.log.

インストールが途中で止まった

/var/log/kumo/install.log を確認してください。最も確実なのは VPS の OS を再インストールしてやり直すことです。

管理画面が開けない

プロバイダーのクラウドファイアウォールでポートが開いているか確認してください。Cloudflare のプロキシ経由のドメインではなく https://IP:ポート でアクセスします（Cloudflare は標準以外のポートを通しません）。

SSL を発行できない

A レコードが正しい IP を指しているか（dig +short example.com）、ポート 80 が開いているか確認してください。Let's Encrypt は失敗回数に制限があるため、何度も失敗した場合はしばらく待ってください。

SSH から締め出された

プロバイダーのダッシュボードの VNC コンソールで root ログインし、kumo > セキュリティ でポートを修正するか、IP の BAN を解除します（fail2ban-client unban IP）。

サイトが 502 エラーになる

そのサイトの PHP-FPM が動いていません。システム > サーバー状態 と /var/log/kumo/php/DOMAIN.error.log を確認してください。