3.7 KiB

Raw Blame History

🐳 Synology NAS 構築ガイド (Phase 2A: AI Factory Setup)

このドキュメントは、「Ponshu Room」開発環境をSynology NAS上に構築するための手順書です。 共同開発者（インフラ担当）向け の内容となっています。

🎯 目標 (Phase 2A)

Gitea の構築（ローカルGitサーバー）
PostgreSQL の構築（Gitea用DB）
MCP Server の枠組み構築（AIエージェント接続用）

🛠️ 事前準備 (Prerequisites)

以下のアプリがSynology NASにインストールされていることを確認してください。

Container Manager (旧 Docker)
Text Editor (設定ファイル修正用)
File Station

📂 デプロイ手順

Step 1: ファイルの配置

File Stationを使用し、以下のディレクトリ構造を作成・配置してください。推奨パス: /docker/ponshu_factory

/docker/ponshu_factory/
├── docker-compose.yml  <-- リポジトリ内の tools/synology/docker-compose.yml をコピー
├── gitea/              <-- 自動作成されます（空でOK）
├── postgres/           <-- 自動作成されます（空でOK）
└── mcp/                <-- 自動作成されます（空でOK）

Step 2: docker-compose.yml の確認

docker-compose.yml を開き、以下の環境変数を必要に応じて変更してください。特にパスワードは強固なものに変更することを推奨します。

services:
  gitea:
    environment:
       - GITEA__database__PASSWD=your_secure_password # <--- 変更推奨
  
  db:
    environment:
       - POSTGRES_PASSWORD=your_secure_password       # <--- Giteaと同じにする

Step 3: コンテナの起動

Synology Container Manager を開きます。

プロジェクト タブを選択
作成ボタンをクリック
プロジェクト名: ponshu_factory
パス: /docker/ponshu_factory を選択
「docker-compose.ymlを使用してプロジェクトを作成」 を選択し、次へ
設定を確認して完了をクリック

Step 4: 初期設定 (Gitea)

コンテナ起動後、ブラウザで以下にアクセスします。 http://[NASのIPアドレス]:3000

初期設定画面が表示されます。
データベース設定:
- タイプ: PostgreSQL
- ホスト: db:5432
- ユーザー: gitea
- パスワード: (Step 2で設定したもの)
- データベース名: gitea
一般設定:
- SSHサーバーのドメイン: [NASのIPアドレス]
- GiteaのベースURL: http://[NASのIPアドレス]:3000/
管理者アカウントの設定:
- 任意の管理者ユーザーを作成してください（例: admin）。
「Giteaをインストール」 をクリック。

🔒 外部アクセス設定 (Phase 2B準拠)

現在の構成はローカルネットワーク内のみアクセス可能です。外部（開発者のPC）から安全にアクセスするため、Cloudflare Tunnel の導入を推奨します。

推奨設定 (Cloudflare Tunnel)

Synology上で cloudflared コンテナを追加（または既存のTunnelを使用）。
Tunnel設定で以下をマッピング:
- git.ponshu.room -> http://gitea:3000

🤝 開発フローへの接続

環境構築が完了したら、以下の情報を開発者（Ponshu Roomチーム）に共有してください。

Gitea URL: (例: http://192.168.1.50:3000 またはTunnel URL)
管理者アカウント情報: (安全なチャネルで共有)

これで「AI工場」の基盤は完成です！🚀

3.7 KiB Raw Blame History Unescape Escape