こんにちは！データベースやAPIの設計現場を渡り歩いてきた先輩エンジニアの私です。
新しい開発現場に参加したとき、まず直面するのが「データベースとどう向き合うか」という問題です。黒い画面（CUI）の`psql`コマンドを愛する硬派なエンジニアもいますが、日々のデータ確認や複雑なクエリのチューニング、スキーマの視覚的な把握には、やっぱり信頼できるGUIクライアントが欠かせません。
その中でもPostgreSQL公式の管理ツールである「pgAdmin」は、多くの現場でデファクトスタンダードとして使われています。
しかし、ここで多くの人が最初に迷うポイントがあります。それが今回焦点を当てる「デスクトップモード」と「サーバモード（Webモード）の違い、そしてチーム開発における最適なアーキテクチャの選び方」です。
これを間違えると、「メンバー全員がバラバラに接続情報を管理してパスワードを紛失する」「退職者のPCから本番DBの接続情報が漏洩する」といった、セキュリティ上の悪夢を招くことになります。
今回は、pgAdminの本質を解き明かしながら、明日からのチーム開発を劇的に楽にする「正しい導入とセットアップの極意」を優しく、かつ徹底的に解説していきますね。
—
1. デスクトップモードとサーバモードの基本的な仕組みの違い
まずは、pgAdmin 4が持つ2つの顔、「デスクトップモード」と「サーバモード」のアーキテクチャの違いをクリアに理解しましょう。
言葉の響きから、「デスクトップ版＝軽量、サーバ版＝重厚長大」と思われがちですが、実は本質はそこではありません。
実は両方とも「Webアプリケーション」であるという真実
驚くかもしれませんが、pgAdmin 4はバージョン3以降、完全にPython（Flask）製のエンドツーエンドのWebアプリケーションとして再設計されています。
つまり、あなたが普段何気なく起動している「デスクトップ版」のpgAdminの中身も、実はあなたのローカルPC上でWebサーバー（Werkzeug）がひっそりと立ち上がり、ブラウザ（あるいはElectron）がそこにアクセスしているという構造になっています。
【デスクトップモードの仕組み】
[ あなたのPC ]
├─ pgAdmin Webサーバー (ローカル起動: 127.0.0.1)
└─ ブラウザ / Electron GUI ──(ローカル通信)──> pgAdminサーバー
デスクトップモードの特徴
- 対象: 個人開発、または少人数でのローカル開発
- メリット: インストールして即座に使える。設定が簡単。
- デメリット: 接続情報やクエリの履歴が「個人のPC内」に閉じ込められているため、チーム間で共有できない。PCが壊れたら設定が消える。
サーバモード（Webモード）の特徴
- 対象: 複数人のチーム開発、プロダクション環境、組織的な運用
- メリット: 接続情報、クエリ履歴、マクロなどをチーム全体で一元管理できる。アクセス制御（RBAC）が可能。
- デメリット: 初期セットアップ（DockerやLinuxサーバーへの配置、SSL、リバースプロキシ設定など）にインフラの知識が必要。
—
2. チーム開発における最適解：サーバモード（Docker）構築のメリット
「じゃあ、チーム開発ではどうすればいいの？」という話ですが、結論から言うと、Dockerを使ったサーバモードの構築が圧倒的な正解です。
これをマスターすれば、新人が入社したときに「このファイルを読んで`docker compose up`してね」と伝えるだけで、全員が全く同じデータベース接続環境と共通サーバーにアクセスできるようになります。個人のPC環境に依存しない、極めてクリーンな開発体験が手に入ります。
実践！ Docker Composeによるサーバモード構築
百聞は一見に如かず。チームで共有するためのpgAdminサーバモードを、Docker Composeを使ってサクッと立ち上げてみましょう。
以下の設定ファイルをプロジェクトの適当なディレクトリ（例: `pgadmin-server/`）に配置してください。
`docker-compose.yml`
version: ‘3.8’
services:
pgadmin:
image: dpage/pgadmin4:latest
container_name: shared_pgadmin_server
restart: always
environment:
# サーバモードとして起動するための必須設定
PGADMIN_DEFAULT_EMAIL: “admin@example.com” # 管理者ログイン用メールアドレス
PGADMIN_DEFAULT_PASSWORD: “SuperSecretPassword!” # 管理者パスワード（本番では必ず変更＆環境変数化）
PGADMIN_CONFIG_SERVER_MODE: ‘True’ # サーバモード（多ユーザー対応）を有効化
ports:
- “8080:80” # ホストの8080番をコンテナの80番にマッピング
volumes:
# 設定や接続情報を永続化するためのボリューム（消えないようにする）
- pgadmin_data:/var/lib/pgadmin
networks:
- db_net
volumes:
pgadmin_data:
driver: local
networks:
db_net:
driver: bridge
起動コマンド
たったこれだけのコマンドで、チーム共有のpgAdminサーバーが立ち上がります。
百聞は一見に如かず。バックグラウンドで起動
docker compose up -d
ブラウザで `http://localhost:8080` にアクセスし、設定したメールアドレスとパスワードでログインしてみてください。
見慣れたpgAdminの画面が立ち上がりますが、これはあなたのローカルPC専用ではなく、「サーバー上に浮いている、チーム全員がアクセス可能な共有基盤」の第一歩です。
—
3. セキュリティ面（認証・SSL設定）の注意点と運用コストの比較
サーバモードは非常に強力ですが、大きな力には大きな責任が伴います。特に「Web経由でデータベースの管理画面を公開する」わけですから、セキュリティの担保は絶対に避けて通れません。
ここを怠ると、ランサムウェアの標的になったり、開発環境のデータベースが全消去されるといった大惨事を引き起こします。
セキュリティ運用の鉄則
1. HTTPではなくHTTPS（SSL/TLS）の強制
- サーバモードの場合、ログインパスワードやデータベースの認証情報、流すクエリが平文でネットワークを流れる危険性があります。本番運用や社外からのアクセスの場合は、必ずNginxやTraefikなどのリバースプロキシを前段に置き、SSL証明書（Let’s Encryptなど）を適用してください。
2. デフォルトクレデンシャルの変更
- さきほどのコード例の `admin@example.com` やパスワードのまま絶対に社内・外のネットワークに公開しないでください。.envファイル等で外部化し、Gitの管理外に置くのが鉄則です。
3. アクセス元IPの制限（VPNやVPC内への配置）
- 可能であれば、インターネット上に直接公開せず、社内VPNやAWSのVPC内（プライベートサブネット）に配置し、踏み台サーバーや特定のIPからしかアクセスできないように制限するのが最も安全です。
どちらを選ぶべきか？コストとベネフィットの比較表
| 比較項目 | デスクトップモード | サーバモード (Docker/K8s) |
| :— | :— | :— |
| 導入の難易度 | 極めて低い（インストーラーをポチるだけ） | 中〜高（Docker、ネットワーク、SSLの知識が必要） |
| 接続情報の共有 | 不可能（各自がバラバラに管理） | 可能（サーバー側で一元管理・共有できる） |
| セキュリティ管理 | 個人のPC依存（リスクが分散するが管理不能） | 一元管理可能だが、脆弱性対策やSSL設定が必須 |
| バックアップ/移行 | PC買い替え時に設定が消えやすい | ボリュームをバックアップすれば容易 |
| チーム開発への適合 | ×（小規模・個人向け） | ◎（数名〜の大規模チーム向け） |
—
最後に：今すぐあなたの現場に合わせて選択しよう
ここまで、pgAdmin 4のデスクトップモードとサーバモードの裏側にある仕組みから、チーム開発におけるDockerを活用した実践的なアーキテクチャまでを解説してきました。
- 一人で黙々と開発するモックアップやローカル検証なら、迷わずデスクトップモードで手軽に始めてください。
- 複数人で一つのデータベースを触る、あるいは本番・ステージング環境を安全に管理したいのであれば、今回紹介したサーバモード（Docker構築）を導入しましょう。
これをマスターすれば、バラバラだった接続情報の管理から解放され、チーム全体の生産性が劇的に向上します。ぜひ、次回のプロジェクトや日々の開発環境の改善に役立ててくださいね。
あなたのエンジニアリングライフが、より快適でスリリングなものになりますように！