Independent testing Updated April 2026 387 self-hosting guides 5 VPS providers tested

guide

Como Hospedar o Lychee em um VPS (Guia Completo)

Aprenda a hospedar o Lychee em um VPS com este guia abrangente que cobre instalação, configuração e dicas para desenvolvedores.

Lychee é uma ferramenta de gerenciamento de fotos de código aberto muito popular, que oferece uma interface bonita para gerenciar suas imagens. Hospedar o Lychee em um Virtual Private Server (VPS) é uma excelente maneira de manter controle total sobre sua biblioteca de fotos. Neste guia, vamos passar pelos passos de hospedar o Lychee em um VPS, listando requisitos essenciais, instalação e configurações para uma operação tranquila.

Por que usar um VPS para o Lychee?

Usar um VPS para hospedar o Lychee traz inúmeras vantagens:

Provedores de VPS Recomendados

Antes de instalar o Lychee, escolha um provedor de VPS com base nas suas necessidades:

ProvedorPreçoRecursos
Contabo VPS5.99 EUR/mêsOpções de espaço em disco, suporte confiável
Hetzner Cloud4.15 EUR/mêsAlto desempenho, soluções escaláveis
DigitalOcean6 USD/mêsAPI simples, aplicativos com um clique
Vultr6 USD/mêsDiversas regiões, flexível
Linode (Akamai Cloud)5 USD/mêsArmazenamento SSD com alto IOPS

Mais detalhes podem ser encontrados em nossa comparação completa de VPS.

Pré-requisitos

  1. Instância de VPS: Qualquer um dos provedores listados acima funciona. Para este guia, vamos assumir que você está usando uma instância Linux simples (por exemplo, Ubuntu 20.04).
  2. Acesso root: Garanta que você tem privilégios de root ou sudo para instalar os pacotes necessários.
  3. Nome de domínio (opcional): Se deseja acessar o Lychee via um nome de domínio, recomendo registrá-lo.

Instalando o Lychee em um VPS

Passo 1: Configuração inicial do servidor

  1. Atualize o servidor:

    sudo apt update && sudo apt upgrade -y
  2. Instale os pacotes necessários: Instale Nginx, PHP e MariaDB:

    sudo apt install nginx php-fpm php-mysql php-xml php-gd php-curl php-zip mariadb-server -y
  3. Inicie e habilite os serviços: Certifique-se de que Nginx e MariaDB iniciem com o sistema:

    sudo systemctl start nginx
    sudo systemctl enable nginx
    sudo systemctl start mariadb
    sudo systemctl enable mariadb

Passo 2: Configurar o banco de dados

  1. Proteja o MariaDB:

    sudo mysql_secure_installation
  2. Crie o banco de dados e usuário: Faça login no MariaDB:

    sudo mysql -u root -p

    Depois execute os comandos SQL abaixo:

    CREATE DATABASE lychee;
    CREATE USER 'lycheeuser'@'localhost' IDENTIFIED BY 'sua_senha';
    GRANT ALL PRIVILEGES ON lychee.* TO 'lycheeuser'@'localhost';
    FLUSH PRIVILEGES;
    EXIT;

Passo 3: Baixar e instalar o Lychee

  1. Obtenha o código do Lychee:

    cd /var/www
    sudo git clone https://github.com/LycheeOrg/Lychee.git
  2. Configure as permissões:

    sudo chown -R www-data:www-data /var/www/Lychee
    sudo chmod -R 755 /var/www/Lychee
  3. Configurar Nginx: Crie um novo bloco de servidor para o Lychee:

    sudo nano /etc/nginx/sites-available/lychee

    Adicione a configuração abaixo:

    server {
        listen 80;
        server_name seu_dominio.com; # Substitua pelo seu domínio
    
        root /var/www/Lychee;
    
        index index.php index.html index.htm;
    
        location / {
            try_files $uri $uri/ /index.php?$query_string;
        }
    
        location ~ \.php$ {
            include snippets/fastcgi-php.conf;
            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # Ajuste de acordo com a versão PHP
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
    }
  4. Ative a configuração:

    sudo ln -s /etc/nginx/sites-available/lychee /etc/nginx/sites-enabled/
    sudo nginx -t
    sudo systemctl reload nginx

Passo 4: Finalizando a instalação do Lychee

  1. Acesse o Lychee: Vá até http://seu_dominio.com (ajuste com seu domínio real). Siga as instruções de configuração e insira as credenciais do banco de dados criadas anteriormente.

  2. Configure as configurações do ambiente: Edite o arquivo .env no diretório do Lychee para ajustes adicionais, garantindo que ele aponte para seu banco de dados.

Opcional: Instalando o Lychee via Docker

Para quem prefere usar Docker, também é possível instalar o Lychee com Docker:

docker run -d -p 80:80 -v /caminho/para/storage:/var/www/lychee/uploads lychee/lychee

FAQ

1. Posso rodar o Lychee em um VPS de baixo custo?

Sim, a maioria das opções de VPS de baixo custo, como Hetzner Cloud por 4.15 EUR/mês, oferecem recursos suficientes para rodar o Lychee de forma eficiente. Como é uma aplicação leve, o Lychee não exige muita memória ou CPU, tornando-o adequado para VPS menores.

2. Como proteger minha instalação do Lychee?

Para garantir a segurança, considere habilitar HTTPS usando Let’s Encrypt. Além disso, configure uma senha forte para seu usuário do banco de dados e mantenha seu servidor e aplicação Lychee sempre atualizados para evitar vulnerabilidades. Firewalls como UFW também podem melhorar a segurança, limitando o acesso às portas essenciais.

3. O que fazer se eu tiver problemas de desempenho?

Se notar problemas de desempenho, primeiro verifique o uso de recursos do seu servidor usando ferramentas como top ou htop. Atualizar seu plano de VPS ou otimizar consultas ao banco de dados pode ajudar. Revise também os logs do Lychee, pois eles podem fornecer insights sobre gargalos ou erros que afetam o desempenho.

Agora você está preparado para hospedar o Lychee em seu VPS escolhido! Seja usando Docker ou instalação tradicional, você pode gerenciar sua biblioteca de fotos com confiança. Boa hospedagem!