oscloud-docs/docs/apps/surfer.md

Surfer App

Surfer na OSCloud

Surfer je aplikace pro snadnou správu souborů a hosting statických webových stránek na OSCloud. Je ideální pro rychlé nasazení webových projektů, dokumentací nebo jednoduchých webových aplikací.

1. Přístup k Surferu

Přihlašte se do administrace OSCloud a zvolte aplikaci Surfer z katalogu aplikací. Instalaci provádíme za zákazníka a aplikace bude po dokončení automaticky dostupná na subdoméně zákazníka, například firmy.oscloud.cz.

2. Přístup k souborům

Jakmile je aplikace Surfer nainstalovaná, získá zákazník přístup ke správě souborů prostřednictvím jednoduchého webového rozhraní. Toto rozhraní umožňuje nahrávat, stahovat, mazat a organizovat soubory na jeho subdoméně. Případné úpravy a asistenci s nahráváním prvních souborů zajišťujeme také my, aby zákazník nemusel mít technické znalosti k obsluze aplikace.

3. Další možnosti správy souborů

Existují 4 způsoby, jak spravovat soubory v aplikaci Surfer:

• Webové rozhraní
• CLI nástroj
• WebDAV endpoint pro správu souborů ve vašem lokálním správci souborů.
• SFTP

Webové rozhraní

Soubory můžete nahrávat a spravovat přes webové rozhraní na adrese https://[vaše-doména]/_admin. Zde můžete také spravovat strukturu složek a jednotlivé soubory.

CLI nástroj

Pokud preferujete práci z příkazového řádku, můžete využít CLI nástroj pro Surfer. Nejprve ho nainstalujte pomocí npm:

npm -g install cloudron-surfer

Přihlaste se pomocí přístupového tokenu vytvořeného v administraci Surferu:

surfer config --server <doména-aplikace> --token

Nahrajte soubory:

surfer put index.html favicon.ico /

Nahrajte adresář (příkaz /* znamená, že obsah adresáře build bude zkopírován do kořenového adresáře Surferu):

surfer put build/* /

Získání nápovědy:

$ surfer
Usage: surfer [options] [command]

Options:
  -V, --version                output the version number
  -h, --help                   display help for command

Commands:
  login                        Set default server
  logout                       Unset default server
  config|configure [options]   Configure default server
  put [options] <file|dir...>  Uploads a list of files or dirs to the destination. The last argument is destination dir
  get [options] [file|dir]     Get a file or directory listing
  del [options] <file>         Delete a file or directory
  help [command]               display help for command

WebDAV

WebDAV je rozšíření HTTP protokolu, které umožňuje vzdálenou správu souborů. WebDAV sdílení můžete připojit pomocí vašeho správce souborů.

URI schémata se liší na běžných platformách.

Platform	URI
Windows	https://[appdomain]/_webdav/
Mac	https://[appdomain]/_webdav/
Gnome	davs://[appdomain]/_webdav/
KDE	webdavs://[appdomain]/_webdav/

!!! note "Přístup přes WebDAV" Pro přístup přes WebDAV použijte přístupový token vytvořený v administraci Surferu jako heslo.

Na Linuxu můžete použít knihovnu Davfs2 pro lokální připojení sdílené složky:

mount -t davfs https://[doména-aplikace]/_webdav/ /mnt/bod

SFTP

Soubory lze nahrávat pomocí SFTP klienta jako je FileZilla. Podrobnosti o SFTP přístupu najdete v administraci aplikace.

!!! note "Přístup přes SFTP" Přístup přes SFTP pro uživatele bez administrátorských práv lze udělit prostřednictvím rozhraní pro správ

Ovládání přístupu

Přístup na stránky lze řídit prostřednictvím stránky Nastavení. K dispozici jsou tři možnosti:

• Veřejný přístup (pro všechny) – kdokoli může web zobrazit.
• Přístup omezený heslem – kdokoli s heslem může web zobrazit.
• Omezený přístup pro uživatele – pouze uživatelé s přihlášením na OSCloud mohou web zobrazit.

CI/CD integrace

Můžete nastavit svůj CI/CD systém tak, aby automaticky nahrával statické soubory do aplikace Surfer pomocí CLI nástroje následujícím způsobem:

• Nejprve vytvořte Access Token v aplikaci Surfer z nabídky Nastavení.

• Nainstalujte CLI nástroj Surfer jako součást CI/CD pipeline.

• Nahrajte artefakty (v níže uvedeném příkladu složku dist/):

surfer put --token api-7e6d90ff-5825-4ebe-a85b-a68795055955 --server surfer.oscloud.cz dist/* /