Preparando seu Servidor Ubuntu para uma Aplicação Flask com CyberPanel e OpenLiteSpeed

Massao Kuroiwa

26 de julho de 2025·3 min·32 leituras

Este guia detalha os passos para configurar um ambiente de servidor em Ubuntu, utilizando CyberPanel e OpenLiteSpeed, para hospedar sua aplicação Python Flask.

1. Instalação do Python e Pip no Servidor CyberPanel Ubuntu

Para começar, conecte-se ao seu servidor Ubuntu via SSH. É essencial que você utilize uma conta root ou uma com privilégios sudo . Em seguida, execute o seguinte comando para instalar o Python 3 e o Pip:

sudo apt install python3 python3-pip

2. Instalação do Pacote wsgi-lsapi

O wsgi-lsapi é crucial para que o OpenLiteSpeed possa executar aplicações Python. Siga os comandos abaixo para instalá-lo:

curl -O https://www.litespeedtech.com/packages/lsapi/wsgi-lsapi-2.1.tgz
tar xf wsgi-lsapi-2.1.tgz
sudo mv wsgi-lsapi-2.1 /usr/local/lsws
cd /usr/local/lsws/wsgi-lsapi-2.1
python3 ./configure
make
sudo mv lswsgi /usr/local/lsws/fcgi-bin

3. Configuração de um Ambiente Virtual Python

É uma boa prática configurar um ambiente virtual para suas aplicações Python. Primeiramente, saia da conta root e faça login via SSH como o usuário da conta de hospedagem. Se necessário, você pode habilitar o acesso SSH para a conta através do CyberPanel (navegue até Websites > List Websites , clique em Manage para o seu site e procure o botão de acesso SSH).

Navegue até o diretório do seu site, que geralmente está em /home/seusite.com :

cd /home/seusite.com

Crie e ative um novo ambiente virtual (aqui, nomeado como venv ):

python3 -m virtualenv venv
source venv/bin/activate

4. Instalação do Flask no Ambiente Virtual

Com o ambiente virtual ativado, instale o Flask utilizando o Pip:

pip3 install flask

5. Criação de um Diretório para os Arquivos da Aplicação

Dentro da pasta public_html do seu site, crie um diretório para armazenar os arquivos da sua aplicação Flask. Por exemplo, se o nome da sua aplicação for minha_app_flask , crie a pasta da seguinte forma:

mkdir /home/seusite.com/public_html/minha_app_flask

Após criar o diretório, faça o upload dos arquivos da sua aplicação Flask (por exemplo, app.py , index.html , base.html e o diretório templates ) para esta nova pasta. Você pode usar o gerenciador de arquivos do CyberPanel ou SFTP para esta etapa.

6. Configuração do Arquivo wsgi.py e Edição do app.py

Crie um novo arquivo chamado wsgi.py no diretório public_html ( /home/seusite.com/public_html/wsgi.py ) com o seguinte conteúdo. Certifique-se de ajustar from minha_app_flask caso o nome do seu diretório da aplicação seja diferente:

#!/usr/bin/env python
import sys
sys.path.insert(0, '/home/seusite.com/public_html')
from minha_app_flask import app as application

Renomeie seu arquivo principal da aplicação, por exemplo:

app.py para __init__.py
(ex: /home/seusite.com/public_html/minha_app_flask/__init__.py )
Remova a seção:
if __name__ == '__main__': app.run() do arquivo __init__.py
O arquivo __init__.py modificado deve se parecer com o exemplo abaixo:

from flask import Flask, render_template
app = Flask(__name__)

@app.route('/')
def index():
    sitename = "Meu Site Flask de Exemplo"
    return render_template("index.html", sitename=sitename)

7. Configuração do LiteSpeed para Executar a Aplicação Flask

Acesse o painel de administração do LiteSpeed WebAdmin (geralmente na porta 7080 do seu IP do servidor, por exemplo: http://SEU_IP_DO_SERVIDOR:7080 ).

No menu lateral esquerdo, selecione Virtual Hosts .
Clique no ícone de lupa ao lado do domínio que você está configurando.
Na página seguinte, clique na aba Context e depois no botão Add à direita.
Selecione App Server como o tipo e clique em next .
Configure os campos conforme abaixo (ajuste URI se desejar servir a aplicação a partir de um subdiretório em vez da raiz do domínio):

URI: /minha_app_flask (ou / se for a raiz do domínio)
Location: /home/seusite.com/public_html/minha_app_flask
Binary Path: /usr/local/lsws/fcgi-bin/lswsgi
Application Type: WSGI
Startup File: wsgi.py
Environment: PYTHONPATH=/home/seusite.com/venv/lib/python3.8:/home/seusite.com/public_html/minha_app_flask
Environment: LS_PYTHONBIN=/home/seusite.com/venv/bin/python3

Clique no botão save no canto superior direito.
Para aplicar as alterações, reinicie o servidor de forma graciosa clicando no nome do seu host no canto superior esquerdo da página e escolhendo Graceful Restart no menu pop-up.