Open Brand Exchangev0.1Verze 0.1. Verze 0.1 je venku. Specifikace i software jsou volně k použití.
Hosting
Provozujte, kde chcete. Plaťte jen hosting.
Jeden portál je jedna značková firma na jednom serveru. Vy volíte, jak ho provozovat, od úplného outsourcingu po úplně vlastní provoz. Níže od nejjednoduššího po nejtechničtější.
Nejjednodušší: firma váš portál hostuje, udržuje ho aktuální a pomůže s nastavením. Protože všechny portály mluví stejným standardem, můžete později přejít k jinému poskytovateli nebo na vlastní hosting.
Photopilot
Product photography software for fashion and lifestyle. Hosts a brand portal on your own domain and publishes through OBX.
Uvedena tu může být jakákoli hostingová firma, agentura nebo dodavatel softwaru. Podmínky jsou pro všechny stejné:
váš portál projde testy shody
značka může exportovat všechna data a fotografie a odejít
vlastní ceny a podmínky zveřejňujete na svém webu
Otevřete pull request v repozitáři webu se svými údaji v src/data/providers.json. Poskytovatelé jsou seřazeni abecedně. openbrandexchange/website
2. Jedním kliknutím
Vlastní portál na vlastním účtu, bez správy serveru.
Portál pro Cloudflare
Běží na Cloudflare Workers, s D1 jako databází a R2 pro obrázky. Klikněte na tlačítko, přihlaste se do Cloudflare a postupujte podle kroků. Pro portál v každodenním provozu potřebujete tarif Workers Paid (5 dolarů měsíčně); bezplatný tarif stačí jen na vyzkoušení. Webové verze vašich fotografií vytvoří váš prohlížeč a nástroj obx.
Skript, který váš portál nasadí na Google Cloud Run. Potřebujete účet Google Cloud a nástroj gcloud.
git clone https://github.com/openbrandexchange/node-go
cd node-go
gcloud config set project my-project # once: your Google Cloud project (billing on)
DRY_RUN=1 ./deploy/cloudrun.sh # optional: only show what it would do, change nothing
./deploy/cloudrun.sh # region europe-west4; REGION=… for another
Pro webhosting, který možná už máte, s PHP a databází. Žádné příkazy nejsou potřeba:
Stáhněte obx-portal-php-<version>.zip z nejnovějšího vydání.
Rozbalte ho a nahrajte složku na hosting přes (S)FTP.
Nasměrujte svou (sub)doménu, například prodejci.vaseznacka.cz, na složku public.
Umožněte zápis do složek data a config (oprávnění 775; pokud instalátor stále hlásí, že zápis nejde, 777).
Otevřete tuto adresu. Instalátor zkontroluje server a zeptá se na instalační kód ze souboru data/SETUP-CODE.txt, který otevřete programem pro FTP. Pak klikněte na „Otevřít průvodce nastavením“.
Adresu pro cron, kterou instalátor ukáže, přidejte jako úlohu cron v ovládacím panelu hostingu, každých 5 minut. I bez ní portál funguje.
Na vlastním serveru nebo v jakémkoli cloudu, který spouští kontejnery. Jeden příkaz:
openssl rand -hex 32 > obx-secret.key # once; keep this file safe, with your backups
docker run -d --name obx --restart unless-stopped \
-p 8080:8080 -v obx-data:/data \
-e OBX_PUBLIC_URL=https://brands.example.com \
-e OBX_SECRET_KEY="$(cat obx-secret.key)" \
ghcr.io/openbrandexchange/node-go
docker logs obx 2>&1 | grep -i "setup code" # the one-time code for the first-run wizard
Nebo rovnou s HTTPS přes Caddy:
compose.yaml
# compose.yaml: the node behind Caddy, which gets an HTTPS certificate by itself.
services:
obx:
image: ghcr.io/openbrandexchange/node-go
restart: unless-stopped
environment:
OBX_PUBLIC_URL: https://brands.example.com
OBX_SECRET_KEY: ${OBX_SECRET_KEY} # openssl rand -hex 32, keep it safe
OBX_TRUST_PROXY: "true" # every request comes through Caddy (rate limits per visitor)
volumes:
- obx-data:/data
caddy:
image: caddy:2
restart: unless-stopped
ports: ["80:80", "443:443"]
command: caddy reverse-proxy --from brands.example.com --to obx:8080
volumes:
- caddy-data:/data
volumes:
obx-data:
caddy-data:
Nastavení
OBX_PUBLIC_URL
veřejná adresa vašeho portálu
OBX_SECRET_KEY
dlouhý náhodný klíč (openssl rand -hex 32); dobře ho uschovejte
OBX_SETUP_CODE
volitelně: předem zvolený instalační kód
PORT
port, výchozí 8080
Po instalaci: první spuštění
Otevřete adresu svého portálu v prohlížeči.
Zadejte jednorázový instalační kód. Najdete ho v logu při prvním spuštění (Portál pro webhosting: v data/SETUP-CODE.txt a instalátor ho vyplní za vás), nebo ho předem nastavíte pomocí OBX_SETUP_CODE.
Vyplňte svou firmu a první značku a zvolte si vlastní heslo. Výchozí heslo nikdy neexistuje.
Instalační kód zajistí, že si nikdo jiný čerstvě nainstalovaný portál nepřivlastní.
Vlastní doména
Použijte subdoménu jako prodejci.vaseznacka.cz nebo b2b.vaseznacka.cz. Prodejci pak vidí vaše jméno a adresa zůstane stejná, i když změníte hosting.
Tři edice, jeden portál
Tři edice dělají totéž a mají stejnou administraci i stejný portál pro prodejce. Zvolte tu, která sedí k vašemu hostingu; změnit ji můžete později. Zobrazit implementace.