Preskoči na sadržaj

Konfiguracija servera

Ako želiš prilagoditi „Otvoreni web kalendar” tvojim potrebama, možeš

  • Promijeni zadani izgled kalendara.
  • Promijeniti način rada servera.

Konfiguriranje zadanog kalendara

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.

Možda ćeš htjeti promijeniti sljedeće vrijednosti.

title

Naslov tvoje web stranice.

language

Ovo je zadani jezik. Ovo možeš promijeniti kako bi lokalna publika bolje koristila stranicu konfiguracije.

favicon

Ovo je poveznica na ikonu web stranice.

source_code

Ako si napravio/la promjene, po zakonu moraš posjetitelje o tome obavijestiti. Prilagodi poveznicu ili ih vrati natrag u glavni projekt.

contributing

Ako želiš preusmjeriti za doprinešenje tvom projektu.

privacy_policy

If you host this service yourself, you can use the default privacy policy.

If for some reason you decide to collect data i.e. in the HTTPS proxy or log IP-addresses, then you need to create your own privacy policy. You can link to the one of this project.

Više vrijednosti

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.

Također pogledaj:

Konfiguriranje servera

Varijable okruženja utječu samo na pokretanje servera. Ove varijable okruženja se mogu koristiti za konfiguriranje usluge:

ALLOWED_HOSTS

zadana vrijednost je prazna

Zarezima odvojeni klijenti koji smiju pristupiti otvorenom web kalendaru. Vidjet ćeš ovaj tekst ako pokušaš pristupiti usluzi kada ti nije dozvoljeno:

Forbidden: You don’t have the permission to access the requested resource. It is either read-protected or not readable by the server.*

Primjeri:

  • dozvoli samo isto računalo: ALLOWED_HOSTS=localhost
  • dozvoli nekolicini servera: ALLOWED_HOSTS=192.168.0.1,192.168.2,api.myserver.com
  • dozvoli svima pristup serveru (zadano): ALLOWED_HOSTS= ili ALLOWED_HOSTS=*

Ovu funkcionalnost pruža flask-allowed-hosts.

PORT

zadano je 5000, zadano je 80 u Docker kontejneru

Priključak na kojem se usluga pokreće.

Primjeri:

  • Koristi HTTP priključak: PORT=80

OWC_SPECIFICATION

OWC_SPECIFICATION je opcionalna varijabla okruženja.

  • Može biti staza do datoteke koja sadrži ispravan YAML ili JSON.
  • Može biti znakovni niz koji sadrži ispravan YAML ili JSON.

Postavljanje OWC_SPECIFICATION dozvoljava mijenjanje zadanih vrijednosti za sve kalendare.

Napomena

Nove verzije aplikacije „Otvoreni web kalendar” mogu dodati nove parametre konfiguracije. Postavljanje vlastitih promjena u ovu varijablu umjesto mijenjanja datoteke default_specification će osigurati da „Otvoreni web kalendar” radi u budućoj verziji.

U sljedećem primjeru, naslov će se promijeniti za sve kalendare koji ne postavljaju vlastiti naslov.

OWC_SPECIFICATION='{"title": "calendar"}' gunicorn open_web_calendar:app

Također pogledaj:

WORKERS

zadano je 4, samo za Docker kontejnere

Broj paralelnih izvršitelja (workers) za obradu zahtjeva.

Primjeri:

  • Koristi samo jednog izvršitelja: WORKERS=1

CACHE_REQUESTED_URLS_FOR_SECONDS

standardno je 600

Broj sekundi za predmemoriranje datoteka kalendara koje se preuzimaju kako bi se smanjila propusnost i kašnjenje.

Primjeri:

  • Brzo aktualiziranje: CACHE_REQUESTED_URLS_FOR_SECONDS=10

APP_DEBUG

zadano je true, vrijedonsti su true ili false, uvijek false u Docker kontejneru

Postavi oznaku za otklanjanje grešaka za aplikaciju.

Daljnja konfiguracija

Otvoreni web kalendar koristi biblioteke za dodatno prilagođavanje.

SSRF zaštita s proxy serverom

The Open Web Calendar can be used to access the local network behind a firewall, see Issue 250. This free access is intended to show calendars from everywhere. Since requests is used by the Open Web Calender, it can use a proxy as described in the requests documentation. The proxy can then handle the filtering.

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"

Također pogledaj: