ネットワーク問題

ファイアウォールの設定
プロキシサーバーの設定

ファイアウォールの設定

Unity Package Manager が HTTPS を使用して以下のドメイン名にアクセスできることを確認します。

packages.unity.com
download.packages.unity.com
upm-cdn.unity.com (中国内では、upm-cdn-china.unitychina.cn)

ファイアウォールの許可ドメインリストに上記のドメイン名を追加します。

プロキシサーバーの設定

プロキシサーバーを使用する場合は、Unityパッケージレジストリに対して要求を実行するときに使用するUnity Package ManagerのHTTP_PROXYおよびHTTPS_PROXY環境変数を構成します。

オペレーティングシステムに応じて、これらの変数（システム変数またはユーザー変数）をグローバルに設定できます。または、起動時に Unity Hub に対してのみ設定できます。

ファイアウォールの内側の環境に対して、自己署名証明書の SSL 認証局を設定できます。

自己署名証明書

一部の企業や機関では、ユーザーはファイアウォールに保護されプロキシ経由でのみインターネットにアクセスできます。一部のプロキシは、HTTPS コンテンツを解凍し、独自の自己署名証明書を使って再度パックします。Unity Package Manager の根底にある HTTPS レイヤーはこれらの自己署名証明書を認識しないため拒否し、接続を中間者攻撃の可能性があるものとして扱います。つまり、追加の SSL 認証局を設定してこれらの証明書を許可しない限り、パッケージマネージャーを含む Unity の多くの機能を使用できません。

追加の SSL 認証局を設定するには、以下の手順を行います。

1 つ以上のカスタム認証局を使用してテキストファイルを作成します。ファイルは、Privacy-Enhanced Mail (PEM) 形式の 1 つ以上の信頼できる証明書で構成する必要があります。以下はその例です。

Unity はファイルシステム上のすべての場所をサポートしていますが、可能であれば、このファイルを upm-config.json と同じ場所に置きます。
システムレベルの Unity 設定フォルダーに upm-config.json という名前の空の JSON ファイルを作成します。
- Windows: %ALLUSERSPROFILE%Unity/config
- macOS: /Library/Application Support/Unity/config
- Linux: /usr/share/unity3d/config
upm-config.json ファイルで、caFile 属性を加えると、PEM ファイルの絶対パスを設定します。以下はその例です。
```
{
  "caFile": "C:\\ProgramData\\Unity\\config\\cert.pem"
}
```

Unity Hub の環境変数の設定

このセクションでは、WindowsコマンドプロンプトまたはmacOSまたはLinuxターミナルから実行できるコマンドファイルを作成する手順について説明します。または、コマンドをコピーして、プロンプトウィンドウまたはターミナルウィンドウに直接貼り付けることもできます。

ノート コマンドファイルを実行する前に、Hub を完全に終了してください。Hub が既に実行されている場合、再起動せずに Hub にフォーカスを切り替えます。そのため、変更されたプロキシ設定は適用されません。

Windows

以下の手順で、Windows にコマンドファイルを作成します。

このファイルは、環境変数が設定された状態で Hub を起動します。ファイルをダブルクリックするか、コマンドプロンプトから呼び出すことができます。Unity はこれらの環境変数を、Hub から起動した Unity エディターの処理に渡します。

メモ帳などのテキストエディターを開きます。
以下のテキストを入力し、proxy-url を正しいプロキシサーバー URL に置き換え、必要に応じて Hub インストールパスを変更します。
```
@echo off
set HTTP_PROXY=proxy-url
set HTTPS_PROXY=proxy-url
start "" "C:\Program Files\Unity Hub\Unity Hub.exe"
    
```
ノート パスにスペースが含まれる場合は、パスを 2 重引用符 (") で囲む必要があります。
ファイルを自分で容易に見つけられる場所 (例えば Desktop) に保存し、ファイルに .cmd 拡張子がついていることを確認します (例えば launchUnityHub.cmd)。

macOS

以下の手順で、macOS に launchUnityHub.command ファイルを作成します。

このファイルは、環境変数が設定された状態で Hub を起動します。ファイルをダブルクリックするか、Bash ターミナルから呼び出すことができます。Unity はこれらの環境変数を、Hub から起動した Unity エディターの処理に渡します。

ノート コマンドファイルをダブルクリックすると、ターミナルウィンドウ、またはタブが開き、スクリプトが終わっても開いたままの状態です。この動作を Terminal.app の設定で変更できます。

ターミナルウィンドウを起動します。
以下のテキストを入力し、proxy-url を正しいプロキシサーバー URL に置き換え、必要に応じて Hub インストールパスを変更します。
```
echo '#!/bin/bash
export HTTP_PROXY=proxy-url
export HTTPS_PROXY=proxy-url
nohup "/Applications/Unity Hub.app/Contents/MacOS/Unity Hub" &>/dev/null &' > launchUnityHub.command
chmod +x launchUnityHub.command
```
ノート パスにスペースが含まれる場合は、パスを 2 重引用符 (") で囲む必要があります。
必要な場合は launchUnityHub.command ファイルを任意の場所 (例えば Desktop) に移動します。

トラブルシューティング

カスタムパッケージの作成