Fabric Docker

🚀 🧠 Fabric Docker

Fabric Docker 是一個一體化的 Docker 部署方案，用於 Fabric 這個具備 Web UI、REST API 和 MCP 服務器的 AI 增強框架。它能幫助用戶快速搭建並使用 Fabric 相關服務。

✨ 主要特性

🚀 快速開始

# 克隆倉庫
git clone https://github.com/neosun100/fabric-docker.git
cd fabric-docker

# 複製環境文件
cp .env.example .env

# 使用 Docker Compose 啟動
docker compose up -d

# 訪問服務
# Web UI:    http://localhost:5173
# REST API:  http://localhost:8180
# Swagger:   http://localhost:8180/swagger/index.html
# MCP:       http://localhost:8181

📦 安裝指南

前提條件

• Docker 20.10 及以上版本
• Docker Compose 2.0 及以上版本
• 至少一個 AI 提供商的 API 密鑰（如 OpenAI、Anthropic 等）

方法 1：使用 Docker Compose（推薦）

1. 克隆倉庫

   git clone https://github.com/neosun100/fabric-docker.git
   cd fabric-docker
   

2. 配置環境

   cp .env.example .env
   # 編輯 .env 文件並添加你的 API 密鑰
   

3. 啟動服務

   docker compose up -d
   

4. 驗證部署

   # 檢查容器健康狀態
   docker ps
   
   # 測試 API
   curl http://localhost:8180/patterns/names
   

方法 2：使用 Docker Run

# 拉取或構建鏡像
docker build -t fabric:latest .

# 運行容器
docker run -d \
  --name fabric \
  -p 5173:8080 \
  -p 8180:8180 \
  -p 8181:8181 \
  -e OPENAI_API_KEY=your-key-here \
  -e ANTHROPIC_API_KEY=your-key-here \
  -v fabric-config:/root/.config/fabric \
  fabric:latest

⚙️ 配置

環境變量

docker-compose.yml

services:
  fabric:
    build:
      context: .
      dockerfile: Dockerfile
    image: neosun/fabric:latest
    container_name: fabric
    restart: unless-stopped
    ports:
      - "5173:8080"    # Web UI
      - "8180:8180"    # REST API
      - "8181:8181"    # MCP Server
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-}
      - DEFAULT_MODEL=gpt-4o
    volumes:
      - fabric-config:/root/.config/fabric
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8180/patterns/names"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  fabric-config:

💻 使用示例

Web UI

訪問 http://localhost:5173 上的 Web 界面：

• 瀏覽和搜索 233+ 種模式
• 使用自定義輸入執行模式
• 管理上下文和會話
• 即時聊天界面

REST API

# 列出所有模式
curl http://localhost:8180/patterns/names

# 獲取特定模式
curl http://localhost:8180/patterns/summarize

# 檢查模式是否存在
curl http://localhost:8180/patterns/exists/summarize

# 獲取可用模型
curl http://localhost:8180/models/names

# 獲取配置
curl http://localhost:8180/config

# 獲取策略
curl http://localhost:8180/strategies

API 端點

MCP 集成

MCP 服務器使 AI 助手（如 Claude Desktop）能夠直接使用 Fabric 模式。

在你的 MCP 客戶端中進行配置：

{
  "mcpServers": {
    "fabric": {
      "url": "http://localhost:8181"
    }
  }
}

🏗️ 架構

┌─────────────────────────────────────────────────────────┐
│                    Docker 容器                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │   Web UI    │  │  REST API   │  │ MCP 服務器  │     │
│  │   (Node)    │  │   (Go)      │  │  (Python)   │     │
│  │   :8080     │  │   :8180     │  │   :8181     │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│         │                │                │             │
│         └────────────────┼────────────────┘             │
│                          │                              │
│              ┌───────────┴───────────┐                  │
│              │    Fabric 核心        │                  │
│              │  (233+ 模式)          │                  │
│              └───────────────────────┘                  │
└─────────────────────────────────────────────────────────┘
         │              │              │
    端口 5173      端口 8180      端口 8181

🔧 技術細節

📁 項目結構

fabric-docker/
├── Dockerfile              # 多階段構建
├── docker-compose.yml      # Compose 配置
├── docker/
│   ├── entrypoint.sh      # 容器入口點
│   ├── supervisord.conf   # 進程管理器配置
│   ├── mcp_server.py      # MCP 服務器實現
│   └── nginx.conf         # Nginx 配置（可選）
├── data/
│   ├── patterns/          # 233+ AI 模式
│   └── strategies/        # 提示策略
├── web/                   # Svelte Web UI
├── cmd/                   # Go 命令
├── internal/              # Go 內部包
└── docs/                  # 文檔

🔧 故障排除

容器顯示 "unhealthy"

# 查看日誌
docker logs fabric

# 重啟 fabric-api 服務
docker exec fabric supervisorctl restart fabric-api

# 驗證端口
docker exec fabric netstat -tlnp

API 無響應

# 檢查服務是否正在運行
docker exec fabric supervisorctl status

# 手動重啟
docker compose restart

端口衝突

編輯 .env 文件以更改端口映射：

PORT=8280
WEB_PORT=5273
MCP_PORT=8281

🤝 貢獻

歡迎貢獻！請隨時提交拉取請求。

1. 分叉倉庫
2. 創建你的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打開拉取請求

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

🙏 致謝

• Fabric - 原始的 AI 增強框架
• Daniel Miessler - Fabric 的創建者

⭐ 星標歷史

📱 關注我