Configuración del servidor¶
Si deseas cambiar el Calendario Web Abierto para satisfacer tus necesidades, se puede hacer. Puedes elegir
- Cambiar la apariencia del calendario predeterminado.
- Cambiar el funcionamiento del servidor.
Configurar el calendario predeterminado¶
The configuration of all calendars is rooted in the default_specification. All those values can be changed through a copy of this file hosted on the web through the calendar parameter specification_url
. Each parameter should be documented in default_specification.
To modify all calendars hosted on your instance, use the OWC_SPECIFICATION environment variable. Calendars still override some values for their configuration. Those which they do not override are affected by the default specification. Not all values are exposed to the configuration page to be changed. Those values can still be changed in the specification_url
and the query parameters.
Es posible que quieras cambiar los siguientes valores.
title
¶
El título de tu página web.
language
¶
Este es el idioma predeterminado. Es posible que desees cambiarlo para ofrecer una mejor configuración a una audiencia local.
favicon
¶
Este es el favicon de la página web.
source_code
¶
Si ha realizado cambios, está legalmente obligado a revelarlos a los visitantes. Le rogamos que adapte el enlace o los aporte de nuevo al proyecto principal.
contributing
¶
Si quieres redirigir a otro lugar, para que ayuden en tu proyecto.
privacy_policy
¶
Si alojas este servicio tu mismo, puedes utilizar la política de privacidad predeterminada.
Si por alguna razón decides recoger datos, por ejemplo, en el proxy HTTPS o registrar direcciones IP, entonces necesitas crear tu propia política de privacidad. Puedes enlazar con la de este proyecto.
Más valores¶
There are loads more values that can be changed. Please refer to the default_specification. These values are all documented. Please use the OWC_SPECIFICATION environment variable to change them.
Ver también:
Configurando el servidor¶
Las variables de entorno solo influyen en el funcionamiento del servidor. Estas variables del entorno se pueden utilizar para configurar el servicio:
ALLOWED_HOSTS¶
vacío predeterminado
Los clientes separados por comas que tienen permiso para acceder al Open Web Calendar. Verá este texto si intenta acceder al servicio y no tiene permisos:
Forbidden: You don’t have the permission to access the requested resource. It is either read-protected or not readable by the server.*
Examples:
- permitir solo al mismo ordenador:
ALLOWED_HOSTS=localhost
- permitir varios hosts:
ALLOWED_HOSTS=192.168.0.1,192.168.2,api.myserver.com
- permitir a todo el mundo el acceso al servidor (por defecto):
ALLOWED_HOSTS=
oALLOWED_HOSTS=*
Esta función es proporcionada por flask-allowed-hosts.
PORT¶
por defecto5000
, predeterminado80
en el contenedor Docker
El puerto en el que se ejecuta el servicio.
Examples:
- Servir en el puerto HTTP:
PUERTO=80
OWC_SPECIFICATION¶
OWC_SPECIFICATION
is an optional environment variable.
- It can be a path to a file containing valid YAML or JSON.
- It can be a string containing valid YAML or JSON.
Setting OWC_SPECIFICATION
allows you to replace default values for all calendars.
Note
New versions of the Open Web Calendar can add new configuration parameters.
Placing your changes in this variable instead of changing the default_specification
file
will ensure that you do not break the Open Web Calendar in a future version.
In following example, the title for all calendars that do not set their own title will be changed.
OWC_SPECIFICATION='{"title": "calendar"}' gunicorn open_web_calendar:app
Ver también:
WORKERS¶
por defecto 4
, solo para el contenedor Docker
El número de trabajadores paralelos para gestionar las peticiones.
Examples:
- Utilice sólo un trabajador:
WORKERS=1
CACHE_REQUESTED_URLS_FOR_SECONDS¶
por defecto 600
Segundos para almacenar en la caché los archivos del calendario que se descargan para reducir el ancho de banda y las demoras.
Examples:
- Actualización rápida:
CACHE_REQUESTED_URLS_FOR_SECONDS=10
APP_DEBUG¶
por defecto los valores true
, true
o false
, siempre false
en el contenedor Docker
Establecer el indicador de depuración para la aplicación.
Further Configuration¶
Calendario web abierto utiliza bibliotecas cuyo comportamiento se puede personalizar aún más.
- Flask tiene más variables de entorno disponibles para configurar cómo la aplicación entrega el contenido.
- ** Peticiones** se utiliza para obtener el
.ics
archivos. Puede configurar un proxy.
Protección SSRF a través de un proxy¶
El Calendario web abierto puede utilizarse para acceder a la red local detrás de un cortafuegos, véase Edición 250. Este acceso libre está pensado para mostrar calendarios de todas partes. Dado que el Open Web Calender utiliza peticiones
, puede utilizar un proxy como se describe en la documentación de laspeticiones
. El proxy puede entonces manejar el filtrado.
export HTTP_PROXY="http://10.10.1.10:3128"
export HTTPS_PROXY="http://10.10.1.10:1080"
export ALL_PROXY="socks5://10.10.1.10:3434"
Ver también: