综合介绍
Grok-Mirror是一个基于 无服务器快速部署Grok3国内镜像站 构建的可经营的Grok镜像站。它让用户可以通过Docker一键部署本地Grok服务站。Grok是xAI公司推出的人工智能助手,而Grok-Mirror通过镜像技术,让用户无需访问xAI官网就能使用Grok的功能。项目支持多用户管理,提供与OpenAI格式兼容的API接口。它内置多种Grok模型,用户可以本地运行,免除网络限制。此外,还支持利用闲置的Serv00服务器快速部署。整个过程简单,适合个人、团队或开发者使用。
国内无法直接访问 Grok ,利用这一问题提供Grok镜像站。该项目可以快速通过谷歌广告变现,只需要配置GOOGLEADS系统变量。大约50组账号稳定支撑2000人,每天赚取3刀收益。或利用此方法自行引流变现。
功能列表
- 一键部署:通过Docker或Serv00快速搭建本地Grok服务站。
- 多用户支持:允许多人同时使用,管理员可管理账号和权限。
- API接口:提供
/v1/chat/completions
聊天API,与OpenAI格式一致。 - 多模型选择:支持
grok-2
、grok-3
等多种模型。 - 免翻墙使用:本地部署后无需依赖外部网络。
- Token管理:支持录入Sso Token,甚至批量导入多个Token。
- 数据缓存:内置缓存机制,提升响应速度。
- 临时聊天:API支持不保存记录的临时会话。
使用帮助
安装流程(Docker方式)
Grok-Mirror默认依赖Docker运行,安装步骤如下:
- 安装Docker
确保设备已安装Docker。Windows和Mac用户可下载Docker Desktop,Linux用户运行:sudo apt update && sudo apt install docker.io -y
检查版本:
docker --version
- 拉取镜像
在终端输入:docker pull dairoot/grok-gateway:latest
这会下载最新版本的Grok-Mirror镜像。
- 启动服务
执行以下命令运行容器:docker run --rm -p 50005:8080 -v grok_gateway_db:/app/.cache_data dairoot/grok-gateway:latest
-p 50005:8080
:将容器8080端口映射到本地50005端口。-v grok_gateway_db:/app/.cache_data
:持久化存储数据。
启动后,访问http://127.0.0.1:50005
查看服务是否运行。
- 域名配置(可选)
如果需要外网访问,可参考完整部署流程配置域名。
快速部署教程(Serv00方式)
如果有闲置的Serv00服务器,可以利用它快速部署Grok-Mirror。以下是详细步骤:
一、在Serv00后台进行配置
- 配置端口
登录Serv00后台,进入“防火墙”设置,添加一个自定义端口(如50006
)。
- 配置Web服务
在后台填写自定义域名(例如yourdomain.serv00.net
)和刚刚创建的端口,完成Web服务设置。
- 编辑Web服务
点击刚创建的Web服务,选择Manage -> Details
,进入编辑模式,确保设置正确。
二、下载Grok镜像站程序
在Serv00终端运行以下命令,下载Grok程序:
curl -L -o grok_gateway https://dairoot.cn/2025/03/06/serv00-grok/grok_gateway_freebsd_amd64
三、运行程序
- 赋予执行权限
输入命令:chmod +x grok_gateway
- 启动服务
用自定义端口启动程序,例如端口为50006
:./grok_gateway -p 50006
四、访问服务
部署完成后,在浏览器输入自定义域名(如http://yourdomain.serv00.net:50006
)即可访问Grok服务。
配置步骤
- 登录后台
访问服务地址(如http://127.0.0.1:50005
),进入登录页面。默认管理员密码需通过环境变量ADMIN_PASSWORD
设置,例如:docker run --rm -p 50005:8080 -e ADMIN_PASSWORD=yourpassword -v grok_gateway_db:/app/.cache_data dairoot/grok-gateway:latest
Serv00方式则直接访问域名后设置。
- 录入Sso Token
获取Sso Token方法:- 登录xAI官网(https://x.ai)。
- 按F12打开开发者工具,切换到“网络”选项卡。
- 刷新页面,找到
new-chat
请求,复制Cookie中的Sso Token。 - 在后台“Token管理”中输入并保存。支持批量录入,见后文。
- 测试功能
配置完成后,进入首页,输入文字测试对话。如果返回结果,说明服务正常。
API使用
Grok-Mirror提供API支持,地址为/v1/chat/completions
。
- 基本请求
用cURL测试:curl --location "http://127.0.0.1:50005/v1/chat/completions" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer YourSsoToken" \ --data '{"model": "grok-2", "messages": [{"role": "user", "content": "你好!"}]}'
- 环境变量配置
可通过环境变量AUTHORIZATION
设置Token:docker run --rm -p 50005:8080 -e AUTHORIZATION=YourSsoToken -v grok_gateway_db:/app/.cache_data dairoot/grok-gateway:latest
- 支持模型
API支持grok-2
、grok-3
等多种模型,指定model
参数切换。
特色功能操作
- 批量录入Token
调用/api/batch-add-grok-token
接口:curl -X POST "http://127.0.0.1:50005/api/batch-add-grok-token" \ -H "Content-Type: application/json" \ -d '{"sso_token_list": ["token1", "token2"]}'
- 登录接口
- 普通登录:
curl -X POST "http://127.0.0.1:50005/api/login" \ -H "Content-Type: application/json" \ -d '{"user_name": "test", "email_md5": "md5value"}'
- V2登录(带Token):
curl -X POST "http://127.0.0.1:50005/api/login-v2" \ -H "Content-Type: application/json" \ -d '{"user_name": "test", "sso_token": "YourSsoToken"}'
- 获取Grok列表
查看可用实例:curl -X POST "http://127.0.0.1:50005/api/get-grok-list" \ -H "Content-Type: application/json" \ -d '{"page": "1", "page_size": "10"}'
系统变量
以下是Grok-Mirror支持的环境变量,用于自定义服务配置。这些变量可以在启动Docker容器或Serv00程序时通过-e
参数传入,例如docker run -e 变量名=值
。
分类 | 变量名 | 类型 | 默认值 | 描述 |
---|---|---|---|---|
API相关 | ADMIN_PASSWORD |
String |
None |
管理后台访问密码。未设置时需手动指定,否则无法登录后台。 |
AUTHORIZATION |
String |
None |
API访问密钥,用于轮询多账号Sso Token列表。建议设置以自动管理Token。 | |
ENABLE_MIRROR_API |
Boolean |
true |
是否开启API访问。设为false 时关闭/v1/chat/completions 接口。 |
|
MIRROR_API_PREFIX |
String |
None |
API访问前缀,例如设为api 后,接口变为/api/v1/chat/completions 。建议配置以区分路径。 |
|
API_HATD |
Boolean |
true |
是否开启临时聊天模式。启用后API不保存聊天记录,适合测试或隐私需求。 | |
系统变量 | PROXY_URL_POOL |
String |
None |
代理池链接,多个代理用逗号分隔。格式如http://username:password@ip:port 。 |
HOST |
String |
None |
服务域名地址,用于API返回图片等功能。例如https://example.com 。 |
|
GOOGLEADS |
String |
None |
Google Adsense广告代码,用于在页面嵌入广告。 |
使用示例
- Docker方式设置变量
启动容器时加入环境变量:
docker run --rm -p 50005:8080
-e ADMIN_PASSWORD=yourpassword
-e AUTHORIZATION=YourSsoToken
-v grok_gateway_db:/app/.cache_data
dairoot/grok-gateway:latest
- Serv00方式设置变量
在运行程序前,通过终端export变量:
export ADMIN_PASSWORD=yourpassword
export AUTHORIZATION=YourSsoToken
./grok_gateway -p 50006
应用场景
- 个人学习助手
用户部署Grok-Mirror后,可以随时提问,获取知识解答,无需联网访问xAI。 - 团队AI工具
团队通过多用户管理功能,共享一个本地Grok服务站,提升协作效率。 - 开发测试平台
开发者用API接口测试AI功能,开发新应用或集成现有系统。
QA
- Grok-Mirror免费吗?
项目本身免费开源,但需要xAI的Grok账号和Sso Token。 - 为什么API请求失败?
检查Authorization
是否正确,可能Token过期或未配置。 - 支持哪些模型?
支持grok-2
、grok-3
等多种模型,具体以API返回为准。