vpnGrok 将 xAI 的 Grok CLI 运行在 Docker 容器中,容器的所有网络流量都通过 gluetun VPN 隧道传输,提供了杀开关机制和一个便捷的包装命令,可在任何项目目录下使用。

Stars

10

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

MIT

最近更新

2026-07-11

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它通过简洁的 Docker Compose 设置同时解决了 Grok 的地区限制和真实 IP 泄露风险,支持 40+ VPN 提供商,并包含杀开关验证步骤。

适合谁使用

  • Grok 不可用地区的开发者
  • 希望 VPN 保障流量的注重隐私的 Grok 用户
  • 寻求整洁隔离模式的 Docker 和 Docker Compose 用户
  • 希望从任意项目目录运行 Grok 的 CLI 工具用户

典型使用场景

  • 在 WORKSPACE_ROOT 下的任意项目中运行 Grok,无需手动配置 VPN
  • 从限制地区安全访问 Grok,所有流量经 VPN 路由
  • 在原生环境和容器化环境之间共享 Grok 会话和技能
  • 通过停止 VPN 容器并确认网络丢失来验证杀开关功能

项目优势

  • 杀开关机制确保 VPN 隧道断开时开发容器完全断网,防止 IP 泄露
  • 通过 gluetun 支持 40+ VPN 提供商,切换仅需修改 .env 文件
  • 限定的工作区挂载(WORKSPACE_ROOT)将容器访问限制在项目目录内,降低了攻击面
  • 通过绑定挂载与会话和技能与宿主机共享,实现原生与容器运行间的无缝 /resume

使用前须知

  • `vpngrok` 命令仅在 WORKSPACE_ROOT 内有效;需要挂载更大目录时需手动权衡,可能触发 Docker Desktop 警告
  • 首次运行需要手动登录(浏览器流程或 XAI_API_KEY);Mullvad 的密钥轮换会导致凭据在重新生成配置后失效
  • 所有项目共享一个容器、一个 Grok 登录和一个 VPN 出口服务器——没有项目级隔离

README 快速开始

Usage

项目描述

Run xAI's Grok CLI from any project, with all traffic routed through a VPN (Docker + gluetun, Mullvad by default)

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

bjan
精选
bjan GitHub avatar

claudemux

Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

AI 与机器学习AI 智能体
9
S40911120
精选
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI 与机器学习大语言模型
67
PromptPartner
PromptPartner GitHub avatar

agentsmith

AgentSmith is a portable, battle-tested operating system for AI coding agents that provides disciplined rules, tools, memory, and feedback loops to turn vibe-coded demos into production-grade software.

Shell
255