# Surfer - Oscloud Docs
Oscloud je váš osobní cloud a hosting webových aplikací.

Skip to content

# 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/* /