Pular para o conteúdo

Hospedagem própria do n8n skill

Implante e mantenha n8n em Docker com HTTPS Caddy, serviços privados e backups verificados.

Comunidade · Romuald Członkowski
AutorRomuald Członkowski
LicençaMIT
Fonteczlonkowski/n8n-skills · SKILL.md no GitHub
Site do projetodocs.n8n.io/deploy/host-n8n
Funciona emClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lido na fonte em

n8n-self-hosting orienta o agente desde uma VM Linux nova até uma instância n8n com HTTPS usando Docker Compose e Caddy.

Distingue implantação única com SQLite do modo fila com Postgres, Redis e executores externos pareados. É uma skill de operações, não de criação de fluxos.

Do SKILL.md da skill: # Deploying self-hosted n8n

Esta é uma skill da comunidade, de Romuald Członkowski, sem verificação nossa nem da Anthropic. Skills podem mandar o agente executar código, ler arquivos ou acessar a rede. Antes de instalar, leia o SKILL.md e todos os scripts da pasta, e procure qualquer coisa que não corresponda ao que ela diz fazer.

O que ela faz

  1. Reúna modo, domínio, SSH e fuso horário antes de provisionar.
  2. Gere segredos no servidor e mantenha privados os serviços internos.
  3. Verifique integridade, TLS e workers; documente backup e restauração.

O que você recebe

  • Configuração Compose, Caddyfile e arquivo privado de ambiente.
  • Verificações de implantação e instruções de manutenção contínua.

Quando usar

  • Implantar n8n em um servidor Linux autorizado.
  • Corrigir configuração de executor Python ou worker de fila.

Quando não usar

  • Criar fluxos ou administrar n8n Cloud.

O que ela exige

  • VM Linux, SSH com root ou sudo, DNS de domínio e portas públicas 80/443.
  • Docker Compose e Caddy; hospedagem, domínios e recursos pagos opcionais do n8n têm custos separados.

Arquivos da skill

Arquivo ou pastaPara que serve
SKILL.mdSeleção de modo e sequência de implantação.
TASK_RUNNERS.mdConfiguração de executores externos Python e JavaScript.
DAY2.mdProcedimentos de atualização, backup e restauração.
assets/Modelos Compose único e de fila, Caddy e ambiente.

Licença conforme encontrada no repositório em 2026-11-17: MIT.

Prompts de exemplo

Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.

  • Planeje uma implantação única na minha VM Linux; confira DNS e acesso antes de alterá-la.
  • Revise a implantação em fila quanto à igualdade de ambiente dos workers e executores externos pareados.
  • Escreva uma lista de backup e restauração que preserve a chave de criptografia do n8n.

Como instalar a skill n8n-self-hosting

Acesso ao servidor

A pasta individual precisa de SSH e operações de sistema. O envio ao Claude.ai e a rota de API em sandbox não foram verificados para este fluxo.

O plugin completo de n8n também inclui roteamento e hooks. Copie só esta pasta para obter orientação de implantação sem instalar o pacote inteiro.

Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:

Claude Code: copie a pasta para a sua pasta de skills

Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-self-hosting ~/.claude/skills/

O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /n8n-self-hosting ou apenas descreva a tarefa.

No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.

Codex, Gemini CLI, Cursor e GitHub Copilot

Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-self-hosting .agents/skills/
AgentePasta do projetoSua pasta de usuárioObservações
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

Fontes destas instruções

Conferido com a documentação de cada fornecedor em 2026-11-14:

Limites operacionais

Revise destino, janela de manutenção e backup antes de executar comandos em uma instância existente. Modelos são pontos de partida, não prova de integridade do servidor.

O n8n auto-hospedado tem edições e termos de licença próprios, separados desta skill sob licença MIT.

Perguntas sobre a skill n8n-self-hosting

Precisa de n8n-mcp?

A implantação usa SSH e Docker. n8n-mcp pertence ao pacote mais amplo de criação de fluxos e não é necessário para provisionar servidores.

Qual modo devo escolher?

Escolha explicitamente único ou fila antes da implantação. Fila exige Postgres e Redis; SQLite não é seu banco.

Posso perder credenciais salvas?

Sim, se a chave de criptografia for perdida ou alterada. Mantenha uma cópia protegida fora do servidor junto aos backups de dados.

Uma resposta HTTP de integridade basta?

Não. A skill também verifica TLS público, prontidão e, quando aplicável, paridade dos workers e executores de tarefas.

Mais skills de IA

Skills relacionadas

Categorias de skills