uVersion
日本語
ダウンロード →

Wiki

uVersion Server のインストール

あなたの方法を選択：Ubuntu / Debian（.deb パッケージ）、Windows（PowerShell）または Docker。

uVersion サーバーは、Ubuntu/Debian、Windows、または Docker でコマンド 1 行でインストールできます。 インストーラーはいくつか質問し、PostgreSQL、データベース、システムサービス、HTTPS 証明書を設定したうえで、 管理者パスワードを表示します。所要時間は約 10 分です。

用語

これらのページ全体で 6 つの語が繰り返し登場します。いずれかが馴染みのないものであれば、この セクションだけで十分です：ほかに前提となる知識はありません。

  • データフォルダー：サーバーがあなたに帰属するすべて、すなわちバージョン管理された ファイルの内容、証明書、そしてサーバーの識別情報を書き込むフォルダーです。 インストール時に選択します。バックアップすべきフォルダーはこれです。
  • PostgreSQL クラスター：独自のフォルダーと独自のポートを持つデータベース インスタンスです。1 台のマシンで、互いに見えないまま複数をホストできます。uVersion は、あなたの 回答に応じてシステムのものか、自分のものを使用します。
  • システムサービス：バックグラウンドで動作し、マシンの起動時に自動で再起動する プログラムです。Windows では「Windows サービス」、Linux では「systemd ユニット」と呼びます。
  • TLS フィンガープリント：サーバーの証明書を識別する 64 文字の文字列です。 マシンへの初回 SSH 接続と同じように、各端末で一度だけ確認します。
  • アクティベーションコード：メールで届く UV-XXXX-XXXX-XXXX という コードです。インストーラーがこれを完全なライセンスと引き換えます。使用できるのは 一度きりです。
  • パージ：設定への回答も含めた、パッケージの完全なアンインストールです。 Debian では、apt remove がプログラムを削除し、 apt purge はさらにその設定も削除します。

前提条件

  • 1 台のマシン（VPS、ミニ PC、オフィスのサーバーなど）。Ubuntu 24.04+、 Debian 13+、または Windows 10、11、Server 2019+ 上で動作するもの。ほかのディストリビューションは Docker コンテナがカバーします。
  • そのマシンでの管理者権限：Linux では root（実際には sudo 経由）、または Windows では PowerShell の「管理者として実行」。 これがないとインストーラーは起動を拒否します。
  • uVersion のアクティベーションコード（形式 UV-XXXX-XXXX-XXXX）。 ライセンス発行時にメールで届くか、 アカウント画面から取得できます。 このコードは一度限りの使用です：一度引き換えると、別のマシンでは 使えなくなります。
  • licence.uversion.io への外向きのインターネットアクセス（HTTPS）。 コードの引き換えの間だけ必要です。インターネットに接続できないネットワークでは、Ubuntu ページの 「非対話・オフラインでのインストール」セクションを参照してください：インストーラーは完全な ライセンスキーも受け付けます。これは別の端末からアカウント画面で取得します。
  • PostgreSQL。Ubuntu と Debian では、パッケージの依存関係として自動的に導入される ため、何もする必要はありません。Windows では、インストーラーが winget 経由で導入しますが、 これは Windows Server 2019 と 2022 には存在しません：この 2 つのバージョンでは、 スクリプトを実行する前に PostgreSQL 16 を手動でインストールしてください。
  • ディスク容量。サーバー本体とデータベースは軽量です：支配的なのはフラグメント ストア（全リビジョンを合わせたファイルの内容）なので、Unreal プロジェクトのサイズとその履歴を 基準に見積もってください。データベースもデータフォルダーに配置する場合、インストーラーはさらに 1 GB のバラスト（重し）ファイルをそこに書き込みます。ディスクが満杯になったときに削除するためのものです。
  • 受信方向に開いた TCP ポート 8443。端末はここから接続します。 Windows インストーラーはファイアウォールのルールを自分で作成します。Debian パッケージは ポートを一切開きません：自分で行ってください。例： sudo ufw allow 8443/tcp。

方法を選択

Ubuntu / Debian

Ubuntu 24.04+、Debian 13+。.deb パッケージによるインストール。

sudo apt install ./uversion-server_*.deb

Windows

Windows 10、11、Server 2019+。管理者として PowerShell 1 行。

iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

Docker

サーバーとデータベースをコンテナで。Red Hat 系（RHEL、Rocky、AlmaLinux、Fedora）で 唯一サポートされる方法です。

docker compose up -d

HTTPS と証明書

サーバーはポート 8443 で HTTPS のみを話します。設定は不要で、ドメイン名も 必要ありません：初回起動時、サーバーは自己署名と呼ばれる証明書を自ら生成し、インストールの最後に その SHA-256 フィンガープリントを表示します。各端末は初回接続時にこのフィンガー プリントを一度だけ確認し、以後は異なるフィンガープリントをすべて拒否します。

目に見える結果：https://<サーバーのIP>:8443 を開いたブラウザは セキュリティ警告を表示します。この証明書がどの公的認証局によっても署名されて いないためです。これは想定どおりです。表示されたフィンガープリントがインストール時に控えたものと 一致することを確認したうえで、続行してください。

サーバーへの初回接続時にブラウザが表示するセキュリティ警告。続行できるボタンが表示されている。

端末側の手順の詳細： TLS フィンガープリント。 サーバーにドメイン名があり、すでに証明書をお持ちの場合は、代わりにご自身の証明書を配置できます： サーバーに同梱される運用ランブック（docs/operations.md）のセクション 2 を参照してください。

次のステップ

インストールが完了すると、枠内に admin というユーザー名、一時パスワード、そして サーバーのアドレスが表示されます。これらを控えておいてください。その後、 ネットワーク上の任意の端末から、ブラウザまたはデスクトップクライアントで、 https://<サーバーのIP>:8443 というアドレスに接続します。ここで <サーバーのIP> は、今インストールしたばかりのマシンのアドレスです。