Variáveis de ambiente
O OpenFishing é configurado inteiramente através de variáveis de ambiente. Cada variável é opcional exceto onde indicado; as variáveis não definidas recorrem às predefinições abaixo.
Tabela de referência
Seção intitulada “Tabela de referência”| Variável | Predefinição | Descrição |
|---|---|---|
DATABASE_URL |
local.db |
Caminho para o ficheiro da base de dados SQLite. No Docker, aponta-o para o teu volume de dados, p. ex. /app/data/openfishing.db. |
UPLOAD_PATH |
./uploads |
Diretório para fotos de iscas/pontos/capturas. Monta um volume aqui (p. ex. /app/uploads). |
BASE_URL |
http://localhost:5173 |
URL base pública, usada para construir os links de código QR e de reposição de palavra-passe. Define-a com o teu URL HTTPS real atrás de um proxy reverso. |
ADMIN_PASSWORD |
(não definido) | Define para ativar o início de sessão multiutilizador. É a palavra-passe da conta admin (o nome de utilizador é sempre admin, ressincronizado em cada arranque). Não definido = instância de inquilino único totalmente aberta. |
AUTH_PASSWORD |
(não definido) | Nome alternativo descontinuado para ADMIN_PASSWORD. Prefere ADMIN_PASSWORD. |
SMTP_HOST |
(não definido) | Nome de host do servidor SMTP para os e-mails de “palavra-passe esquecida”. |
SMTP_PORT |
(não definido) | Porta do servidor SMTP. |
SMTP_SECURE |
(não definido) | Usar TLS para a ligação SMTP. |
SMTP_USER |
(não definido) | Nome de utilizador SMTP. |
SMTP_PASS |
(não definido) | Palavra-passe SMTP. |
SMTP_FROM |
(não definido) | O endereço From: do correio de saída. |
DEMO_MODE |
(não definido) | Qualquer valor = modo demo só de leitura (todas as escritas bloqueadas). |
CHATBOT |
(não definido) | Qualquer valor verdadeiro ativa o chatbot de IA (requer as variáveis LiteLLM). |
LITELLM_URL |
(não definido) | URL base do teu proxy LiteLLM, p. ex. http://litellm:4000. |
LITELLM_MODEL |
(não definido) | Nome de modelo correspondente a uma entrada de litellm.config.yaml. |
LITELLM_VISION_MODEL |
(não definido) | Modelo com capacidade de visão opcional para identificação de peixe/isca. Recorre a LITELLM_MODEL. |
BODY_SIZE_LIMIT |
104857600 |
Tamanho máximo de upload em bytes (predefinição ≈ 100 MB). |
Notas sobre as predefinições
Seção intitulada “Notas sobre as predefinições”As predefinições acima são as predefinições integradas no código da aplicação. Num contentor, normalmente vais substituir os caminhos para apontar para volumes montados:
DATABASE_URL=/app/data/openfishing.dbUPLOAD_PATH=/app/uploadsAgrupadas por finalidade
Seção intitulada “Agrupadas por finalidade”- Armazenamento:
DATABASE_URL,UPLOAD_PATH,BODY_SIZE_LIMIT - Rede / links:
BASE_URL - Autenticação:
ADMIN_PASSWORD(AUTH_PASSWORDdescontinuado) - E-mail / reposição de palavra-passe:
SMTP_HOST,SMTP_PORT,SMTP_SECURE,SMTP_USER,SMTP_PASS,SMTP_FROM - Funcionalidades de IA:
CHATBOT,LITELLM_URL,LITELLM_MODEL,LITELLM_VISION_MODEL - Demo:
DEMO_MODE
Consulta Multiutilizador e autenticação, Funcionalidades de IA e Modo demo para veres como estes grupos se encaixam.