LASSIC Media らしくメディア
Directusで社内データAPI基盤をセルフホスト外注
LASSIC IT事業部｜元請（プライムベンダー）としてシステム保守・運用を受託
この記事のポイント
- Directusは、既存のデータベースへ接続するだけでスキーマを変更せずにREST/GraphQL APIを自動生成できる、無料のセルフホスト型ヘッドレスCMS/データ基盤OSSです。
- ライセンスはMonospace Sustainable Core License（MSCL-1.0-GPL）で、内部利用や非商用利用は無償ですが、Directusの商用提供と競合する形での提供には制限があります。
- SSOや大規模なコレクション管理が必要になるとCore無料版の枠を超えるため、内製構築と外注委託のどちらで進めるかを費用構造とスキル面から判断する必要があります。
目次
- Directusとは？既存データベースを即座にAPI化するヘッドレスCMS/データ基盤OSS
- データファースト設計思想 — 既存スキーマをそのまま活かす仕組み
- Data Studio管理画面とFlow自動化でノーコード運用を実現
- Dockerで構築する標準的な導入手順
- ライセンス体系の理解：Monospace Sustainable Core LicenseとGPL-3.0移行
- Core無料版の制限とTeam/Enterpriseプランへの移行が必要になる場面
- セルフホスト内製と外注委託のコスト構造比較
- 内製構築に必要なスキルと外注との違い
- まとめ：Directusセルフホスト活用の3つの判断軸
- よくある質問
Directusとは？既存データベースを即座にAPI化するヘッドレスCMS/データ基盤OSS
Directusとは、既存のデータベースに接続するだけでREST/GraphQL APIを自動生成し、管理画面・認証・権限制御までをまとめて提供する無料のセルフホスト型ヘッドレスCMS/データ基盤OSSです。GitHub公式リポジトリでは「Turn your DB into a headless CMS, admin panels, or apps with a custom UI, instant APIs, auth & more」と紹介されており、2026年7月時点で3万6,000件を超えるスターを獲得し、TypeScriptを中心に開発が続いています*2。
社内に散在する基幹システムや業務データベースを、部門ごとにAPIを作り込んで連携させる体制には、開発工数の積み上がりとAPI仕様のばらつきという負担が伴います。Directusは、こうしたデータベースをそのままAPI化し、社内向けのデータ基盤やコンテンツ管理基盤として使うために開発されたオープンソースプロジェクトです。公式ドキュメントは「Connect it to your database, asset storage, and external services, and immediately get a REST and GraphQL API」と説明しており、データベースへ接続した時点でAPIが利用可能になる設計を特徴として挙げています*1。
ソフトウェア自体はセルフホストであれば無料で利用でき、SaaS型のAPI管理サービスを契約する場合と比べてライセンス費用を抑えやすい点は、コスト最適化を検討するうえで無視できない要素と言えるでしょう。一方で、構築・運用を自社で担うか外部に委託するかという別のコスト判断が新たに発生します。
データファースト設計思想 — 既存スキーマをそのまま活かす仕組み
対応データベースの種類とサーバー要件
Directusは、新規にデータベースを用意する製品ではなく、既に稼働しているデータベースへ接続して使う設計です。公式ドキュメントによると、対応データベースはPostgreSQL・MySQL・SQLite・MS SQL Server・MariaDB・CockroachDB・OracleDBの各LTS（長期サポート）バージョンで*4、社内で使われている主要なリレーショナルデータベースの大半をそのまま利用できます。ただし「Directus does not currently support using one database with multiple schemas」とされており、1つのデータベースに複数スキーマを跨いだ利用には対応していない点は事前に確認しておく必要があります*4。
サーバー要件については、最小構成が0.25vCPU・512MBメモリ、推奨される最小構成は2vCPU・2GBメモリとされています*4。キャッシュやスケーリングを行う場合はRedisの併用が推奨されており*4、アクセス量が多い社内システムでの利用を想定するなら、この推奨構成を目安に検討するとよいでしょう。
REST/GraphQL自動生成とロールベースの権限管理
データベースに接続すると、テーブル構造を基にREST APIとGraphQL APIが自動的に生成されます*1。エンジニアがゼロからAPI仕様書を作成し、エンドポイントを1本ずつ実装していく従来型の開発と比べ、データモデルの変更に追従しやすい点が特徴です。アクセス制御はロールベースで設計されており、公式ドキュメントは「Users can only see, edit, and create data as permitted by their role」と説明しています*1。部門やシステムごとに閲覧・編集の範囲を細かく分けたい社内データ基盤との相性がよい仕組みと言えます。
Data Studio管理画面とFlow自動化でノーコード運用を実現
Directusには「Data Studio」と呼ばれる管理画面が標準で付属します。公式ドキュメントは、これを「a web app for your whole team to manage content, files, users, and dashboards」と位置づけており*1、非エンジニアの担当者でもブラウザ上からデータの追加・編集・ファイル管理を行える点が特徴です。データベースを直接操作する知識がない部門でも、Data Studio経由であれば権限の範囲内でデータへアクセスできる体制を組みやすくなります。
加えて、Flowと呼ばれる自動化機能を組み合わせると、外部サービスとの連携やリアルタイム通知といった処理をノーコードで組み立てられます*1。ただし権限設計やFlowの条件分岐を誤ると、意図しない相手にデータが公開されたり、通知が重複配信されたりする恐れがあるため、本番運用前の設計レビューは欠かせません。
Dockerで構築する標準的な導入手順
QuickstartとDocker Composeの使い分け
公式ドキュメントは、Directusの立ち上げ方法として大きく3つを案内しています。1つ目はDirectus Cloudで、フルマネージドのため「約90秒」でプロジェクトを開始できるとされています*6。2つ目は、動作確認や検証向けのDocker Quickstartで、「docker run -p 8055:8055 directus/directus」というコマンド一つでコンテナを起動できます*6。3つ目が、本番運用に推奨されるDocker Composeによる構築です*6。
社内データ基盤として恒常的に稼働させる場合は、検証用のQuickstartではなく、複数コンテナを一括管理できるDocker Composeを選ぶのが基本方針になります*6。
環境変数SECRETとボリューム永続化、ヘルスチェック
Docker Composeの構成例には、PostgreSQL（PostGIS拡張付き）・Redis・Directus本体のコンテナが含まれ、各サービスにヘルスチェック機能が設定されています*5。必須の環境変数としては、データベース接続情報に加えて「SECRET」というプロジェクト設定用の値があり、公式ドキュメントは長くランダムな文字列を設定するよう案内しています*5。この値を推測されやすい文字列のまま運用すると、認証まわりの設定不備につながるおそれがあるため、初期構築時に個別の値へ差し替えることが前提の設計です。
公式ドキュメントは「Docker containers are ephemeral by design」と明記しており*5、アップロードファイル用の「./uploads」と拡張機能用の「./extensions」をボリュームとしてマウントしておかないと、コンテナの再作成時にデータが失われる設計です。バージョンはDocker Hub上で「directus/directus:11.1.1」のようにタグ管理されており、本番環境では特定バージョンへのピン留めが推奨されています*5。稼働確認には「/server/health」（依存関係を含む詳細な状態確認）と「/server/ping」（簡易な生存確認）という2つのエンドポイントが用意されています*5。
ライセンス体系の理解：Monospace Sustainable Core LicenseとGPL-3.0移行
Directusのライセンスは、GitHub公式リポジトリのLICENSEファイルによると「Monospace Sustainable Core License, Version 1.0」（略称MSCL-1.0-GPL）です*3。このライセンスでは、自社内での利用・非商用の教育・非商用の研究、またライセンシーへの専門サービス提供といった目的（Permitted Purpose）であれば、利用・複製・改変・再配布が認められています*3。
制限されるのは「Competing Use」と定義される利用形態で、ライセンサー（Monospace社）が利用料やロイヤリティを課している範囲において、その商用提供と競合する形でソフトウェアを提供することを指します*3。社内の業務データベースをAPI化して自社システムに組み込む、あるいは自社製品の一部として使うといった一般的な社内利用は、この制限に抵触するものではありません。なお、このライセンスにはソフトウェア提供開始から4周年を迎えた時点でGNU General Public License version 3（GPL-3.0）へ自動的に切り替わる規定も含まれています*3。ライセンス内容は個別のバージョンやリポジトリの更新によって変わり得るため、商用利用の可否を判断する際はGitHub上の最新のLICENSEファイルを確認することが望ましいでしょう。
Core無料版の制限とTeam/Enterpriseプランへの移行が必要になる場面
公式サイトの料金ページによると、無料のCoreプランには、ユーザー3席・コレクション25個・フロー5個までという上限があり、SSO（シングルサインオン）には対応していません*7。社内の小規模なデータ連携やプロトタイプとして使う分には十分な範囲ですが、利用部門や管理者が増える、あるいは扱うテーブル（コレクション）数が増えるほど、この上限に近づきます。
上位プランのTeamは月額499ドル（年間契約）で、SSO対応の10席が含まれ、追加1席あたり月50ドルで拡張できます。コレクション数は50個から上限100個まで拡張できます*7。Enterpriseはカスタム価格制で、SSOユーザー数・コレクション数・フロー数のいずれも無制限とされ、カスタムLLMとの連携にも対応します*7。社内の複数部門でSSO認証を必須とする、あるいは大規模なデータモデルを一括管理したい場合は、Core無料版の範囲では対応しきれず、Team以上への移行を前提にした予算計画が必要になるでしょう。
セルフホスト内製と外注委託のコスト構造比較
セルフホストによる内製構築と、外部パートナーへの委託では、費用構造・必要スキル・リスク対応の重心が異なります。以下の表に主な違いを整理しました。
| 比較項目 | セルフホスト内製 | 外注委託 |
|---|---|---|
| ライセンス費用 | Core無料版の範囲であれば発生しません。上限を超えるとTeam/Enterpriseの契約が必要です*7 | ソフトウェア自体の費用は同じですが、構築・保守を委託する分の費用が発生します |
| 必要な専門知識 | Docker運用・データベース管理・環境変数やロール権限の設計が必要です*4*5 | 専門パートナーが構築・調整を担うため、社内での知識習得は最小限で済みます |
| バックアップ・データ保全 | コンテナは一時的な設計のため、ボリュームのバックアップ運用を自社で設計・実行します*5 | バックアップ設計から監視までを含めて委託できます |
| スケール対応（SSO等） | Core無料版の上限を把握し、必要に応じて自社でプラン変更を判断します*7 | 利用状況の把握からプラン移行の提案までを任せられます |
内製構築に必要なスキルと外注との違い
Docker運用・権限設計・ライセンス管理に求められる専門知識
Directusを内製で構築・運用する場合、求められる専門知識は複数分野にまたがります。Dockerコンテナの運用とデータベース管理、ロールベースのアクセス権限設計、Flow自動化の条件設計、そしてMSCL-1.0-GPLライセンスの適用範囲の把握がその内容です。自社の情報システム部門だけでこれらを完結させるには、複数の担当者が連携する体制を整える必要があるでしょう。
判断を先延ばしにしたまま自己流で構築を進めると、SECRETの初期値を変更しないまま公開してしまう、ボリュームマウントを設定せずコンテナを再作成してデータを失う、といった問題に後から気づくケースが生じます。特にライセンスの適用範囲を正しく把握しないまま外部提供に近い使い方を始めると、想定外の契約対応が必要になる場面も考えられます*3。
専門パートナーに委託した場合の違い
専門パートナーに依頼すると、Docker環境の構築からロール権限設計、Flow自動化の調整、Team/Enterpriseへのプラン移行判断まで一連の工程を任せられます。自社では構成検討や動作検証だけで時間がかかる場面でも、複数のデータ基盤・CMS構築を扱ってきた知見を活用すれば、稼働までの期間を圧縮しやすくなります。内製と外注のどちらでも、まずは自社の既存データベースの棚卸しと、必要なユーザー数・コレクション数の見積もりが出発点と言えるでしょう。
まとめ：Directusセルフホスト活用の3つの判断軸
本稿ではDirectusの機能とセルフホスト構築の要点を、公式ドキュメントとGitHubリポジトリの情報に基づいて整理しました。要点は次の3つに集約されるでしょう。第一に、既存のデータベースへ接続するだけでREST/GraphQL APIとData Studio管理画面が利用でき、ライセンス費用はCore無料版の範囲内であれば発生しません*1*7。第二に、ライセンスはMSCL-1.0-GPLであり、内部利用は無償ですが競合サービスとしての提供には制限があります*3。第三に、Docker運用・権限設計・バックアップ運用には専門知識が必要であり、SSOや大規模利用への移行判断も含めて、構築・運用の実行は外部委託によってリスクを抑えやすくなります*4*5。
よくある質問
Directusは無料で商用利用できますか。
Core無料版であれば、ユーザー3席・コレクション25個・フロー5個までの範囲で商用利用できます*7。ライセンスはMSCL-1.0-GPLで、Monospace社の商用提供と競合する形での提供は制限されますが、自社の社内システムとして使う一般的な用途はこの制限に該当しません*3。
既存のデータベースをそのままAPI化できますか。
はい。Directusはデータベースへ接続するだけでREST/GraphQL APIを自動生成する設計です*1。新規にデータベースを作り直す必要はなく、既存のスキーマを活かしたまま社内データ基盤として利用できます。
対応しているデータベースの種類を教えてください。
PostgreSQL・MySQL・SQLite・MS SQL Server・MariaDB・CockroachDB・OracleDBの各LTSバージョンに対応しています*4。ただし1つのデータベース内で複数スキーマを併用する構成には対応していません*4。
Directusの構築にはどのくらいの専門知識が必要ですか。
Docker Composeでのコンテナ管理、SECRET等の環境変数設定、ボリュームによるデータ永続化、ロールベースの権限設計など複数分野の知識が求められます*5。サーバーは推奨最小構成で2vCPU・2GB程度を目安に準備する必要があります*4。
無料のCoreプランでどこまで使えますか。
ユーザー3席・コレクション25個・フロー5個までがCore無料版の上限で、SSOには対応していません*7。これを超える利用やSSO対応が必要な場合は、月額499ドルのTeamプラン以上への移行が必要になります*7。
著者：テレリモ総研編集部 鈴木 亮佑
ご不明な点はお問い合わせフォームからもご連絡いただけます。
- *1 出典：Directus公式ドキュメント「Introduction / Architecture」（https://directus.com/docs/getting-started/architecture）
- *2 出典：Directus公式GitHubリポジトリ（https://github.com/directus/directus）
- *3 出典：Directus公式GitHubリポジトリ「LICENSE」（https://github.com/directus/directus/blob/main/license）
- *4 出典：Directus公式ドキュメント「Self-Hosting: Requirements」（https://directus.com/docs/self-hosting/requirements）
- *5 出典：Directus公式ドキュメント「Self-Hosted: Docker Guide」（https://directus.com/docs/self-hosted/docker-guide.html）
- *6 出典：Directus公式ドキュメント「Create a Project」（https://directus.com/docs/getting-started/create-a-project）
- *7 出典：Directus公式サイト「Pricing」（https://directus.com/pricing/）
