云端开发与远程开发

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