🔧 Documentação Técnica

Requisitos para rodar o
ERP-Commerce

Tudo que você precisa saber sobre hardware, software e configuração de rede para colocar sua loja online no ar — hospedada no seu próprio servidor.

Servidor de Aplicação Web Firebird 3 / 5 Windows Server IP Fixo ou DDNS Porta 8080 / 443
Como funciona
Arquitetura da solução

O ERP-Commerce é uma aplicação web construída com Servidor de Aplicação rodando sobre o servidor do ERP Solution3. O banco de dados é o Firebird já utilizado pela empresa. Não há servidor web separado, não há banco de dados extra — tudo no mesmo ambiente que você já tem.

Boa notícia para clientes CyberSul: se você já roda o Solution3, provavelmente já atende a maioria dos requisitos abaixo. A implantação se resume a configurar o acesso externo à rede.
Software
Requisitos de software

Componentes necessários no servidor onde o ERP-Commerce será executado.

🖥️
Sistema Operacional
Servidor Windows
Windows Server 2016, 2019 ou 2022RecomendadoMelhor estabilidade para serviço contínuo 24h
Windows 10 / 11 Pro ou EnterpriseMínimoFunciona, mas limite de conexões simultâneas do Windows pode impactar em alto tráfego
Arquitetura 64-bit obrigatóriaTanto SO quanto aplicação devem ser 64-bit
🔥
Banco de Dados
Firebird
Firebird 5.xRecomendadoMelhor desempenho e suporte a novas funcionalidades SQL
Firebird 3.xMínimoSuportado, porém algumas otimizações não estarão disponíveis
Firebird Server ModeDeve estar rodando como serviço do Windows (não Embedded)
Porta padrão 3050 liberadaComunicação entre a aplicação Servidor de Aplicação e o Firebird
Servidor de Aplicação
Servidor de Aplicação / Solution3
Servidor de Aplicação WebRecomendadoRuntime Servidor de Aplicação já incluso na instalação do SolutionWeb
SolutionWeb (CyberSul) atualizadoERP-Commerce é um módulo do SolutionWeb — deve estar na versão compatível
SolutionWeb rodando como serviço WindowsManter o SolutionWeb ativo mesmo sem login de usuário no servidor
Porta de escuta configuradaPadrão: 8080. Configurável no INI do SolutionWeb
🛡️
Segurança e Certificado
HTTPS recomendado
Certificado SSL/TLSRecomendadoLet's Encrypt (gratuito) ou certificado pago. Essencial para aceitar pagamentos online
Reverse Proxy (Nginx ou IIS)OpcionalPermite HTTPS na porta 443 redirecionando para porta interna do Servidor de Aplicação
Windows Firewall configuradoLiberar porta 8080 (ou 443) para entrada. Manter 3050 bloqueada externamente
Antivírus com exceção para SolutionWebEvitar falsos positivos que interrompam o serviço
Hardware
Requisitos de hardware

Configuração mínima e recomendada para o servidor que hospedará o ERP e a loja online simultaneamente.

Componente ⚠️ Mínimo ✅ Recomendado 🚀 Ideal (alto tráfego)
Processador Intel Core i3 / Ryzen 3
4 núcleos, 2.5 GHz
Intel Core i5/i7 / Ryzen 5
6–8 núcleos, 3.0+ GHz
Intel Xeon / Ryzen 9
8+ núcleos, ECC RAM
Memória RAM 8 GB DDR4 16 GB DDR4 32 GB DDR4 ECC
Armazenamento HDD 500 GB SATA SSD 256 GB (SO + app)
HDD para banco e backups
SSD NVMe 512 GB+
RAID 1 para banco
Rede 100 Mbps Gigabit Ethernet Gigabit + link redundante
Internet (upload) 10 Mbps upload 50 Mbps upload simétrico 100 Mbps+ fibra simétrica
Nobreak / UPS Recomendado Obrigatório
⚠️
Upload é crítico: quando clientes acessam sua loja de fora da empresa, eles consomem o upload do seu link. Links residenciais com 10 Mbps de upload suportam poucos usuários simultâneos. Para uma loja com tráfego real, contrate um link dedicado ou hospede na nuvem.
ℹ️
Escopo de suporte CyberSul: a CyberSul realiza a instalação e configuração do ERP-Commerce em rede local. A abertura de acesso externo — incluindo configuração de modem, roteador, proxy reverso e certificado SSL — é responsabilidade do cliente ou de seu profissional de TI. As informações abaixo são um guia de referência.
Rede e Acesso Externo
Tornando sua loja acessível pela internet

Esta é a parte mais crítica da implantação. Sua loja precisa ser acessada por clientes de qualquer lugar do mundo. Veja as opções, do mais simples ao mais robusto.

1

IP Fixo ou DDNS

Seu servidor precisa de um endereço fixo na internet. Contrate IP fixo com seu provedor ou use um serviço DDNS como No-IP ou DuckDNS.

2

Domínio (opcional)

Registre um domínio (ex: minhaloja.com.br) e aponte o DNS para seu IP. Muito mais profissional que expor um IP diretamente.

3

Roteador / Modem

Configure o Port Forwarding (redirecionamento de porta) no roteador: porta 80 e 443 externas → porta 8080 interna do servidor.

4

Firewall e SSL

Libere as portas no Windows Firewall. Instale certificado SSL com Certbot (Let's Encrypt gratuito) ou via proxy reverso Nginx.

Opções de configuração de acesso
Opção Como funciona Custo Complexidade Indicado para
IP Fixo do provedor Provedor atribui IP que nunca muda R$ 30–150/mês Baixa Maioria das empresas
DDNS (No-IP / DuckDNS) Serviço atualiza DNS automaticamente quando IP muda Grátis ou ~R$ 50/ano Baixa Testes e pequenas lojas
Nginx Reverse Proxy Nginx na porta 443 (HTTPS) repassa para Servidor de Aplicação na 8080 Grátis Média Quem quer HTTPS profissional
Cloudflare Tunnel Túnel criptografado Cloudflare → servidor local, sem abrir portas no modem Grátis Média Segurança máxima sem IP fixo
VPS / Nuvem (Azure, AWS) Servidor virtual na nuvem com IP fixo incluso R$ 80–300/mês Média Loja com alto tráfego
💡
Recomendação CyberSul: para a maioria das empresas, a combinação ideal é IP Fixo do provedor + Nginx Reverse Proxy + Let's Encrypt. Custo baixo, HTTPS nativo e configuração estável.
Configuração de Rede
Port Forwarding no roteador

Independente da marca do roteador (Intelbras, TP-Link, Mikrotik, etc), o conceito é o mesmo: redirecionar o tráfego externo para o servidor interno.

Regras de redirecionamento de porta
# Acesso HTTP (redireciona para HTTPS via Nginx)
Porta externa:  80IP interno: 192.168.1.100  Porta interna: 80

# Acesso HTTPS (Nginx SSL → Servidor de Aplicação)
Porta externa:  443IP interno: 192.168.1.100  Porta interna: 443

# Acesso direto Servidor de Aplicação (sem proxy, apenas HTTP)
Porta externa:  8080IP interno: 192.168.1.100  Porta interna: 8080

# NUNCA abrir externamente (segurança)
Porta Firebird: 3050BLOQUEADA para acesso externo
⚠️
IP interno fixo é essencial: configure o servidor com IP fixo na rede local (ex: 192.168.1.100) ou reserve o IP por MAC address no roteador. Se o IP interno mudar, o port forwarding para de funcionar.
Reverse Proxy
Configuração Nginx (HTTPS + proxy para Servidor de Aplicação)

O Nginx recebe as conexões HTTPS na porta 443 e repassa para o Servidor de Aplicação na porta 8080 internamente. Isso garante SSL sem modificar o Servidor de Aplicação.

nginx.conf — bloco server
server {
    listen       80;
    server_name  minhaloja.com.br;
    # Redireciona HTTP para HTTPS
    return 301 https://$host$request_uri;
}

server {
    listen       443 ssl;
    server_name  minhaloja.com.br;

    # Certificado Let's Encrypt (gerado pelo Certbot)
    ssl_certificate      /etc/letsencrypt/live/minhaloja.com.br/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/minhaloja.com.br/privkey.pem;

    # Repassa para o Servidor de Aplicação local na porta 8080
    location / {
        proxy_pass         http://127.0.0.1:8080;
        proxy_set_header   Host $host;
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_read_timeout 120s;
        client_max_body_size 20m;
    }
}
💡
No Windows: use o Nginx para Windows ou o IIS com módulo Application Request Routing (ARR) como reverse proxy. O IIS já vem disponível no Windows Server e pode ser mais familiar para equipes Windows.
Checklist
Lista de verificação antes de ir ao ar

Percorra cada item antes de divulgar o endereço da loja para os clientes.

Servidor e Software
Firebird Server rodando como serviço Windows
SolutionWeb rodando como serviço (não apenas como executável)
Servidor reinicia e aplicação sobe automaticamente
INI do ERP-Commerce configurado e salvo
Backup automático do banco de dados ativo
🌐
Rede e Acesso
IP fixo ou DDNS configurado e testado
Port forwarding ativo no roteador (porta 443 ou 8080)
Loja acessível por domínio de fora da rede local
Certificado SSL válido (cadeado verde no navegador)
Porta 3050 do Firebird BLOQUEADA externamente
🛒
Loja e Pagamentos
Produtos publicados e com fotos
Chave PIX configurada e testada
Gateway de cartão com chave de produção (não sandbox)
E-mail de pedido chegando corretamente
Teste de compra completo realizado

Quer saber como a CyberSul implanta o ERP-Commerce?

A equipe da CyberSul garante que o ERP-Commerce seja instalado e operando corretamente em rede local. A configuração de acesso externo (modem, proxy, SSL) fica a cargo do cliente ou de seu suporte de TI.

Falar com especialista CyberSul