ドキュメント

インストール、使用、削除。

RainServer 1.0 の運用に必要な情報をまとめています。プログラム自体が操作中に案内するため、簡潔にしています。

インストール

ダッシュボードにサインインし、「サーバーを追加」をクリックして、表示されたコマンドをサーバー上で実行してください。コマンド内のトークンは1回のみ有効で、24時間後に失効します。

sudo 権限を持つユーザーで実行してください
curl -fsSL https://raincleaner.eu/rainserver/install.sh | sudo sh -s -- --token YOUR_TOKEN

--dry-run を付けると、何も変更せずに実行内容を確認できます。インストーラーは次の処理を行います:

  • システムを確認します: Linux、systemd、x86_64 または ARM64
  • HTTPS で 1 つのバイナリをダウンロードし、Ed25519 署名と SHA-256 を検証します
  • /usr/local/bin/rainserver と rainserver-agent サービスをインストールします
  • サーバーをお使いのアカウントに紐付け、エージェントを起動します

対応環境: Ubuntu 20.04 以降、Debian 11 以降、Rocky Linux、AlmaLinux、RHEL 8 以降。ご自身で確認する場合の公開鍵: rainserver-signing.pub

はじめに

  1. 1sudo rainserver を実行すると、ターミナルダッシュボードが開きます。
  2. 2sudo rainserver fix は対応できる項目の一覧を表示します。sudo rainserver fix ID は指定した項目を説明し、適用前に確認を求めます。
  3. 3sudo rainserver clean は削除できる項目と、そのリスクの度合いを一覧表示します。
  4. 4Web ダッシュボードを開く: すべてのサーバー、アラート、履歴、自動化、課金を確認できます。

コマンド

rainserverターミナルダッシュボード
rainserver status1画面のサマリー
rainserver scan [--json]フルスキャン:メトリクス、検出結果、クリーンアップ候補
rainserver fix [ID] [--yes]修正方法のある検出結果を一覧表示、または説明して適用します
rainserver clean [--safe] [--item ID] [--yes] [--confirm ID]クリーンアップ項目を一覧表示または削除します。DANGER は項目 ID を指定した --confirm が必要です
rainserver security | services | docker | backups | netスキャンの1セクション
rainserver history [N]直近 N 件の記録済みアクション
rainserver backup add NAME PATH HOURSバックアップ先を監視(ディレクトリまたは glob)
rainserver critical add UNITこのユニットは、人の操作なしでは再起動しないでください
rainserver mute ID / unmute ID検出結果を非表示にする/表示する
rainserver link TOKEN / unlinkアカウントに接続/切断します
rainserver update [--check]署名済みの最新リリースをインストールします
rainserver uninstallRainServer を完全に削除します

キーボード

ターミナルアプリはキーボード操作が中心です。フッターには、現在の画面で使えるキーが常に表示されます。

Tab / ← →セクションを切り替え
↑ ↓移動
1ダッシュボード
FFix My Server
Cクリーンアップ
Uセキュリティ
Vサービス
DDocker
Nネットワーク
Bバックアップ
Lログ
Sフルスキャン
Spaceクリーンアップ項目を選択
Enter選択した修正またはクリーンアップを実行(事前に確認します)
Hヘルプ
Q終了

リスクレベル

すべての検出結果とアクションには、これらのいずれかが設定されています。このレベルによって、RainServer が何かを実行する前にどれだけ確認を求めるかが決まります。

SAFEグループ全体で確認は1回だけです。項目一覧はキー1つで開けます。
REVIEWカテゴリを開き、そのカテゴリごとに確認します。
DANGER自動では実行されません。影響を表示し、重大なものは名前の入力が必要です。
MANUAL ONLYRainServer は実行しません。検出内容を説明し、判断はお任せします。

バックアップ

RainServer はバックアップを作成しません。バックアップの保存先を指定し、最新のファイルが何時間前まで許容されるかを設定してください:

最新のファイルが 26 時間より古い場合にアラートを送信する
sudo rainserver backup add db-nightly /var/backups/db 26

自動化

ダッシュボードの「自動化」で、承認レベル、メンテナンスウィンドウ、ご利用のプランで使えるジョブを設定します。REVIEW、DANGER、MANUAL の項目が自動で実行されることはありません。ユニットを自動再起動から保護するには、次のように設定します:

人の操作なしでは再起動されません
sudo rainserver critical add mysql

アラート

通知チャネルは「設定」で指定します: オーナーと管理者向けのメール、Telegram (当社のボットでワンクリック)、WhatsApp (CallMeBot 経由で無料、ご自身のキーを使用)、Discord の Webhook、またはご自身の HTTPS Webhook (JSON) が使えます。アラートは、同じ問題が 2 回連続のレポートで検出されると作成されます。レポートが 5 分間届かないサーバーはオフラインと見なされます。日次レポートは、指定した時刻にすべてのチャネルへ送信されます。

API

Business プランと Agency プランでは、「設定」でトークンを作成できます。トークンは Bearer トークンとして送信してください。上限: 1 時間あたり 600 リクエスト。

GET /api/v1/serversすべてのサーバーの状態、CPU、ディスク、検出結果
GET /api/v1/servers/ID1台のサーバーと、その最新スナップショット全体
GET /api/v1/alerts未解決のアラート
POST /api/v1/servers/ID/actionsアクションをキューに追加(Agency、書き込みトークン):scan、service.restart、docker.restart、updates.security
例
curl -H "Authorization: Bearer rsk_..." https://raincleaner.eu/rainserver/app/api/v1/servers

ファイルとデータ

/usr/local/bin/rainserverプログラム(静的バイナリ1つ)
/etc/systemd/system/rainserver-agent.serviceバックグラウンドエージェント
/etc/rainserver/config.json設定:バックアップ、重要なユニット、ミュートした検出結果、アカウントとのリンク
/var/lib/rainserver/history.jsonlローカルのアクション履歴(追記専用)

更新とアンインストール

署名付きリリースマニフェストを確認し、チェックサムを検証して、バイナリを置き換え、エージェントを再起動します
sudo rainserver update
エージェントを停止し、バイナリ、サービス、設定、履歴を削除します
sudo rainserver uninstall

今日から実行できるチェック

RainServer は魔法ではありません。チェックの多くは、すでにご存じのコマンドから始まります。コマンドを実行し、出力をまとめて読み取り、結果を説明します。ここではその一部をご紹介します。これらは読み取り専用で、何も変更しません。

ディスクと inode の使用状況
df -h / /var && df -i /
systemd ジャーナルが使用する容量
journalctl --disk-usage
イメージ、コンテナ、ボリューム、ビルドキャッシュの使用容量
docker system df
現在失敗しているユニット
systemctl --failed
どのポートで何が待ち受けているか、またどのプロセスが所有しているか
ss -tulpn
実際に有効な SSH 設定
sshd -T | grep -Ei '^(permitrootlogin|passwordauthentication)'
はじめに

2分でサーバー上で動かせます。

  1. アカウントを作成メールアドレスでサインインしてください。サーバー1台の7日間トライアルがすぐに始まります。カードは不要です。
  2. サーバーを追加ダッシュボードからインストールコマンドをコピーし、sudo で実行します。インストールされる内容が表示され、ダウンロードの署名も確認されます。
  3. 開くターミナルダッシュボードは sudo rainserver で、Web ダッシュボードはブラウザーから開けます。
無料トライアルを開始
ダッシュボードに表示されるコマンド
curl -fsSL https://raincleaner.eu/rainserver/install.sh | sudo sh -s -- --token YOUR_TOKEN

先に内容を確認しますか? install.sh · インストールドキュメント

  • Ubuntu、Debian、Rocky、AlmaLinux、RHEL
  • x86_64 と ARM64
  • 1つのコマンドで完全に削除できます