RibaSoft

Servidor - 07/01/2026

• • Apresentação
  • Pacotes
  • Configurações
  • Certbot
  • docker-compose.yml
  • Primeira Execução
  • VS Code
  • Passar o Projeto para Produção
  • Criar banco para outro projeto

Apresentação:

• Esse tutorial ensinará como configurar um ambiente de criação de um servidor completo com as melhores ferramentas disponíveis no momento visando portabilidade, velocidade, segurança, organização e manutenção.

  O ambiente será montado no WSL do Windows, visando compatibilidade com o ambiente de produção pois se for feito em windows para rodar em linux acontecerão vários poblemas.

  wsl --update wsl --install -d Debian

  Onde estiver descrito como DEV se referirá ao WSL, quando PROD se referenciará do servidor com Debian Net Inst.

Pacotes:

• Esses pacotes devem ser instalados tanto em modo Dev quanto em modo Prod.

  Obs.: Antes de Começar veja como instalar o DOCKER AQUI.

  sudo apt update sudo apt upgrade sudo apt install wget openssh-server certbot

Configurações:

• Configurações de acesso modo Dev (Somente WSL)

  
  sudo update-alternatives --display iptables sudo update-alternatives --set iptables /usr/sbin/iptables-legacy sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy sudo update-alternatives --set arptables /usr/sbin/arptables-legacy sudo update-alternatives --set ebtables /usr/sbin/ebtables-legacy

• Criar arquivos de configuração NGINX:

  
  mkdir -p docker/nginx nano docker/nginx/default.conf

  Conteúdo para servidor padrão localhost para ser usado em DEV:

  server { listen 80; listen [::]:80; server_name localhost; client_max_body_size 500M; root /var/www/public; index index.php; charset utf-8; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass laravel_ribasoft_app:9000; fastcgi_index index.php; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } location ~ /\.(?!well-known).* { deny all; } }

  Arquivo do DEV para ser usando com os certificados para https.

  nano docker/nginx/ribasoft.com.br.conf

  Conteúdo:

  server { listen 80; listen [::]:80; server_name ribasoft.com.br www.ribasoft.com.br; return 301 https://ribasoft.com.br$request_uri; } server { listen 443 ssl; listen [::]:443 ssl; server_name ribasoft.com.br www.ribasoft.com.br; ssl_certificate /etc/letsencrypt/live/ribasoft.com.br/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/ribasoft.com.br/privkey.pem; client_max_body_size 500M; root /var/www/public; index index.php; charset utf-8; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass laravel_ribasoft_app:9000; fastcgi_index index.php; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } location ~ /\.(?!well-known).* { deny all; } }

• RusDesk Server:

  
  

  Servidor do Rustdesk semelhante ao Anydesk e outros mas open source direto do seu próprio servidor.

  mkdir -p docker/rustdesk

  Aqui você colocará seus arquivos id_25519 e id_25519.pub caso vc queira restringir o tráfego do seu servidor apenas a clientes que posuam sua chave pública.

Certbot:

• Para que o https funcione precisa criar o certificado da Let's Encrypt com o nginx parado.

  sudo certbot certonly --standalone -d nome_dominio -d www.nome_dominio

docker-compose.yml:

• O docker-compose.yml é o arquivo principal, ele que dirá quais containers serão usados, seus comportamentos e como seus arquivos internos serão sobrescritos pelos externos.

  services: #Servidor WEB nginx: image: nginx:alpine networks: - rede_global_nginx container_name: laravel_ribasoft_nginx ports: - "80:80" - "443:443" volumes: - /var/www/site:/var/www/ - /var/www/hive:/var/www/hive - ./docker/nginx/ribasoft.com.br.conf:/etc/nginx/conf.d/ribasoft.com.br.conf - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf - ./docker/nginx/tulio.local.conf:/etc/nginx/conf.d/tulio.local.conf - ./docker/nginx/hive.cerianthusagro.com.br.conf:/etc/nginx/conf.d/hive.cerianthusagro.com.br.conf - /etc/letsencrypt:/etc/letsencrypt:ro restart: unless-stopped #Gerenciador de arquivos em REDE por diretórios samba: image: dperson/samba container_name: samba_server restart: always environment: - TZ=America/Sao_Paulo - USER=usuario;senha - USERID=1000 - GROUPID=1001 network_mode: "host" volumes: - /var/www/site/storage/app/private/api/varejo/backups:/mnt/backups - /var/www/bancos:/mnt/bancos command: > -s "backups;/mnt/backups;yes;no;no;ribasoft;ribasoft" -s "banco;/mnt/bancos;yes;no;no;ribasoft;ribasoft" -p -g "create mask = 0664" -g "directory mask = 0775" -g "store dos attributes = yes" -g "map hidden = no" -g "map system = no" -g "veto files = /*.vbs/*.exe/*.dat/*.txt/*.scr/*.com/*.js/*.jar/*.bat/*.cmd/*.ps1/*.sh/*.msi/*.pif/*.application/" -g "delete veto files = yes" #Banco de Dados postgres: image: postgres:16 networks: - rede_global_postgres container_name: laravel_ribasoft_postgres environment: POSTGRES_DB: banco POSTGRES_USER: usuario POSTGRES_PASSWORD: 'senha' volumes: - pgdata_site:/var/lib/postgresql/data ports: - "127.0.0.1:5432:5432" restart: unless-stopped # RustDesk ID Server hbbs: image: rustdesk/rustdesk-server:latest container_name: laravel_ribasoft_hbbs command: hbbs -r ribasoft.com.br:21117 -k _ environment: - RELAY=hbbr:21117 volumes: - ./docker/rustdesk/data:/root network_mode: "host" restart: unless-stopped # RustDesk Relay Server hbbr: image: rustdesk/rustdesk-server:latest container_name: laravel_ribasoft_hbbr command: hbbr -k _ volumes: - ./docker/rustdesk/data:/root network_mode: "host" restart: unless-stopped #Volume persistente para o banco de dados volumes: pgdata_site: networks: rede_global_nginx: external: true rede_global_postgres: external: true

• Observações NGINX:

  
  

  O app defaul deve estar funcionando corretamente na pasta padrãp /var/www/ para que os demais funcionem também.

• Observações Samba:

  
  

  No GROUPID=1001 deve ir o id do grupo que foi escolinho para o diretório compartilhado assim como o USERID=1000.

  Caso ao tentar acessar pelo windows de alguns erros execute no cmd do windows:

  net use * /delete /y

  Evitar usar o samba para acesso externo limitando no UFW o acesso a sua rede local:

  139,445/tcp ALLOW 192.168.1.0/24 Anywhere ALLOW 127.0.0.1

• Observações Postgres

  
  

  A ports: para ser acessada apenas via ssh ou pela app deve ter o 127.0.0.1: antes da porta, para acesso externo via DBeaver por exemplo retire esse ip.

Primeira Execução:

• Tudo pronto agora subir os containers para começar o desenvolvimento.

  Esses comando iniciará o servidor, mas para que funcione os containers das aplicações em Laravel indicadas no diretório docker/nginx precisam estar rodando.

  docker compose up -d

VS Code:

• Instalando a extenção WSL da Microsoft no VSCode, será possível editar os arquivos do projeto no WSL a partir do VSCode no Windows.

  Para isso pelo terminal no WSL dentro da pasta do projeto basta digitar Code . e pronto, o VSCode se iniciará automaticamente no Windows já na area de trabalho do projeto por conexão remota.

  Ao instalar o Git e inicia-lo dentro da pasta do projeto tambem no WSL, o VSCode cuidará do vercionamento e enviará as alterações para o Github apenas por cliques de forma bem intuitiva.

  Para ir acompanhando o desenvolvimento do projeto basta abrir qualquer navegador no Windows e acessa-lo pelo localhost.

Passar o Projeto para Produção:

• Mando o Projeto para o Github:

  
  git init git branch -M main git config --global user.name "ribasoft" git config --global user.email "ribamarmsantos@gmail.com" git remote add origin git@github.com:RibaSoft/site.git git status git add . git commit -m "Primeiro commit" git push -u origin main

• Trazer o projeto para o servidor de produção:

  
  cd /var/www/ git clone git@github.com:RibaSoft/site-ribasoft.git .

• Restaurar banco de dados:

  gunzip < /local_completo/banco.sql.gz | docker compose exec -T postgres psql -U usuario -d nome_banco

• Atualizar Site:

  Sempre que tiver alterações no Dev enviar para o Github e no Servidor PROD:

  git pull

Criar banco para outro projeto:

• Quando for usar o mesmo servidor para varios projetos ele precisaram estar em um rede_global_postgrees e os bancos, usuarios e senhas deverão estar em .env do projetos e serem criados manualmente.

  A rede global precisara estar no docker-compose.yml de todos os projetos.

  docker network create rede_global_postgres docker compose exec postgres psql -U usuario -d banco CREATE USER usuario WITH PASSWORD 'senha'; CREATE DATABASE banco; GRANT ALL ON SCHEMA public TO usuario; GRANT ALL PRIVILEGES ON DATABASE banco TO usuario; ALTER DATABASE banco OWNER TO usuario;