雲端開發與遠端開發

services:
  vibex-server:
    # 用移動通道標籤：rc 跟隨最新候選版，latest 跟隨最新穩定版；
    # 需要固定版本時再改成具體的版本號
    image: ghcr.io/vibex-ai/vibex-server:rc
    container_name: vibex-server
    # 伺服器重啟後自動拉起；配合下面的 healthcheck 使用
    restart: unless-stopped
    # 共享宿主機網路：容器裡的迴環地址就是宿主機的迴環地址，
    # 免去橋接網路下發布埠需要非迴環繫結（迴環模式會拒絕這種繫結）的麻煩
    network_mode: host
    environment:
      # 執行階段資料目錄：資料庫、伺服器身份、Agent 安裝都在這裡
      VIBEX_HOME: /data
      VIBEX_DB_PATH: /data/vibex.db
      # 只寫 127.0.0.1 的話，手機和別的電腦連不進來
      VIBEX_BIND_ADDR: 0.0.0.0:8765
      # lan = 允許區域網訪問；公網部署要改成 public 並配 HTTPS
      VIBEX_DEPLOYMENT_MODE: lan
      # 執行階段自己籤一張證書：客戶端從配對連線串裡拿到指紋，不用買證書
      VIBEX_TLS_MODE: pinned_certificate
      # 客戶端撥號的地址，埠必須和 VIBEX_BIND_ADDR 一致
      VIBEX_PUBLIC_HOST: 192.168.1.10:8765
      # 允許客戶端在哪些目錄裡挑專案，冒號分隔；下面第 4 步會用到
      VIBEX_WORKSPACE_ROOTS: /data:/data/repos
    volumes:
      # 唯一需要備份的卷：資料庫 + 伺服器身份（丟了要重新配對所有裝置）
      - vibex-data:/data
      # 你的程式碼目錄：掛進來之後，路徑還要寫進 VIBEX_WORKSPACE_ROOTS
      - /srv/repos:/data/repos        # 改成你想讓 Vibex 開啟的程式碼目錄
volumes:
  vibex-data:

docker compose up -d
docker logs vibex-server | grep -E 'pairing_(code|link)'

docker exec vibex-server vibex-server pairing-code

services:
  vibex-server:
    image: ghcr.io/vibex-ai/vibex-server:latest
    container_name: vibex-server
    restart: unless-stopped
    network_mode: host
    environment:
      # 只監聽本機，公網流量一律走 Caddy；8765 不對公網開放
      VIBEX_BIND_ADDR: 127.0.0.1:8765
      # 公網部署：沒有可信 HTTPS 會拒絕啟動
      VIBEX_DEPLOYMENT_MODE: public
      VIBEX_TLS_MODE: trusted_https_proxy
      # 讓限流按真實客戶端 IP 計算；只有反代終結 TLS 時才設 true
      VIBEX_TRUST_FORWARDED_HEADERS: "true"
      # 客戶端實際訪問的域名，配對連線串裡用的也是它
      VIBEX_PUBLIC_HOST: vibex.example.com
      # 只接受這些域名/來源的請求，必須和上面一致
      VIBEX_ALLOWED_HOSTS: vibex.example.com
      VIBEX_ALLOWED_ORIGINS: https://vibex.example.com
      # 允許客戶端挑選專案的目錄，冒號分隔
      VIBEX_WORKSPACE_ROOTS: /data:/data/repos
    volumes:
      # 唯一需要備份的卷：資料庫 + 伺服器身份
      - vibex-data:/data
      - /srv/repos:/data/repos

  # 反向代理：自動申請並續期證書，把 443 的請求轉到執行階段的迴環埠
  caddy:
    image: caddy:2-alpine
    container_name: vibex-caddy
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy-data:/data
      - caddy-config:/config

volumes:
  vibex-data:
  caddy-data:
  caddy-config:

vibex.example.com {
    reverse_proxy 127.0.0.1:8765
}

docker compose up -d
docker logs vibex-server | grep -E 'pairing_(code|link)'

services:
  relay-server:
    image: ghcr.io/vibex-ai/vibex-relay-server:rc
    container_name: vibex-relay-server
    restart: unless-stopped
    # 只把埠釋出到宿主機的迴環地址；公網入口交給 HTTPS 反代
    ports:
      - "127.0.0.1:9700:9700"
    environment:
      # 容器內監聽所有網絡卡，否則宿主機的埠轉發進不來
      VIBEX_RELAY_BIND_ADDR: 0.0.0.0:9700
      # 房間數、連線數、限流等上限都有預設值，需要時再按
      # 「環境變數參考」裡的 Relay 一節新增

docker compose up -d
curl -fsS http://127.0.0.1:9700/health