必须使用gorkproxy转换协议并用docker compose统一编排,配置两组有效cookie,openwebui通过http://gorkproxy:3000/v1对接,python后端为可选中间件,最后docker compose up -d启动全部服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让OpenWebUI前端、Python后端服务和Grok V3模型三者协同工作,必须解决协议不兼容与网络隔离问题。GorkProxy作为转换层必不可少,而Docker Compose能统一编排这三类服务,避免手动启停错乱、端口冲突或容器间无法通信。
准备Grok账号Cookie与基础环境
打开Chrome或Edge浏览器,登录x.ai官网,进入开发者工具(F12)→ Application → Cookies,复制__Host-sid和__Host-xsrf两行值。每组Cookie有效期约7天,【务必保存至少2组,且用无痕窗口获取,防止主账号会话被污染】。
确认已安装Docker Desktop 4.35+或Docker Engine 25.0+与Docker Compose v2.28+。执行docker compose version验证输出含v2.28字样。
构建GorkProxy代理服务
创建项目根目录grok-stack/,在其中新建docker-compose.yml,粘贴以下内容:
services: gorkproxy: image: ghcr.io/roboflow/gorkproxy:latest ports: ["3001:3000"] environment: - GROK_COOKIE_1=__Host-sid=abc...; __Host-xsrf=def... - GROK_COOKIE_2=__Host-sid=xyz...; __Host-xsrf=uvw... - LOG_LEVEL=info restart: unless-stopped
将上一步复制的两组Cookie分别填入GROK_COOKIE_1和GROK_COOKIE_2的值中,注意保留分号与空格。若只填一组,服务启动后会因轮换失败而中断请求。
接入OpenWebUI前端
方法一:直接复用官方镜像
在docker-compose.yml的services:下新增如下配置:
openwebui: image: ghcr.io/open-webui/open-webui:main ports: ["3000:8080"] environment: - WEBUI_URL=http://localhost:3000 - OPENAI_API_BASE_URL=http://gorkproxy:3000/v1 depends_on: [gorkproxy] restart: unless-stopped
注意OPENAI_API_BASE_URL必须写成http://gorkproxy:3000/v1——容器内通过服务名通信,不能用localhost或宿主机IP。
部署Python后端(可选增强层)
第一步:在项目根目录新建backend/文件夹,放入app.py与requirements.txt。
第二步:编写backend/Dockerfile:
FROM python:3.11-slimWORKDIR /appCOPY requirements.txt .RUN pip install --no-cache-dir -r requirements.txtCOPY app.py .EXPOSE 8000CMD ["uvicorn", "app:app", "--host", "0.0.0.0:8000", "--reload"]
第三步:在docker-compose.yml中追加服务定义:
backend: build: ./backend ports: ["8000:8000"] environment: - GORKPROXY_URL=http://gorkproxy:3000 depends_on: [gorkproxy]
这一步不是必须项,但当你需要在请求到达Grok前做鉴权、日志审计或参数改写时,该后端将成为关键中间件。
一键拉起全部服务
确保当前路径为grok-stack/,执行:docker compose up -d。
等待约20秒,运行docker compose ps,确认gorkproxy、openwebui(及backend,如启用)状态均为running。
打开浏览器访问http://localhost:3000,输入任意提示词,观察响应头中X-Grok-Model字段是否返回grok-v3。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!








