support@やinfo@に届くお客様メールを、個人のメールボックスとExcel台帳で回している会社は、担当者が休んだ日に対応が止まり、二重返信と対応漏れが起きます。ZendeskやHelp Scoutを入れれば解決しますが、人数×月額をずっと払い続けることになる。この記事は、その代替になる無料のオープンソース・ヘルプデスク「FreeScout」を、VPSではなく中小企業が実際に持っている共有レンタルサーバーに日本語で立てるための導入手順書です。当社が実際に構築し、実在のメールボックスからメールを受信してチケット画面に出るところまで実測した記録から起こしました。

私は名古屋でAIシステム開発の会社(株式会社エクスブリッジ)をやっています。

■なぜFreeScoutを選んだのか(データの話)

当社は業務システムの代替になるオープンソースを2,800本紹介するカタログサイトを運営しています。その検索流入を分析したところ、面白いことが分かりました。検索エンジンから実際にクリックされているのは、NottaやSalesforceのような大物ではなく、FreeScoutのような「日本語で書いた人がまだ誰もいないOSS」のページだったのです。

そこでFreeScoutを調べると、条件が異常に良いことが分かりました。

・GitHubスター4,500超、更新は現役(前日にもコミット)

・日本語UIが公式配布に同梱。翻訳ファイルの実測サイズは英語版・ドイツ語版とほぼ同じ=訳抜けがほぼ無い

・PHP+MySQLで、依存ライブラリ(vendor)込みで配布されている=composer不要=共有レンタルサーバー向き

・ユーザー数無制限。人数課金という概念そのものが無い

「月数百円のレンタルサーバーでZendesk代替が動く」——これは書く価値があると判断し、実際に構築しました。

■そして罠を10個踏みました(この記事の本体)

公式ドキュメントはVPS・Docker前提です。共有レンタルサーバーに置いた瞬間、公式に載っていない問題が連続で起きました。実際に踏んだ順に:

1. 公式のWebインストーラーが起動しない(同梱vendorに依存ライブラリが足りず500エラー。これは回避不能で、CLIインストールに切り替えるのが正解でした)

2. 全ページが「Untrusted Host」で拒否される(.envに1行必要)

3. 画面が真っ白の500(Web実行のPHPがSSHとは別ユーザーで動いており、書き込み権限の設計を知らないと詰む)

4. ログインできたのにCSSだけ403でデザインが崩壊(Webユーザー所有で自動生成されたファイルを、サーバーが配信拒否するという珍しい挙動。所有者を付け替えるスクリプトを書いて解決)

5. SSHにphpコマンドが無い(フルパスで呼ぶ)

…ほか、DBホスト名の罠、cronの登録方法、無害な警告と本物のエラーの見分け方まで、全部で10個。

有料部の手順書は、この10個を先回りして回避する順番で書いてあります。上から実行すれば、ログイン→メールボックス作成→受信テストまで到達できます。

■このキットの構成(有料部に全文)

1. 構築手順書 — 実測記録から起こした全手順。うまくいかないときの逆引き表つき

2. AI用指示書(AI-START-HERE.md) — Claude Code等のAIエージェントに渡すと設置作業そのものを任せられます。「受信の実測確認をしてから完了報告する」まで指示済み

3. サーバー要件チェックツール(PHP1枚) — 置いて開くだけでPHP版・拡張・実行ユーザーまで判定

4. CSS403修正スクリプト — 共有サーバー特有の問題をコマンド1発で解消

5. カスタマイズ指示文集 — メールボックス追加・自動返信・署名テンプレ・通知の絞り込みをAIに頼む文面5本

■先に選択肢を全部置いておきます

・FreeScout本体は無料です(AGPL-3.0)。VPSに慣れたエンジニアがいるなら公式手順でどうぞ

https://github.com/freescout-help-desk/freescout

・このキットはKurage App Storeでも同一内容・同一価格で販売しています(zipダウンロード形式)

https://kappstore.exbridge.jp/app.php?id=6d0e2c491e4170da&ref=brain21

・問い合わせ管理を無料でやる方法の解説(この記事の背景)

https://exbridge.jp/toiawase-kanri.php?ref=brain21

・構築ごと任せたい場合(サーバー選定〜運用設計まで当社が代行、税込110,000円〜)

https://kurage.exbridge.jp/vibe-oss.html?ref=brain21

購入者には導入に関するメール質問を3か月お受けします。それでは有料部で、構築手順書の全文をどうぞ。