Pancake Stack › Pancake Stack マニュアル

サイトが開かない、サーバが起動しない、リンクが動かないときの対処法、Pancake がデータを保存する場所、サポートの受け方を説明します。

17.1まず確認すること

1. 状態表示を確認します。要確認と表示されている場合は、ポインタを重ねるとエラーを読めます。
2. ログウインドウ（⌥⌘L）を開きます。サーバのログは「Web server」と「MySQL」、サイトごとのログは「PHP errors」と「web server errors」です。
3. ⌥ を押しながら「すべて停止」をクリックすると、すべてを再起動します。
4. アシスタントに「ブログがエラーになるのはなぜ？」と尋ねます。ログを代わりに読んでくれます。

17.2サイトが開かない

ブラウザが接続できない

サーバが停止している可能性があります。「すべて開始」をクリックしてください。停止中は「開く」ボタンが灰色になります。

アドレスにポート番号が必要

Mac 上のほかのウェブサーバ（macOS の Apache、MAMP、Docker）がポート 80 を使っていた場合、Pancake は 8080 に移ります。状態表示は実行中 :8080になり、アドレスは http://blog.localhost:8080 のようになります。常に正しいアドレスを開く、サイトカードの「開く」ボタンを使ってください。

白いページ、または「500 Internal Server Error」

PHP のエラーです。サイトの「PHP errors」ログを開くか、エラーをページに表示をオンにします（サイトの PHP 設定にあります）。

「Error establishing a database connection」

MySQL が動いていない（「すべて開始」してください）か、サイトの設定が Pancake の渡す DB_… 変数ではなく固定のデータベース情報を使っています。読み込んだ WordPress サイトは、これらの変数を読むように設定されます。

フォルダで「Forbidden」と表示される

index ページがありません。index.html か index.php を追加するか、AutoIndex をオンにします。

React や Vite のアプリで /about などのリンクが「Not Found」になる

サイトカード（詳細）でシングルページアプリをオンにします。

WordPress が古い本番のアドレスに移動する

データベースに古いアドレスが残っています。もう一度読み込んで置き換える旧サイトのアドレスを入力するか、アドレスを自動で置き換える公開中のサイトからを使ってください。

17.3サーバが起動しない

「MySQL didn't start listening」

クラッシュ後に MySQL が復旧中の可能性があります（Pancake は最大 1 分待ちます）。「MySQL」ログを確認してください。ほかの MySQL がポート 3306 を使っている場合は Pancake が次の空きポートを自動で使うので、それが原因ではありません。

「… stopped unexpectedly」

サーバがクラッシュしたため、スタック全体の整合性を保つよう Pancake がすべてを停止しました。表示されたログを読んでから、もう一度「すべて開始」してください。

「Template … wasn't applied」

編集したテンプレートが読み込めません。Pancake は自身のテンプレートを使っています。設定 ▸ 詳細 ▸ テンプレート…を開き、表示された行を直すかリセットしてください。

Python のサイトに「まだ設定されていません」と表示される

サイトカードの設定をクリックします。アプリが起動しない場合はアプリのログを読み、アプリのエントリ（module:callable）を確認してください。

17.4公開時の問題

テストリンクが表示されない

外部アクセスがオンで、サーバが動いていることを確認してください。新しいリンクの取得には約 20 秒かかります。1 分たっても表示されない場合は、「test link」ログに理由が書かれています（多くは、外向きのトンネルをブロックするネットワーク）。

自分のドメインで Cloudflare のエラーが表示される

トンネルがつながっていません。外部アクセスがオフ、サーバが停止中、または Mac がスリープ中かオフラインです。オンラインペインのサイトカードにトンネルの状態が表示され、トンネルのログを表示（詳細）で詳しい情報を確認できます。

「プランの公開サイト数の上限を超えています」

別のサイトをオフにするか、ほかの Mac がサイトを公開していないか確認してください（オンラインペインにどの Mac かが表示されます）。

スマートフォンで blog.test が開かない

スマートフォンの DNS サーバにこの Mac のアドレスを設定し、同じネットワークにつなぐ必要があります。blog.localhost はスマートフォンからは開けません。

17.5その他の問題

https://name.localhost でブラウザが証明書の警告を出す

設定 ▸ ローカル HTTPSを開き、もう一度信頼…をクリックします。Firefox では、macOS の証明書を使うオプションをオンにしてください。

メールが届かない

意図どおりの動作です。メールはメールボックス（⇧⌘M）に保存されます。実際にメールを送るには、実際にメールを送信するを参照してください。

外部のデータベースに接続できない

テストの後に表示されるメッセージを読んでください。テストに失敗した場合を参照してください。

アシスタントが Apple Intelligence を使えないと言う

システム設定 ▸ Apple Intelligence と Siri で Apple Intelligence をオンにし、モデルのダウンロードが終わるまで待ちます。Apple Intelligence のない Mac では、クラウドのプロバイダを使えます（回答に使う AIを参照）。

AI ツールが「changes are switched off」と言う

アシスタントペインの詳細設定の最後で変更を許可を選びます。

17.6Pancake がデータを保存する場所

Pancake はサンドボックス化されているので、すべてが専用のコンテナに保存されます。設定 ▸ 詳細 ▸ データフォルダを表示で開けます。

フルパスは ~/Library/Containers/jp.co.enfour.pancake/Data/Library/Application Support/Pancake/ です。パスワードとキーはキーチェーンにあり、これらのフォルダには保存されません。

17.7サポートを受ける

• ヘルプ ▸ Pancake ヘルプ（⌘?）には、英語、日本語、韓国語で検索できるトピックがあります。
• Pancake Stack サポートページでは、よくある質問への回答とお問い合わせの方法を案内しています。
• お問い合わせの際は、macOS のバージョン、Mac の種類（Apple シリコンか Intel か）、状態表示とログの内容をお知らせください。パスワードやキーは決して送らないでください。