Baseado em painéis do Docker e Pagoda: um guia detalhado para a implantação privada do Coze Studio Open Source Edition

Recentemente, a plataforma de desenvolvimento de aplicativos de IA Coze anunciou o open-sourcing oficial de seu Studio trazendo um marco importante para a comunidade de desenvolvedores. Essa iniciativa significa que os desenvolvedores podem implementar de forma privada o kit de desenvolvimento Visual Intelligentsia (Agent) da Coze para criar e gerenciar aplicativos de IA com segurança de dados e estabilidade de versão.

Para empresas e desenvolvedores, as implementações localizadas abordam um ponto problemático central que há muito tempo depende dos serviços de nuvem. Interrupções inesperadas que podem ser acionadas por iterações de versões da plataforma de nuvem ou ajustes de plugins são riscos significativos para os projetos entregues. As versões de código aberto, por outro lado, dão às equipes de desenvolvimento controle total e garantem fluxos de trabalho estáveis ao longo do tempo.

Este tutorial detalhará como fazer isso em um servidor em nuvem Estúdio Coze de implantação localizada. Todo o processo segue uma ilustração passo a passo projetada para ser praticada com sucesso por desenvolvedores de todos os níveis de experiência.

Tempo estimado de conclusão: aproximadamente 25 minutos
Pré-requisitos técnicos: familiaridade com operações básicas de linha de comando do Linux e compreensão dos conceitos do Docker.

Visão geral do processo de implantação:

1. Preparação de servidores em nuvem
2. Configuração do ambiente do servidor
3. implementações Estúdio Coze
4. Obtenção e configuração da chave da API de modelo
5. Iniciar e acessar o Coze Studio

I. Preparação dos servidores em nuvem

A implementação do Coze Studio requer pelo menos um 4G de 2 núcleos Servidores em nuvem configurados.

1. Escolha e registre-se em um provedor de serviços em nuvem. No caso dos servidores de aplicativos leves da Tencent Cloud, por exemplo, os novos usuários geralmente têm direito a um crédito de avaliação gratuita.
2. Vá para o Console do provedor de serviços e selecione Purchase Server (Comprar servidor). Nas opções de configuração, a imagem (Image) é recomendada para escolher um servidor com o Painel Linux Pagoda 8.1.0 Isso simplifica a configuração subsequente do ambiente. A região pode ser selecionada com base na velocidade de acesso.

3. Depois de criar uma instância, localize a função "Login" ou "Terminal" na página de administração do servidor e entre na interface de linha de comando do servidor.

4. Depois de fazer login, execute o seguinte comando para alterar a porta padrão do Pagoda Panel (de 8888 para 8887) para evitar conflito com a porta padrão do Coze.

   echo "8887" > /www/server/panel/data/port.pl
   sudo /etc/init.d/bt default
   

   Após a execução, o terminal exibirá o novo endereço de acesso ao painel, o nome de usuário e a senha; certifique-se de copiar e salvar essas informações corretamente.

   

5. Em seguida, você precisa configurar as regras de firewall do servidor para abrir as portas exigidas pelo Coze Studio. Vá para a página de configurações do firewall ou do grupo de segurança do servidor, adicione a regra e libere-a 8887 responder cantando 9999 Duas portas.

II. Configuração do ambiente do servidor

1. Abra o Pagoda Panel em seu navegador usando o "Extranet Panel Address" que você salvou anteriormente. Se o endereço começar com login não pode ser aberto, tente alterar o sufixo do URL para tencentcloud.

2. Digite seu nome de usuário e senha salvos para fazer login. Na primeira vez em que fizer login, você precisará vincular uma conta oficial do Pagoda.

3. Após o login, será exibida uma janela pop-up com os pacotes recomendados, portanto, marque e instale o primeiro! Nginxe o restante desmarcado.

4. Localize e clique em "Software Store" no menu esquerdo do Pagoda Panel e selecione "App Categories". Gerenciador do Docker e instalá-lo. O processo de instalação pode levar algum tempo.

5. Quando a instalação for concluída, atualize a página. Abra a ferramenta "Terminal" no lado esquerdo e execute o seguinte comando para verificar Docker responder cantando Docker Compose Se a instalação foi bem-sucedida ou não. Se você puder ver a saída do número da versão, o ambiente está pronto.

   docker -v
   docker-compose -v
   

   

Implementação do Coze Studio

1. No painel Pagoda, vá para File Management e localize o arquivo /home crie um novo diretório chamado Coze da pasta.

2. Vá para o recém-criado Coze clique no botão "Terminal" na parte superior para abrir uma nova janela de terminal. Execute o seguinte git Comando Clone Coze Studio repositório de código-fonte.

   git clone https://github.com/coze-dev/coze-studio.git
   

   

   Programa alternativoSe um problema de rede causar git clone Com ou sem lentidão, você pode visitar diretamente Endereço do repositório do GitHub Faça o download do arquivo ZIP e carregue-o na pasta /home/Coze e descompacte-o.

   

   

Obtenção e configuração da chave da API de modelo

Coze Studio Um modelo de linguagem grande precisa ser conectado para ser executado. O tutorial usa o serviço de modelo Ark do Volcano Engine como exemplo para demonstrar como obter o API Key e pontos de acesso modelo Endpoint ID.

4.1 Obtenção de credenciais de modelo do Volcano Engine

1. Acesso e login motor de vulcão Console, vá para a plataforma de modelagem Ark.

2. Selecione "Online Reasoning" (Raciocínio on-line) no menu à esquerda e clique em "Create Reasoning Access Point" (Criar ponto de acesso de raciocínio).

3. Nomear o ponto de acesso (por exemplo DeepSeek-R1) e selecione um modelo básico, como o deepseek-v2Se for solicitado que o modelo não esteja aberto, siga as orientações para concluir o processo. Se for solicitado que o modelo não esteja aberto, siga as orientações para concluir a abertura (sem custo).

4. Após a criação bem-sucedida, localize o ponto de acesso que você acabou de criar na lista."ID do ponto de acesso" (ID do endpoint), que é necessário para as configurações subsequentes. model. Por favor, copie e salve.

5. Clique no botão "API Call" à direita do ponto de acesso e, em seguida, selecione ou crie uma API Key.

6. fazer uma cópia de Access Key ID responder cantando Secret Access Key.Secret Access Key Ele aparecerá apenas uma vez, portanto, não deixe de salvá-lo imediatamente. Aqui está Secret Access Key que é necessário para as configurações subsequentes do api_key.

4.2 Configuração dos arquivos de modelo do Coze Studio

1. Volte ao painel do pagode e digite /home/Coze/coze-studio clique em Terminal na parte superior e execute o seguinte comando para fazer uma cópia do modelo de perfil de modelo.

   cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml
   

   

2. Usando o editor de arquivos do Pagoda, abra o arquivo ark_doubao-seed-1.6.yaml Documentação.

   Caminho:/home/Coze/coze-studio/backend/conf/model/ark_doubao-seed-1.6.yaml

   

3. Modifique três campos no arquivo:
   • idIdentificador exclusivo do modelo, que deve ser um número inteiro diferente de zero. Por exemplo, um valor definido como 888. Não o modifique depois que ele for publicado.
   • meta.conn_config.api_keyColar o Volcano Engine salvo anteriormente Chave de acesso secreta.
   • meta.conn_config.modelColar o Volcano Engine salvo anteriormente ID do ponto de acesso (ID do ponto de extremidade).

   
   

4. Depois de confirmar que as alterações estão corretas, salve o arquivo.

V. Lançamento e acesso ao Coze Studio

1. retornar para /home/Coze/coze-studio e abra o terminal novamente. Execute os seguintes comandos para entrar no diretório docker criar arquivos de variáveis de ambiente e iniciar todos os serviços.

   cd docker
   cp .env.example .env
   docker compose --profile '*' up -d
   

   

2. A primeira inicialização levará algum tempo para extrair e criar várias imagens do Docker, portanto, seja paciente. Quando o terminal exibir Container coze-server Started ou mensagem de sucesso semelhante, e nenhum outro registro novo for transferido, o serviço foi iniciado com êxito.
3. O implantado Coze Studio. O endereço de acesso é:
   http://<你的服务器公网IP>:9999

   comandante-em-chefe (militar) <你的服务器公网IP> Substitua pelo endereço IP exibido no canto superior esquerdo do painel do Pagoda.

   

   Quando a página for aberta, siga as instruções para registrar sua primeira conta de administrador e começar a explorar e criar suas inteligências de IA em seu ambiente local.