コンテンツへスキップ
VORQUL
ドキュメント / VorqulPanel / インストールと管理

LinuxサーバーへのVorqulPanelのインストール

かかる時間のほとんどは、パネル自体ではなく、パッケージのインストールとDNSの反映待ちです。以下の順序で進めると、自分が締め出されるのを避けられます。

VorqulPanelのインストールにかかる時間は、クリーンなLinuxサーバーでおよそ15〜30分です。Debian 12、Ubuntu 22.04以降、またはAlmaLinux 9で、root権限と2 GB以上のRAMが必要です。パネルは単一のJARとscripts/install.shで提供され、このスクリプトがJava 25(なければ)をインストールし、サービスユーザーを作成して、vorqul-panelのsystemdユニットを登録し、ポート8765〜8767を開放します。ビルド手順、コンテナランタイム、外部データベースは不要です。パネルは標準で、自分の状態をSQLiteに保存します。

所要時間
15〜30分
ランタイム
Java 25以降(自動でインストールされます)
対応ディストリビューション
Debian 12、Ubuntu 22.04以降、AlmaLinux 9
パネルのストレージ
SQLite。外部DBは不要です

必要条件

インストール前の最小要件
RAM 最小2 GB
アクセス クリーンなサーバーのroot
Java 25以降。インストーラーが追加します
ポート SSH、8765〜8767、80、443
DNS 証明書用に、サーバーを指すAレコード
コンテナランタイム 不要です
Requirements for VorqulPanelのインストール: RAM 最小2 GB, アクセス クリーンなサーバーのroot, Java 25以降。インストーラーが追加します, ポート SSH、8765〜8767、80、443, DNS 証明書用に、サーバーを指すAレコード, コンテナランタイム 不要です.

インストール

クリーンなサーバーは、推奨というより実際に必要な条件です。パネルはnginx、Apache、BIND9、Postfix、Dovecot、MariaDB、nftablesを管理するため、それらをパネル自身がインストールしたマシンのほうがはるかに扱いやすくなります。

  1. Step 01

    新しく用意したDebian 12、Ubuntu 22.04以降、またはAlmaLinux 9で、SSHからrootで接続できる状態にします。

    他の人が構築したWebスタックがすでに動いているサーバーにインストールすることも可能です。インストーラーは、すでにあるWebサーバー、PHP-FPM、MariaDB、certbot、BIND、Postfix、fail2banの再インストールを提案せず、パネルは、引き継ぎを確認するまで既存のvhostを書き換えずに読み取るだけです。それでも、最初に行うインストールには向いていません。

  2. Step 02

    パネルは単一のJARで、Java 25以降が必要です。インストーラーは、なければインストールするため、事前に確認したい場合以外はここでやることはありません。

    bash
    java -version
  3. Step 03

    SSHデーモンがどのポートで待ち受けているかを把握し、確実に再接続できるようにしてください。ファイアウォールは後で設定しますが、そのポートには明示的なルールが必要です。

    標準以外のSSHポートに、デフォルトのファイアウォールルールセットを組み合わせると、新しいパネルのインストール直後に自分が締め出される典型的なパターンになります。

インストール

スクリプト1つでインストールがすべて完了します。コンパイルは不要です。

  1. Step 04

    リリースは、JAR、scriptsディレクトリ、systemdユニットのテンプレートが入った1つのフォルダです。/root/vorqul-panelなど、恒久的な場所に置いてください。

    インストール後もフォルダは残しておいてください。vorqulctl fix-libsや今後のアップデートで使います。lib/内のライブラリは、インストーラーがMaven Centralからチェックサムを検証してダウンロードするため、コピーする必要はありません。

    VorqulPanelはアルファ版で、まだメールでテスト用に配布していません。ビルドが共有された場合は、そのバージョン用の正確なコマンドがアーカイブに付属しています。ここに書いた手順は、それらのコマンドが何をするかを説明したものです。

    • vorqul-panel.jarはパネル本体です
    • scripts/install.shはインストーラーで、必須です
    • scripts/vorqul-helperは、ファイアウォールのポート、リソース制限、サービスを扱うroot用ヘルパーです
    • scripts/vorqulctlはコマンドラインツールです
    • scripts/vorqul-doctor.shは任意の診断スクリプトです
    • systemd/にはサービスのテンプレートが入っています。インストーラーが独自のコピーを持っているため、任意です
  2. Step 05

    どの部分が必要かを尋ね、足りないものをインストールし、サービスユーザーを作成して、一度だけ使えるセットアップURLを表示します。

    • 有効にするモジュールを尋ねます:ゲームホスティング、Webホスティング、メール
    • インストールするパッケージを尋ねます:nginxまたはApache、PHP-FPM、MariaDB、certbot、BIND、DovecotつきのPostfix、Rspamd、ゲーム用ツール、fail2ban
    • Javaがなければインストールし、vorqulシステムユーザーを作成します
    • JARを/opt/vorqul-panelにコピーし、ランダムなシークレット入りの設定を書き出して、systemdサービスを設定します
    • ufwまたはfirewalldでポートを開放し、セットアップURLを表示します
    bash
    sudo bash scripts/install.sh

    インストーラーは、target/、リポジトリのルートの隣、またはスクリプトの隣にあるJARを探すため、展開したフォルダから実行してください。

  3. Step 06

    すべての質問には、対応する環境変数があります。YES=1を指定すると何も尋ねられず、変数か初期値が使われます。

    • INSTAL_DIR(初期値は/opt/vorqul-panel)、DATA_DIR、LOG_DIRで、JAR、データ、ログの置き場所を指定します
    • SYSTEM_USER(初期値はvorqul)は、パネルを実行するユーザーです
    • PORT、SFTP_PORT、SFTP_DAEMON_PORTの初期値は、それぞれ8765、8766、8767です
    • MOD_GAMES、MOD_WEB、MOD_MAILの初期値は1で、パネルの3つの機能を切り替えます
    • WEB_SERVERはnginx、apache、noneのいずれかで、MOD_WEB=1のときだけ有効です
    • INSTALL_PHP、INSTALL_MARIADB、INSTALL_CERTBOT、INSTALL_BIND、INSTALL_MAIL、INSTALL_RSPAMD、INSTALL_FAIL2BAN、INSTALL_GAMETOOLSで、パッケージを選びます
    • DB_ENGINEの初期値はsqliteで、mysql、postgres、mssqlも選べます。接続にはDB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASSを使います
    • WEB_ADMIN=1はrootヘルパーと限定的なsudoersファイルをインストールします。USE_EXISTING=0にすると、すでにインストールされているソフトウェアにもインストーラーが手を加えます
    bash
    sudo YES=1 MOD_MAIL=0 WEB_SERVER=nginx INSTALL_PHP=1 INSTALL_MARIADB=1 INSTALL_CERTBOT=1 bash scripts/install.sh

    SQL Serverのサポートはベータ版です。SQLite、MySQL、MariaDB、PostgreSQLは、実際のサーバーで確認済みです。後からdb.engineを変更しても、データは移動しません。

  4. Step 07

    パネルは、vorqul-panelという名前の堅牢化されたsystemdサービスとして動作します。起動したかどうかを確認し、起動していなければジャーナルを読んでください。

    bash
    sudo systemctl status vorqul-panel
    sudo vorqulctl status
    sudo vorqulctl logs err

    セットアップ中にパッケージのインストールが失敗する場合、よくある原因は、ユニット内のRestrictSUIDSGID=yesがインストール後のスクリプトを妨げていることです。

  5. Step 08

    インストーラーは、ufwまたはfirewalldで8765、8766、8767を開放します。素のnftablesの場合は、先に確認してから、再起動すると消える1つのルールを挿入します。

    素のnftablesの場合は、/etc/nftables.confにtcp dport { 8765, 8766, 8767 } acceptも追加してください。リバースプロキシの背後では、公開する必要があるのは80と443だけで、8765はインターネットに対して閉じたままにしてください。

    • パネルは8765、組み込みSFTPは8766、SFTPデーモンは8767で、すべてtcpです
    • Webサイトは80と443、メールは25、587、465、143、993、4190、DNSはtcpとudpの53です
    • 各ゲームサーバーは、作成時に自分のポートを開放します。HytaleはUDP 5520を使います

インストール

ここからはすべてブラウザで操作します。

  1. Step 09

    http://your-server:8765/ にアクセスします。管理者が作成されるまではセットアップフォームが表示されます。完全なリンクはインストーラーか、下のコマンドで確認できます。

    bash
    sudo vorqulctl setup-url

    先にポートへアクセスした人が管理者を作成できます。この猶予はパネルの起動から1時間で終わり、その後はセットアップリンクが必要です。

  2. Step 10

    最初のアカウントはすぐに作成し、設定のアカウントで二要素認証を有効にしてください。管理者には二要素認証を必須にできます。

    管理者アカウントを失った場合は、sudo vorqulctl reset-admin を実行し、続けて sudo vorqulctl start を実行します。新しいセットアップリンクが表示されるので、そこで新しい管理者を作成します。

  3. Step 11

    有効なキーが確認されるまで、パネルはロックされたままで、ライセンスページに移動します。/license を開き、キーと発行時のドメインを入力して、有効化を押します。

    Webページにアクセスできない場合は、同じ2つの値を /opt/vorqul-panel/vorqul-panel.conf に license.key と license.domain として書き込み、サービスを再起動してください。ライセンスサーバーに接続するため、サーバーから外向きのHTTPSが必要です。

    license.domain は、キーの発行時に指定したドメインにしてください。手で作成するライセンスファイルはありません。data/license.json は、サーバーが署名した応答をキャッシュしているだけです。

  4. Step 12

    設定には、ゲームホスティング、Webホスティング、メールのタブがあります。このマシンで使わないものはオフにしてください。スイッチをオフにすると、そのページが非表示になり、APIも404を返すようになります。

    スイッチをオフにしても、何かがアンインストールされたりデータが削除されたりすることはありません。サービスの手動セットアップでは、インストール済みのものと不足しているものが一覧で表示され、項目ごとにインストールボタンがあります。

  5. Step 13

    まずサーバーにAレコードを向けます。次にパネルでドメインを追加し、適用を押してvhostを書き込みます。DNSがここに解決されたら、HTTPSを押します。

    証明書はacme.shまたはcertbotから発行されます。どちらも、発行前にDNSレコードが解決される必要があります。レコードを変更したばかりの場合は、繰り返し再試行せず、伝播を待ってください。

    証明書は発行されたのにサイトがHTTPのままの場合、多くは取り込んだvhostの引き継ぎがまだ確認されていないことが原因です。

  6. Step 14

    適用のたびに、自動ロールバック付きでWebサーバーの設定テストが実行されます。合格した結果がどう見えるかを知るために、一度は手動で実行してみてください。

    このロールバックがあるので、不正なvhostでサーバー全体が止まることはありません。パネルは再読み込みの前に新しい設定をテストし、失敗した場合は古い設定に戻します。

コマンド

サーバー上で入力するものはすべてここにあります。vorqulctl は root で、または sudo を付けて実行してください。

  1. Step 15

    パネルは vorqul-panel サービス、単体のSFTPデーモンは vorqul-sftp です。

    bash
    sudo systemctl status vorqul-panel
    sudo systemctl restart vorqul-panel
    sudo systemctl stop vorqul-panel
    sudo systemctl enable vorqul-panel
    sudo journalctl -u vorqul-panel -n 100 --no-pager
  2. Step 16

    最もよく使う短いコマンドです。

    • vorqulctl status はサービスの状態、ポート、バージョンを表示します
    • vorqulctl start、stop、restart はサービスを制御します
    • vorqulctl enable と disable は、起動時に自動で開始するかどうかを決めます
    • vorqulctl logs [tail|follow|err|all] はパネルのログを読みます。デフォルトでは最後の100行です
    • vorqulctl info はパス、ポート、データディレクトリを表示します
    • vorqulctl version はパネルのバージョンを表示します
  3. Step 17

    初回ログイン、管理者の紛失、設定の簡易コピーに使います。

    • vorqulctl setup-url は初回セットアップのリンクをもう一度表示します
    • vorqulctl reset-admin は新しい管理者アカウント用のセットアップURLを作成し、パスワードでのサインインを再び有効にします
    • vorqulctl config は設定ファイルをエディタで開きます
    • vorqulctl backup は設定とデータディレクトリのtar.gzを /tmp に書き出します
  4. Step 18

    モジュール、ランタイム、ライブラリ、更新、削除を扱います。

    • vorqulctl modules [games|web|mail on|off] はモジュールの状態を表示するか、ホスト権限と一緒に切り替えます
    • vorqulctl deps <runtime> は node20、java25、steamcmd などのランタイムをインストールします
    • vorqulctl fix-libs は lib/ のライブラリをダウンロードし直します
    • vorqulctl fix-priv はsudoersファイル、rootヘルパー、systemdのオーバーライドを再インストールします
    • vorqulctl update <jar> は、バックアップ、アトミックな入れ替え、再起動、ヘルスチェック、自動ロールバック付きで新しいJARをインストールします
    • vorqulctl uninstall [--purge-data] はパネルを削除します。データは purge を付けない限り残ります
    bash
    sudo vorqulctl modules mail on
    sudo vorqulctl update /path/to/vorqul-panel.jar
  5. Step 19

    パネルは権限のないユーザーとして動作します。rootが必要な処理はすべて vorqul-helper を通ります。これは決められた一覧の操作だけを受け付け、それ以外は受け付けません。

    ヘルパーは /etc/vorqul-helper.conf を読み込みます。このファイルはrootが所有し、インストーラーが書き込みます。内容は選択したモジュールだけに絞られているため、設定でモジュールをオンにしただけでは、パネルにその権限は与えられません。パネルにはコマンド付きのバナーが表示され、sudo vorqulctl modules <name> on がそのコマンドです。

    どのモジュールでも、パネルはSSH、nftables、ufw、firewalld、cronを停止せず、ファイアウォールのフラッシュやデフォルトポリシーの変更もしません。追加と削除を行うのはタグ付きの自分のルールだけで、fail2banで自分から何かをBANすることもありません。

  6. Step 20

    サーバーが起動せずログも空のときは、doctorを実行してください。何も通信せず、何も変更せず、各ゲームサーバーのコマンドを手動で実行して、本当のエラーを表示します。

    /healthz は、バージョン、稼働時間、データベースの状態、実行中のサーバー数をJSONで返します。独自の監視対象にするのに向いています。

    bash
    ./scripts/vorqul-doctor.sh /opt/vorqul-panel
    curl -s http://127.0.0.1:8765/healthz

リファレンス

デフォルトのインストール後に各ファイルがある場所です。

  1. Step 21

    INSTAL_DIR や DATA_DIR を変更していなければ、パネルが所有するものはすべて /opt/vorqul-panel の下にあります。

    • /opt/vorqul-panel には、JAR、lib/、vorqul-panel.conf があります
    • /opt/vorqul-panel/data には、データベース、ゲームサーバー、バックアップがあります
    • /opt/vorqul-panel/logs には vorqul-panel.log があります
    • /etc/systemd/system/vorqul-panel.service と vorqul-sftp.service がユニットです
    • /usr/local/bin/vorqulctl はコマンドラインツールです
    • /usr/local/sbin/vorqul-helper と /etc/vorqul-helper.conf は、rootヘルパーとそのポリシーです
    • /etc/sudoers.d/vorqul-panel は、権限を絞ったsudoersファイルです
  2. Step 22

    最初の3つはパネル用です。残りは、使う機能によって変わります。

    • 8765 tcp はWebインターフェースとAPIです
    • 8766 tcp は組み込みSFTP、8767 tcp は単体のSFTPデーモンです
    • 80と443 tcp はWebサイトと証明書用です
    • 25、587、465、143、993、4190 tcp はメール用です
    • 53 tcp と udp はDNS用です
    • ゲームサーバーごとに専用のポートを使います

リファレンス

ファイルは /opt/vorqul-panel/vorqul-panel.conf で、1行に1つの key = value を書きます。ほとんどの項目は設定画面のスイッチでも変更できるので、手で編集することはあまりありません。変更後はサービスを再起動してください。

  1. Step 23

    パネルの待ち受け方法とデータの保存先を決めるキーです。

    • server.host と server.port は、待ち受けアドレスとポートを設定します
    • server.public.url は、人がアクセスするアドレスです。GoogleやDiscordでのサインインに必要です
    • server.tls.keystore は、直接HTTPSを使うためのPKCS12キーストアを指定します
    • data.dir はデータディレクトリです
    • db.engine は sqlite、mysql、postgres、mssql のいずれかで、使用するものに対して db.<engine>.host、port、database、user、password のブロックを書きます
    • security.secret はセッションに署名するもので、インストーラーが生成します。安易に変更しないでください
    • panel.trust.proxies は、転送ヘッダーの設定を許可する唯一のピアを列挙します
    • cloudflare.mode を使うと、パネルはCloudflareの範囲からの CF-Connecting-IP だけを信頼します
  2. Step 24

    feature.games、feature.webhosting、feature.mail がマスタースイッチです。それぞれに子スイッチがあり、子は親がオンのときだけ有効になります。

    • Web:feature.domains、ssl、dns、databases、cache、webconfigs、webfiles、subdomains、websftp、webapps、webstats
    • メール:feature.mail.dkim、antispam、tls、rules、catchall、autoconfig、delivery、webmail、dnsrecipe
    • Webサイトのツール:webcron、webbackup、webgit、webruntime
    • terminal.enabled はブラウザターミナルを有効にします。デフォルトではオフで、2FAを使う管理者だけが使えます
  3. Step 25

    パネルが実行中のサーバーをどう扱うかです。

    • servers.keepRunning、servers.nice、servers.oomAdjust は、サーバーの存続のしやすさとスケジューリングを調整します
    • limits.cgroups はcgroup v2の制限を有効にします。limits.memory.headroomPercent のデフォルトは125で、limits.pids.max はデフォルトでオフです
    • limits.servers.maxRunning は、同時に動かせるサーバー数の上限です
    • process.stop.timeout は、停止時にサーバーが保存に使える秒数です。デフォルトは30で、最大は150です
  4. Step 26

    パネル、オフサイトコピー、Webサイトのバックアップのスケジュールと保持期間です。

    • backup.panel.cron と backup.panel.retention は、パネルのバックアップのスケジュールと保持数を決めます
    • backup.offsite.* は、暗号化したコピーの送信先を指定します
    • web.backup.keep は、保持するWebサイトのバックアップ数です。デフォルトは7です
    • log.level は、パネルがログに書き込む量を決めます

    変更が反映されないように見えるときは、doctorを実行するか、vorqulctl logs err を確認してください。原因はたいていファイル内の入力ミスです。

機能

画面の簡単な案内です。どこを見ればよいか分かります。

  1. Step 27

    メニューは管理する対象ごとにグループ分けされています。Webホスティング、メール、ゲームホスティングの各グループは、設定でそれぞれオフにできます。

    • 概要はシステム統計を表示するダッシュボードです
    • Webホスティング:Webサイト概要、ドメインとサイト、DNSゾーン、データベース、キャッシュ、SSL証明書、Webサーバー設定
    • メール:メールとメール配信
    • ゲームホスティング:ゲーム概要、ゲームサーバー、スケジューラー、バックアップ
    • システム(管理者のみ):サービス、Nginx、ログ、Cron、監視、ファイアウォール、セキュリティ、Fail2ban、ツール、Webhook、ユーザー、監査ログ、ターミナル(デフォルトではオフ)
    • アカウント:設定、管理者向けにライセンス
    • 管理者ではないユーザーは、いずれかのサイトへのアクセス権がある場合、マイWebサイトも表示されます
  2. Step 28

    240種類以上のテンプレートをワンクリックでインストールでき、ライブコンソール、ファイル、バックアップ、スケジュール、サーバーごとのSFTPが使えます。

    • Minecraft、Hytale、Sourceシリーズ、Rust、Valheim、ARK、Palworld、FiveM、Discordボット、ボイスサーバー、ローカルAIツール用のセクションがあります
    • クラッシュ分析で原因と対処法が分かります。たとえばJavaのバージョン違いやメモリ不足による強制終了などです
    • nice や cpulimit の代わりに、cgroup v2でサーバーごとにリソースを制限できます
    • ユーザーごとの権限は、閲覧から、コンソール、電源、ファイル、バックアップなどのカスタムリストまで設定できます
    • ワンクリックのインストールと更新、コマンド入力付きのライブコンソール、編集、アップロード、zipとtarの展開、chmod に対応したファイルマネージャーがあります
    • 手動バックアップと定期バックアップ、再起動やバックアップやコマンドのスケジューラー、サーバーごとのchroot済みSFTPアカウントがあります
  3. Step 29

    nginxまたはApacheのvhost、Let's Encrypt、DNS、データベース、サイトごとのツールを扱えます。

    • nginxまたはApacheのドメインを、無料のLet's Encrypt HTTPSで運用できます。証明書の適用範囲が分かるサブドメイン、リバースプロキシモード、既存サイトのインポートにも対応しています
    • BIND9のゾーンは再読み込み前に検証され、Cloudflareと同期できます
    • MariaDBのデータベースとユーザーを、インポート、エクスポート、Adminerで管理できます。データベースを高速化するための提案も表示されます
    • PHPのバージョン、プール、モジュールを管理できます
    • サイトごとのツール:PHP設定、パスワード保護、IPブロック、cron、バックアップ、gitデプロイ、Node.jsやPythonのアプリ
    • サーバー全体と各サイトのNginx設定ができます
    • サイトごとのファイル、FTPとSFTPのアカウント、ワンクリックで入れられるRoundcubeとphpMyAdminのインストーラーがあります
    • Redis、Valkey、memcachedを1つのページから管理できます
  4. Step 30

    PostfixとDovecotに加え、DKIM、到達性チェッカー、キュー、配信ログ、ブロックリストのチェック、Roundcubeが使えます。

    ドメインを追加し、DKIMキーを生成して、パネルが表示するDNSレコードを公開します。IPのPTRレコードがメールのホスト名と一致しているかも確認してください。これはIPを借りている場所で設定するもので、パネルでは変更できません。

    • Postfix、Dovecot、Rspamdをボタン1つでインストールできます
    • メールボックス、エイリアス、キャッチオール、転送、不在返信に対応しています
    • DKIM、SPF、DMARC、到達性チェッカー、メールキュー、配信ログ、ブロックリストのチェックがあります
    • TLS証明書をワンクリックで取得でき、DNSレコードのエクスポートとCloudflareへの公開もできます
    • Thunderbird、Outlook、Apple端末向けの自動設定に対応しています
  5. Step 31

    サービス制御、自己修復付きのウォッチャー、公開ステータスページ、アラート、ファイアウォール、マルウェアスキャン、ロール、監査ログがあります。

    • nginx、Apache、MariaDB、PHP-FPM、fail2banのインストール、起動、停止、ログの確認ができます。ほかにもログビューア、ログのクリーニング、cronエディタがあります
    • HTTP、TCP、ping、SSL有効期限、ディスク、メモリ、CPU、サービスの監視には自己修復があり、30日分の履歴と、/status の公開ステータスページがあります
    • クラッシュ、バックアップ、ディスク残量の不足、証明書の期限切れ間近に対して、Webhook、Discord埋め込み、メールでアラートを送れます
    • ufw、firewalld、nftablesによるファイアウォール、自動でロールバックするオプションの基本ファイアウォール、fail2banのセットアップウィザードがあります
    • Cloudflareの実IPの更新と、2FAを使う管理者だけが使えるブラウザターミナルがあります
    • 管理者、オペレーター、閲覧者の3つのロールがあり、サーバーごとの権限は、閲覧、制御、管理、カスタムから選べます
    • TOTP二要素認証、GoogleやDiscordでのサインイン、ログインのロックアウト、CSRF保護、アクティブセッションの管理、CSVエクスポート付きの監査ログがあります
    • ClamAV、LMD、rkhunter、chkrootkitによるマルウェアスキャンと、ユーザークォータ付きのパッケージがあります

バックアップ

初日に設定しておいてください。種類は3つあり、それぞれ画面上の場所が違います。

  1. Step 32

    パネルのバックアップ、ゲームサーバーのバックアップ、Webサイトのバックアップは別々です。

    スケジュールに従って、パネルは自分の最新のバックアップを展開し、その中のデータベースを開きます。これにより、アーカイブが存在するだけでなく、復元できることが確認できます。

    • パネルのバックアップは、設定、データベース、パネルが管理するホスト設定を対象とし、cronのスケジュールと保持期間で動きます
    • ゲームサーバーのバックアップは手動または定期で、書き込み後に検証され、UIから復元でき、ZIPをダウンロードできます
    • Webサイトのバックアップは、ファイルと、必要に応じてデータベースを含む1つのZIPで、別のVorqulサーバーにアップロードしてサイトを移行できます
  2. Step 33

    バックアップ、オフサイトターゲットから設定します。コピーはサーバーを離れる前に、AES-256-GCMで暗号化されます。

    暗号化されたコピーを自分で読むには、JARの decrypt-backup コマンドを使います。

    • 直接のターゲット:SSH、SFTP、FTP、S3
    • rclone経由のGoogle Drive、OneDrive、Dropbox
    bash
    java -jar vorqul-panel.jar decrypt-backup backup.zip.enc backup.zip
  3. Step 34

    rcloneをインストールし、リモートを一度作成してから、そのリモートをオフサイトターゲットとして使います。

    rclone config で、drive タイプの gdrive という名前のリモートを作成します。ブラウザのないサーバーでは、自動設定の質問に no と答え、お使いのコンピューターで rclone authorize "drive" を実行して、表示されたトークンを貼り付けます。パネルに指定する前に、lsd の行でDriveのフォルダが一覧表示されることを確認してください。

    bash
    sudo apt install rclone
    rclone config
    rclone lsd gdrive:
  4. Step 35

    ゲームサーバーとWebサイトは、画面から復元します。パネルのデータベースは、パネルを停止した状態で手動で復元します。

    パネルは、開いたままのデータベースを置き換えることはせず、実行すべきコマンドをそのまま表示します。ホスト設定の復元はファイルごとに行われ、置き換えるものの .vorqul-pre-restore コピーが残ります。

メンテナンス

更新で、設定、データベース、ゲームサーバーに手が加わることはありません。

  1. Step 36

    安全な方法です。現在のJARと設定を保存し、アトミックに入れ替えて再起動し、/healthz を待ち、新しいバージョンが起動しなければロールバックします。

    bash
    sudo vorqulctl update /path/to/vorqul-panel.jar
    sudo vorqulctl fix-libs

    fix-libs は、新しいバージョンが新しいライブラリを必要とする場合にだけ、あとで実行してください。

  2. Step 37

    インストーラーをもう一度実行すると、既存のインストールを認識し、設定を保持したまま、lib/、ユニット、ヘルパーを更新します。

    置き換えられたファイルは、データディレクトリの backups/_install/ に保存され、直近10回分が保持されます。

    実行中のゲームサーバーには、それぞれの停止コマンドと、保存のための process.stop.timeout 秒が与えられ、その後SIGTERM、最後にSIGKILLが送られます。パネルが戻ると再び起動し、予定された再起動はクラッシュとして報告されません。

    bash
    sudo bash scripts/install.sh
  3. Step 38

    1つ目のコマンドは、サービス、ヘルパー、sudoersルールを削除し、データは残します。2つ目は、DELETE と入力すると、データディレクトリと vorqul ユーザーも削除します。

    bash
    sudo vorqulctl uninstall
    sudo vorqulctl uninstall --purge-data

    パネルがインストールしたパッケージ、/var/www 以下のWebサイト、メールボックス、ファイアウォールのルールはそのまま残ります。

トラブルシューティング

The failures that actually happen, and what causes them.

インストールに関する質問

まとめ

VorqulPanelのインストールにかかる時間は、クリーンなLinuxサーバーでおよそ15〜30分です。Debian 12、Ubuntu 22.04以降、またはAlmaLinux 9で、root権限と2 GB以上のRAMが必要です。パネルは単一のJARとscripts/install.shで提供され、このスクリプトがJava 25(なければ)をインストールし、サービスユーザーを作成して、vorqul-panelのsystemdユニットを登録し、ポート8765〜8767を開放します。ビルド手順、コンテナランタイム、外部データベースは不要です。パネルは標準で、自分の状態をSQLiteに保存します。

  • 所要時間: 15〜30分
  • ランタイム: Java 25以降(自動でインストールされます)
  • 対応ディストリビューション: Debian 12、Ubuntu 22.04以降、AlmaLinux 9
  • パネルのストレージ: SQLite。外部DBは不要です
このページの用語

サーバーコントロールパネル セルフホスト 買い切りライセンス 監査ログ vorqulctl rootヘルパー セットアップURL パネルデータベース モジュールスイッチ vhostの引き継ぎ オフサイトバックアップ 二要素認証

関連

Reviewed