ヘルプデスクを自社サーバーで持つ（LibreDesk 日本語導入キット・VPS編）

公式イメージでは、日本語が使えません

LibreDesk はメール・ライブチャット・ヘルプセンターを1つにまとめたオープンソースのヘルプデスクです（GitHubスター2,861・Go製・AGPL v3）。Zendesk や Intercom の月額をやめたい会社の受け皿になります。

ところが、公式イメージをそのまま動かしても日本語にはなりません。

理由は、翻訳ファイルが stuffbin でバイナリに埋め込まれているからです。cmd/init.go の initFS() が上書きを許すのは static ディレクトリだけで、i18n は差し替えられません。日本語ファイルをマウントしても効きません。

自分でビルドする必要があります。 この手順書は、そのための構成ファイルと手順一式です。

さらに、本家の日本語は画面が壊れています

翻訳ファイルを1項目ずつ確認したところ、25か所で画面が壊れることが分かりました。

呼び出し側は引数を渡していないため（t('globals.messages.add')、internal/ai/ai.go の m.i18n.T("ai.apiKeyNotSet")）、プレースホルダがそのまま利用者に見えます。

25か所すべて直した翻訳（1,536項目）を同梱しています。本家へPRも出しましたので、マージされれば公式イメージのままで使えるようになります。

手順書に書いてあること

• 共有レンタルサーバーでは動かない理由。 「single binary」を名乗っていますが、PostgreSQL と Redis が別途必要です。VPSが要ります
• ポート衝突の回避。 同梱の構成はDBとRedisをホストに公開しません。公開すると既存のPostgreSQLと衝突して起動に失敗します（当社の環境で実際に止まりました）
• 日本語が本当に出ているかを確かめるコマンド。 画面を見る前にAPIで判別できます
• 公開時のnginx設定。 ライブチャットはWebSocketを使うため、1行間違えると画面は開くのにチャットだけ動きません
• AGPL v3 の意味。 改変してサービス提供する場合の義務

同梱物

• 導入手順書.md — 本体
• docker-compose.jp.yml — 日本語版が動く構成
• Dockerfile.jp — ビルド定義
• ja-JP.json — 修正済みの翻訳1,536項目
• scripts/check-ja-i18n.py — 本家追従時の未訳チェック

ソフト本体は含みません。 AGPLのOSSなので、GitHubから無料で入手できます。このキットが提供するのは、動く状態にするまでの時間です。

前提

VPS（メモリ2GB以上）＋ Docker。初回ビルドは10分前後です。共有レンタルサーバーしか無い場合は、FreeScout日本語導入キットのほうが適しています。

日本語版のソース

https://github.com/katsushi2441/LibreDesk-JP

翻訳の中身は買う前に確認できます。

あわせて（同じ用途の買い切りアプリ）

導入キットは「まず使ってみる」入口です。問い合わせ対応の仕事をそのまま自社の名前で運用するなら、買い切りのアプリもあります（ソースコード同梱・追加費用なし）。

• AIチャットボットを買い切りで（Kurage Light ChatBot） — AIチャットボットを買い切りで
• エクセル日報を自動化する入力ゼロCRM（Kurage CRM Agent） — エクセル日報を自動化する入力ゼロCRM
• 予約管理システムを買い切りで（Kurage 予約・受付 kreserve） — 予約管理システムを買い切りで

名古屋市内の事業者・事務所は AI-IT顧問契約（キャンペーン期間中はKurage App Storeの商品代金が無料）で設置まで任せられます。