Introdução geral
O Grok-Mirror é um programa baseado no Implementação rápida sem servidor Site espelho doméstico do Grok3 O Grok Mirror Station foi criado para ser operável. Ele permite que os usuários implantem um quiosque Grok local com um clique via Docker. O Grok é um assistente de IA lançado pela xAI, e o Grok-Mirror permite que os usuários usem os recursos do Grok sem visitar o site oficial da xAI por meio da tecnologia de espelhamento. O projeto oferece suporte ao gerenciamento de vários usuários e fornece uma interface de API compatível com o formato OpenAI. Ele tem uma variedade de modelos Grok incorporados que os usuários podem executar localmente, eliminando as restrições de rede. Ele também oferece suporte à implementação rápida usando servidores Serv00 ociosos. Todo o processo é simples e adequado para indivíduos, equipes ou desenvolvedores.
Não há acesso direto no país Grok O Google está explorando esse problema para fornecer sites espelho do Grok. O projeto pode gerar dinheiro rapidamente por meio do Google Ads, bastando configurar as variáveis de sistema do GOOGLEADS. Cerca de 50 conjuntos de contas suportam constantemente 2.000 pessoas e geram 3 facas de receita por dia. Ou use esse método para atrair tráfego e ganhar dinheiro por conta própria.
Lista de funções
- Implementação com um clique: crie rapidamente quiosques Grok locais por meio do Docker ou do Serv00.
- Suporte a vários usuários: permite que várias pessoas usem ao mesmo tempo, e os administradores podem gerenciar contas e permissões.
- Interface API: Fornece
/v1/chat/completions
API de bate-papo, consistente com o formato OpenAI. - Opções de modelagem múltipla: suporte
grok-2
egrok-3
e muitos outros modelos. - Uso sem paredes: não há necessidade de depender de redes externas após a implantação local.
- Gerenciamento de tokens: suporte para inserir tokens SSO e até mesmo importar vários tokens em lote.
- Cache de dados: mecanismo de cache integrado para melhorar a velocidade de resposta.
- Chats ad hoc: a API oferece suporte a sessões ad hoc sem manutenção de registros.
Usando a Ajuda
Processo de instalação (método Docker)
O Grok-Mirror depende do Docker para ser executado por padrão; as etapas de instalação são as seguintes:
- Instalação do Docker
Certifique-se de que o Docker esteja instalado no seu dispositivo. Os usuários de Windows e Mac podem fazer o download do Docker Desktop e os usuários de Linux podem executá-lo:sudo apt update && sudo apt install docker.io -y
Verifique a versão:
docker --version
- Puxando espelhos
Digite-o no terminal:docker pull dairoot/grok-gateway:latest
Isso fará o download da versão mais recente da imagem do Grok-Mirror.
- Início dos serviços
Execute o seguinte comando para executar o contêiner:docker run --rm -p 50005:8080 -v grok_gateway_db:/app/.cache_data dairoot/grok-gateway:latest
-p 50005:8080
Mapeia a porta 8080 do contêiner para a porta local 50005.-v grok_gateway_db:/app/.cache_data
Armazenamento persistente de dados.
Após a inicialização, acesse ohttp://127.0.0.1:50005
Verifique se o serviço está em execução.
- Configuração do nome de domínio (opcional)
Se for necessário o acesso à extranet, consulte o processo completo de implementação para configurar o nome do domínio.
Tutorial de implantação rápida (abordagem Serv00)
Se você tiver um servidor Serv00 ocioso, poderá usá-lo para implementar rapidamente o Grok-Mirror:
I. Configuração no back-end do Serv00
- Configurar a porta
Faça login no backend do Serv00, acesse as configurações de "Firewall" e adicione uma porta personalizada (por exemplo50006
).
- Configuração de serviços da Web
Preencha o nome de domínio personalizado no back-end (por exemployourdomain.serv00.net
) e a porta que você acabou de criar para concluir a configuração do serviço da Web.
- Edição de serviços da Web
Clique no serviço da Web que você acabou de criar e selecioneManage -> Details
Entre no modo de edição e verifique se as configurações estão corretas.
Em segundo lugar, faça o download do programa Grok mirror station
Execute o seguinte comando no terminal Serv00 para fazer o download do programa Grok:
curl -L -o grok_gateway https://dairoot.cn/2025/03/06/serv00-grok/grok_gateway_freebsd_amd64
III. procedimentos operacionais
- autoridade de execução
Digite o comando:chmod +x grok_gateway
- Início dos serviços
Inicie o programa com uma porta personalizada, por exemplo, porta50006
::./grok_gateway -p 50006
IV. serviços de acesso
Após a conclusão da implantação, digite o nome de domínio personalizado em seu navegador (por exemplohttp://yourdomain.serv00.net:50006
) para acessar o serviço Grok.
Etapas de configuração
- Faça login no backstage
Acesse o endereço do serviço (por exemplohttp://127.0.0.1:50005
) para acessar a página de login. A senha padrão do administrador precisa ser passada por meio da variável de ambienteADMIN_PASSWORD
Configurações, por exemplo:docker run --rm -p 50005:8080 -e ADMIN_PASSWORD=yourpassword -v grok_gateway_db:/app/.cache_data dairoot/grok-gateway:latest
O método Serv00 acessa as configurações diretamente após o nome do domínio.
- Inserir o token Sso
Método Get Sso Token:- Faça logon no site da xAI (https://x.ai).
- Pressione F12 para abrir o Developer Tools e mude para a guia Network (Rede).
- Atualize a página e localize o
new-chat
para copiar o Sso Token no cookie. - Insira e salve no plano de fundo "Token Management". Há suporte para entrada em lote, veja mais adiante.
- função de teste
Quando a configuração estiver concluída, vá para a página inicial e digite o texto para testar o diálogo. Se o resultado for retornado, o serviço está normal.
Uso da API
O Grok-Mirror oferece suporte à API em/v1/chat/completions
.
- Solicitações básicas
Testado com 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": "你好!"}]}'
- Configuração da variável de ambiente
Isso pode ser feito por meio da variável de ambienteAUTHORIZATION
Defina o token:docker run --rm -p 50005:8080 -e AUTHORIZATION=YourSsoToken -v grok_gateway_db:/app/.cache_data dairoot/grok-gateway:latest
- Modelos de suporte
Suporte à APIgrok-2
egrok-3
e outros modelos, especifiquemodel
Troca de parâmetros.
Operação da função em destaque
- Entrada de token de lote
invocações/api/batch-add-grok-token
Interface: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"]}'
- interface de login
- Login geral:
curl -X POST "http://127.0.0.1:50005/api/login" \ -H "Content-Type: application/json" \ -d '{"user_name": "test", "email_md5": "md5value"}'
- Login V2 (com 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"}'
- Obter lista Grok
Veja as instâncias disponíveis:curl -X POST "http://127.0.0.1:50005/api/get-grok-list" \ -H "Content-Type: application/json" \ -d '{"page": "1", "page_size": "10"}'
variável do sistema
As seguintes variáveis de ambiente são compatíveis com o Grok-Mirror para a configuração de serviços personalizados. Essas variáveis podem ser configuradas ao iniciar um contêiner do Docker ou um aplicativo Serv00 por meio do comando-e
é passado, por exemplo.docker run -e 变量名=值
.
categorização | nome da variável | tipologia | valor padrão | descrições |
---|---|---|---|---|
Relacionado à API | ADMIN_PASSWORD |
String |
None |
Senha para acessar o backend de administração. Você precisa especificá-la manualmente se não estiver definida; caso contrário, não será possível fazer login no backend. |
AUTHORIZATION |
String |
None |
Chave de acesso à API para pesquisar uma lista de Token Sso de várias contas. Recomenda-se definir isso para gerenciar automaticamente o token. | |
ENABLE_MIRROR_API |
Boolean |
true |
Se deve habilitar o acesso à API. Definir comofalse encerrar/v1/chat/completions Interface. |
|
MIRROR_API_PREFIX |
String |
None |
Prefixo de acesso à API, por exemplo, definido comoapi Depois disso, a interface muda para/api/v1/chat/completions . Recomenda-se a configuração para diferenciar os caminhos. |
|
API_HATD |
Boolean |
true |
Se deve ativar o modo de bate-papo temporário. A API não salva os registros de bate-papo quando ativada, o que é adequado para testes ou necessidades de privacidade. | |
variável do sistema | PROXY_URL_POOL |
String |
None |
Links de pool de proxy com vários proxies separados por vírgulas. O formato é o seguintehttp://username:password@ip:port . |
HOST |
String |
None |
Endereço de domínio de serviço para funções como imagens de retorno de API. Por exemplohttps://example.com . |
|
GOOGLEADS |
String |
None |
Código de publicidade do Google Adsense para incorporar anúncios em uma página. |
exemplo de uso
- Configurando variáveis do jeito Docker
Adicione a variável de ambiente ao iniciar o contêiner:
docker run --rm -p 50005:8080
-e ADMIN_PASSWORD=yourpassword
-e AUTHORIZATION=YourSsoToken
-v grok_gateway_db:/app/.cache_data
dairoot/grok-gateway:latest
- Configuração de variáveis no modo Serv00
Antes de executar o programa, exporte as variáveis por meio do terminal:
export ADMIN_PASSWORD=yourpassword
export AUTHORIZATION=YourSsoToken
./grok_gateway -p 50006
cenário do aplicativo
- Assistente Pessoal de Aprendizagem
Após a implementação do Grok-Mirror, os usuários podem fazer perguntas e obter respostas para seus conhecimentos a qualquer momento, sem a necessidade de acesso à Internet para o xAI. - Ferramentas de IA da equipe
As equipes compartilham um único quiosque Grok local com recursos de gerenciamento multiusuário para melhorar a eficiência da colaboração. - Desenvolvimento de plataformas de teste
Os desenvolvedores usam interfaces de API para testar a funcionalidade da IA, desenvolver novos aplicativos ou integrar sistemas existentes.
QA
- O Grok-Mirror é gratuito?
O projeto em si é gratuito e de código aberto, mas requer uma conta xAI Grok e um Sso Token. - Por que a solicitação de API falhou?
sondaAuthorization
esteja correto, talvez o token esteja expirado ou não esteja configurado. - Quais são os modelos suportados?
apoiar algogrok-2
egrok-3
e muitos outros modelos, dependendo do retorno da API.