Open Brand Exchangev0.1Wersja 0.1. Wersja 0.1 jest już wydana. Specyfikacja i oprogramowanie są do swobodnego użytku.
Hosting
Uruchom, gdzie chcesz. Płać tylko za hosting.
Jeden portal to jedna firma markowa na jednym serwerze. Sam wybierasz, jak go prowadzić: od całkowitego zlecenia po pełną samodzielność. Poniżej od najprostszego do najbardziej technicznego.
Najprościej: firma hostuje Twój portal, aktualizuje go i pomaga w konfiguracji. Ponieważ każdy portal mówi tym samym standardem, możesz później przejść do innego dostawcy albo na własny hosting.
Photopilot
Product photography software for fashion and lifestyle. Hosts a brand portal on your own domain and publishes through OBX.
Tu może znaleźć się każda firma hostingowa, agencja czy producent oprogramowania. Warunki są takie same dla wszystkich:
Twój portal przechodzi testy zgodności
marka może wyeksportować wszystkie dane i zdjęcia i odejść
własne ceny i warunki publikujesz na własnej stronie
Otwórz pull request w repozytorium strony ze swoimi danymi w src/data/providers.json. Dostawcy są wymienieni alfabetycznie. openbrandexchange/website
2. Jednym kliknięciem
Własny portal na własnym koncie, bez zarządzania serwerem.
Portal dla Cloudflare
Działa na Cloudflare Workers, z D1 jako bazą danych i R2 na obrazy. Kliknij przycisk, zaloguj się do Cloudflare i wykonaj kolejne kroki. Portal używany na co dzień wymaga planu Workers Paid (5 dolarów miesięcznie); plan darmowy wystarczy tylko, żeby się rozejrzeć. Wersje internetowe Twoich zdjęć tworzą przeglądarka i narzędzie obx.
Skrypt, który uruchamia Twój portal w Google Cloud Run. Potrzebujesz konta Google Cloud i narzędzia 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
Na hosting WWW, który być może już masz, z PHP i bazą danych. Bez żadnych poleceń:
Pobierz obx-portal-php-<version>.zip z najnowszego wydania.
Rozpakuj go i prześlij folder na hosting przez (S)FTP.
Skieruj swoją (sub)domenę, na przykład sprzedawcy.twojamarka.pl, na folder public.
Umożliw zapis w folderach data i config (uprawnienia 775; jeśli instalator nadal zgłasza brak zapisu, 777).
Otwórz ten adres. Instalator sprawdza serwer i prosi o kod instalacyjny z pliku data/SETUP-CODE.txt, który otwierasz programem FTP. Następnie kliknij „Otwórz kreator konfiguracji“.
Adres cron pokazany przez instalator dodaj jako zadanie cron w panelu hostingu, co 5 minut. Portal działa także bez niego.
Na własnym serwerze lub w dowolnej chmurze uruchamiającej kontenery. Jedno polecenie:
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
Albo od razu z HTTPS, przez 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:
Ustawienia
OBX_PUBLIC_URL
publiczny adres Twojego portalu
OBX_SECRET_KEY
długi losowy klucz (openssl rand -hex 32); przechowuj go bezpiecznie
OBX_SETUP_CODE
opcjonalnie: kod konfiguracji wybrany z góry
PORT
port, domyślnie 8080
Po instalacji: pierwsze uruchomienie
Otwórz adres swojego portalu w przeglądarce.
Wpisz jednorazowy kod instalacyjny. Znajdziesz go w logu przy pierwszym uruchomieniu (Portal na hosting WWW: w data/SETUP-CODE.txt, a instalator wpisuje go za Ciebie) albo ustawisz z góry przez OBX_SETUP_CODE.
Podaj swoją firmę i pierwszą markę i wybierz własne hasło. Nigdy nie ma hasła domyślnego.
Kod konfiguracji sprawia, że nikt inny nie przejmie świeżo zainstalowanego portalu.
Własna domena
Użyj subdomeny, np. sprzedawcy.twojamarka.pl lub b2b.twojamarka.pl. Sprzedawcy widzą wtedy Twoją nazwę, a adres pozostaje ten sam, gdy zmienisz hosting.
Trzy edycje, jeden portal
Trzy edycje robią to samo i mają ten sam panel administracyjny oraz ten sam portal dla sprzedawców. Wybierz tę, która pasuje do Twojego hostingu; zmienić możesz później. Zobacz implementacje.