.env

Configure o Navixy em Docker usando o arquivo .env. Defina credenciais do banco de dados, nomes de domínio, caminhos dos certificados SSL, opções do Let's Encrypt e parâmetros do MySQL.

Para executar a versão em Docker da plataforma Navixy, o .env arquivo é o arquivo de configuração principal. Ele contém parâmetros importantes como credenciais do banco de dados, nomes de domínio, a pasta de trabalho de instalação da plataforma e outros.

O .env O arquivo é usado principalmente durante a instalação inicial da plataforma. No entanto, se você precisar alterar algo na configuração de uma plataforma existente, também precisará modificar este arquivo.

Todos os parâmetros neste arquivo estão comentados para facilitar a compreensão do que você está lidando. Informações adicionais sobre esses parâmetros são descritas nas seções abaixo.

Se você alterar alguma configuração enquanto a instância já estiver em execução, as alterações não serão aplicadas instantaneamente. Você precisa reinicializar toda a instância para que elas entrem em vigor. Para fazer isso, a partir da pasta principal da plataforma (navixy-package), execute o comando: docker compose up -d Isso recriará os contêineres com as novas configurações.

UID e GID

Estes são parâmetros de serviço usados apenas na etapa de compilação da plataforma. Você não precisa alterá-los.

WORKDIR

Este é um parâmetro que indica o diretório de trabalho da plataforma — onde o banco de dados e todos os arquivos de serviço são armazenados. É necessário proteger este diretório para evitar a perda de dados de negócios.

Valor padrão deste parâmetro: WORKDIR=./work.

Isso significa que /work o diretório dentro da compilação descompactada do Navixy é usado. Se o diretório não existir, ele será criado.

Se necessário, você pode colocar o diretório de trabalho em qualquer lugar do seu sistema. Para fazer isso, especifique o caminho completo para o diretório. Exemplos:

• /home/admin/work

• /usr/local/navixy

Certifique-se de dar ao diretório um nome óbvio para não excluí-lo por engano.

navixy_username

Este é o nome de usuário usado para acesso ao banco de dados. Ele sempre é navixy, não o altere.

navixy_passwd

Esta é a senha do navixy usuário do banco de dados. Por padrão, esse valor está vazio e você precisa especificar a senha de sua preferência. Recomenda-se gerar automaticamente uma senha forte, mas a escolha é sua; você pode especificar o que quiser.

Não altere essa senha após o banco de dados ser criado e a plataforma implantada.

service_domain

Este é o domínio principal da sua instância da plataforma. Ele é usado para:

• Acesso à interface do usuário.

• Ativar novo rastreador.

Caso você esteja utilizando uma instalação de domínio único (sem domínios separados para API e painel administrativo), este domínio também será usado para:

• Acesso à API pelo link service_domain/api

• Acesso ao painel administrativo pelo link service_domain/panel

Isso também pode ser o endereço IP do seu servidor, se você não for usar um nome de domínio para o seu serviço.

api_domain

Este parâmetro é opcional e usado apenas para instalações de três domínios.

Aqui você precisa especificar o nome de domínio usado para acessar a API da sua plataforma.

panel_domain

Este também é um parâmetro opcional usado para instalações de três domínios.

Aqui você precisa especificar o nome de domínio usado para acessar o painel administrativo da sua plataforma.

le_enabled

Este parâmetro ativa a emissão automática e a posterior reemissão do certificado SSL do Let's Encrypt.

Ele é true por padrão. Isso significa que, quando você implantar a plataforma, o Certbot será configurado e lidará com a emissão automática do certificado SSL para os seus domínios. Dessa forma, você não precisará se preocupar em comprar certificados de terceiros. A instância se configurará para ficar protegida por SSL.

Se você quiser usar seu próprio certificado SSL em vez do Let's Encrypt, altere este parâmetro para false.

le_email

Este é o endereço de e-mail para receber informações sobre a operação do Certbot, como expiração do certificado, revogação do certificado e problemas que podem levar à impossibilidade de reemitir o certificado.

Por padrão, este parâmetro está vazio. Recomenda-se que você especifique um endereço de e-mail válido para não perder notificações importantes sobre a proteção SSL do seu site.

redirect_to_https

Esta configuração permite que as solicitações sejam redirecionadas de http para https. Se a sua plataforma estiver configurada para usar proteção SSL e alguém tentar usar uma URL que comece com http, um redirecionamento automático para https será acionado.

Se o parâmetro estiver desativado (false), então nenhum redirecionamento ocorrerá, e o site não será aberto.

Este parâmetro se aplica apenas se a proteção SSL estiver ativada e o certificado SSL estiver instalado.

service_ssl_cert e service_ssl_key

Se você não pretende usar o Let's Encrypt e quiser usar seu próprio certificado SSL em vez disso, você precisa colocar o certificado do seu domínio e sua chave privada no diretório: WORKDIR/nginx/ssl.

Certifique-se de mudar le_enabled o parâmetro para false antes de aplicar quaisquer alterações a esta seção. Você não pode usar seus próprios certificados para a plataforma quando o certbot estiver em execução.

Depois que o certificado e a chave estiverem no lugar, você precisa especificar seus nomes de arquivo para os parâmetros correspondentes da configuração. Observe que você não precisa especificar caminhos. Exemplo:

service_ssl_cert=my_domain_com.crt
service_ssl_key=my_domain_com.key

MYSQL_RANDOM_ROOT_PASSWORD

Este parâmetro habilita a geração de senha aleatória para o MySQL root usuário. O valor padrão é true.

O parâmetro é usado apenas na inicialização do banco de dados ao instalar a plataforma. Em reinicializações e atualizações posteriores da plataforma, ele não faz nada, e a senha permanece a mesma.

Se você preferir definir uma senha específica de root do MySQL, altere o valor para false e prossiga para o próximo parâmetro.

MYSQL_ROOT_PASSWORD

Aqui você especifica a senha de root do MySQL.

Este parâmetro é aplicado apenas quando MYSQL_RANDOM_ROOT_PASSWORD é alternado para false. Caso contrário, o valor é ignorado.

skip_db_update

Este parâmetro desativa a atualização do banco de dados quando navixy-standalone-db o contêiner é iniciado. Ele é usado para fins de teste; você não precisa alterar o valor padrão (false) durante o uso normal da plataforma.