Eagle3D は ZIP パッケージからインストールします。Web スペースにアップロードし、ブラウザでサイトを開いて、セットアップウィザードに従います。全体の作業は数分で完了します。
始める前に
- サーバー要件 を確認します。
- Eagle3D のインストールパッケージ(ZIP ファイル)をパソコンに用意します。ライセンスメールに記載のリンクからダウンロードしてください。
- 使用するアドレスを決めてください(例:
https://print.example.com/)。ライセンスは後でこのドメインに紐付けられます。wwwありとwwwなしは別のドメインとして扱われます。 - ドメインまたはサブドメインがすでに HTTPS で開けることを確認してください。
- この時点ではライセンスのアクティベーションコードは不要です。Eagle3D は最初のサインイン後にコードの入力を求めます。
ステップ 1. 空のデータベースを作成する
- ホスティングパネルでデータベースツールを開きます(例:cPanel > MySQL Databases)。
- 新しいデータベースと、強力なパスワードを設定したデータベースユーザーを作成します。
- ユーザーを ALL PRIVILEGES でデータベースに追加します。
- データベース名、ユーザー名、パスワードを控えておいてください。ウィザードで必要になります。
ステップ 2. ファイルをアップロードする
ZIP パッケージをサイトのフォルダー(例:public_html またはサブドメインのフォルダー)にアップロードし、そこで展開します。cPanel では File Manager を使用できます。ZIP をアップロードしてから Extract を選択してください。
SSH アクセスがある場合は、コマンドラインから同じ操作を行えます。
cd ~/print.example.com
unzip ~/eagle3d-installation.zip
フォルダー名とファイル名はご自身のものに置き換えてください。パッケージはフォルダー内に直接展開されます。サイトのフォルダーに index.php、order.php、および app、pages、install フォルダーがあれば完了です。
ステップ 3. セットアップウィザードを実行する
ブラウザーでサイトを開きます(例:https://print.example.com/)。セットアップウィザード(Eagle3D Setup)が自動的に起動します。右上でウィザードの言語を 英語 と Turkce に切り替えられます。
1. サーバー
ウィザードは PHP のバージョン、PHP 拡張機能、書き込み可能なフォルダー、HTTPS をチェックします。赤で表示された項目は、続行する前に修正する必要があります。ホスティングパネルで修正し、再確認 をクリックしてください。オレンジの項目は警告です。必要な項目がすべて揃ったら 続行 をクリックします。
2. データベース
ステップ 1 で控えた接続情報を入力します。
| フィールド | 入力内容 |
|---|---|
| ホスト | 通常は localhost |
| ポート | 通常は 3306 |
| データベース名 | 作成したデータベース |
| ユーザー名 | データベースユーザー |
| パスワード | データベースユーザーのパスワード |
接続をテストして続行 をクリックします。ウィザードが接続、データベースのバージョン、データベースが空であることを確認します。
3. ビジネスと管理者
ビジネス情報と最初の管理者アカウントを入力します。ビジネス情報は後から 設定 → 一般 で変更できますが、ドメインはそこでは変更できません。
| フィールド | 説明 |
|---|---|
| システム / ビジネス名 | パネル、注文ページ、メールに表示される名前 |
| ドメイン | ライセンスが紐付けられるドメインです。使用するアドレスを正確に入力してください。 |
| アプリケーションフォルダー | 参考表示:Eagle3D が動作するフォルダー(ルートの場合は /) |
| システム言語 | パネル、注文ページ、追跡ページの言語(12 言語) |
| 国 | 電話番号の形式を設定します。トルコの場合、すべての県と郡があらかじめ読み込まれます。 |
| 通貨記号 | 1~5 文字。国に応じて候補が表示されます |
| 数値形式 | 1.234,56 または 1,234.56 |
| タイムゾーン | 日付、納期、レポートに使用されます |
| 事業形態 | 個人 / 小規模工房 または 法人(スタッフモジュール有効) |
| ユーザー名 | 3~50 文字:英字、数字、ドット、ダッシュ、アンダースコア |
| メール | 管理者のメールアドレス |
| パスワードとパスワード(確認) | 10 文字以上。単純すぎるパスワードは拒否されます |
インストールを開始 をクリックします。ウィザードがテーブルを作成し、初期値を書き込み、管理者アカウントを作成します。失敗した場合はデータベースがロールバックされるので、再試行できます。
4. 完了
ウィザードに インストール完了 と セキュリティチェック が表示されます。機密ファイル(.env など)が外部から開けるかどうかをテストします。各行に 外部からアクセス不可 と表示されるはずです。外部からアクセス可能 と表示された行がある場合は、公開する前にサーバーのアクセスルールを確認してください。
さらに安全を期すため、サーバーから install フォルダーを削除できます。ウィザードはすでに自動的に無効化されています。サインインへ進む をクリックします。
ステップ 4. サインインしてライセンスを有効化する
作成した管理者アカウントでサインインします。その後、Eagle3D がライセンスのアクティベーションコードの入力を求めます。Eagle3D ライセンスを有効化するをご覧ください。
設定ファイル .env
ウィザードはアプリケーションフォルダーに .env という名前のファイルを書き込みます。このファイルには、データベース接続、アプリケーションフォルダー、ライセンスドメイン(APP_DOMAIN)、アプリケーションキー(APP_KEY)が含まれます。
.envのコピーを安全な場所に保管してください。 このファイルはデータベースのバックアップには含まれません。APP_KEYは絶対に変更しないでください。 保存されたストアキー、SMTP パスワード、ライセンスデータはこのキーで暗号化されています。- データベースのパスワードが含まれているため、このファイルは決して共有しないでください。
Cloudflare またはリバースプロキシの背後で運用する場合
サイトが Cloudflare やその他のリバースプロキシの背後で動作している場合は、プロキシのアドレス(IP アドレスまたは範囲をカンマ区切り)を指定した次のような行を .env に追加してください。
TRUSTED_PROXIES="203.0.113.10, 198.51.100.0/24"
これにより、サインインと注文の制限で実際の訪問者アドレスが使用されます。セキュリティとデータの所有権をご覧ください。