宝塔パネルでインストール
Linux サーバーがあり、GUI で管理したい人向けです。所要時間はおよそ 15 分。
もっと手軽に済ませたい場合は Docker を見てください。3 分で起動し、データベースの用意も不要です。
手順 1：宝塔パネルをインストール
推奨 OS は CentOS 7+ / Debian 11+ / Ubuntu 20.04+ です。SSH で接続し、https://www.bt.cn/new/download.html にある OS 別のワンライナーを実行します。
完了するとパネルの URL・ユーザー名・パスワードが表示されます。必ず控えてください。
手順 2：実行環境をインストール
初回ログイン時に推奨セットが表示されます。LNMP を選び、バージョンを指定します。
| コンポーネント | 選択 |
|---|---|
| Nginx | 任意のバージョン |
| MySQL | 5.7 以上 |
| PHP | 8.0 以上、できれば 8.2 |
「一括インストール」を押して待ちます（10 分ほど）。
手順 3：bcmath をインストール（省略不可）
宝塔は既定で bcmath をインストールしません。しかしプログラムの金額計算はすべてこれに依存しているため、無いと真っ白な画面と致命的エラーになります。
- 左メニュー → ソフトウェアストア → 導入した PHP バージョン → 設定
- 拡張のインストール タブを開く
bcmathを探してインストール
ついでに gd、curl、zip、pdo_mysql も入っているか確認してください。宝塔は通常これらを含んでいます。
インストーラの最初のステップで環境が自動チェックされ、不足しているものが一覧表示されます。導入後に再読み込みすれば再確認できます。
手順 4：サイトを作成
- 左メニュー → サイト → サイトを追加
- ドメインを入力（まだ無ければサーバー IP でも可）
- データベースで
MySQLを選択。ユーザー名とパスワードが自動生成されるので控えておく - PHP バージョンは手順 2 で入れたものを選ぶ
- 送信
手順 5：ソースをアップロード
- https://faka.wiki/download.php から ZIP をダウンロード（GitHub が速い環境ならリポジトリから直接でも可）
- 宝塔 → ファイル → サイトのルート（通常
/www/wwwroot/あなたのドメイン）へ移動 - ZIP をアップロードし、右クリックで 解凍
- 解凍時にフォルダが 1 階層増えた場合（
acg-faka-mainなど）は、その中身をすべて選択してサイトルート直下へ移動し、index.phpがルート直下に来るようにする
ルート直下に
index.php、app、kernel、configが見えていれば正解です。
手順 6：URL 書き換えを設定
これを行わないと、トップページ以外はすべて 404 になります。
サイト → 対象サイトをクリック → 疑似静的（URL 書き換え）に、nginx 書き換えルールをまるごと貼り付けて保存します。
Apache の場合は設定不要です。プロジェクトルートの .htaccess が対応済みです。
手順 7：ディレクトリ権限を設定
サイト → 対象サイト → サイトディレクトリ で所有者を www にします。または ファイル でサイトルートを右クリック → 権限 → 所有者 www、「サブディレクトリに適用」にチェック。
プログラムが書き込む必要があるのは config、runtime、kernel/Install、assets/cache の 4 か所です。
手順 8：インストーラを実行
ブラウザでドメインを開きます。
- 環境チェック — 赤い印が出たら、指示に従って拡張の追加や権限修正を行う
- データベース — 手順 4 で宝塔が生成した名前・ユーザー・パスワード。ホストは
127.0.0.1 - 管理者アカウント — 管理画面のメールアドレスとパスワードを設定
- インストールを実行して完了を待つ
完了後、管理画面は https://あなたのドメイン/admin です。
この後は
- HTTPS：サイト → SSL → Let's Encrypt をワンクリック申請。「HTTPS を強制」も有効に
- 高速化：パフォーマンス最適化（Redis の効果は非常に大きいです）
- 使い始める：クイックスタート
よくある問題
| 症状 | 原因 |
|---|---|
| トップページ以外すべて 404 | URL 書き換え未設定。手順 6 へ |
| 真っ白／500 | ほぼ bcmath 不足。手順 3 へ。サイトルートの runtime.log も確認 |
| 「ディレクトリに書き込めません」 | 権限不足。手順 7 へ |
| データベースに接続できない | ホストは 127.0.0.1、認証情報は宝塔が生成したもの |
詳しくはトラブルシューティングを参照してください。