Quick Start – Cloud4You OCS¶

Ta instrukcja pokazuje krok po kroku, jak rozpocząć pracę z Cloud4You OCS (Object Cloud Storage).

Jeżeli chcesz po prostu wysłać kilka plików, najłatwiej skorzystać z OCS Browsera.

Jeżeli chcesz podłączyć aplikację, serwer, skrypt lub wykonywać operacje z terminala, użyj AWS CLI albo innego klienta zgodnego z S3 API.

Co będzie potrzebne?¶

Do połączenia z Cloud4You OCS potrzebujesz:

Parametr	Wartość
Endpoint	`https://s3.cloud4you.pl`
Region	`eu-pl-1`
Access Key ID	otrzymany klucz dostępowy
Secret Access Key	otrzymany klucz tajny

Zalecamy korzystanie z głównego endpointu https://s3.cloud4you.pl.

Access Key ID i Secret Access Key otrzymujesz podczas tworzenia danych dostępowych do usługi.

Nie udostępniaj Secret Access Key innym osobom.

Nie umieszczaj kluczy dostępowych na zrzutach ekranu, w zgłoszeniach ani w publicznych plikach konfiguracyjnych.

Najprościej – OCS Browser¶

Jeżeli chcesz przeglądać buckety i pliki z poziomu przeglądarki, nie musisz niczego instalować.

Otwórz OCS Browser

Wprowadź:

Access Key ID
Secret Access Key

Następnie kliknij:

Connect

Endpoint i region są ustawiane automatycznie.

Po zalogowaniu zobaczysz buckety, do których ma dostęp użyty klucz.

Co to jest bucket?¶

Bucket jest głównym kontenerem na dane.

Najprościej myśleć o nim jak o głównym katalogu.

Przykład:

firma-backup

W środku mogą znajdować się obiekty prezentowane w panelu jako pliki i foldery:

firma-backup
├── dokumenty
│   ├── umowa.pdf
│   └── faktura.pdf
└── backup
    └── serwer01.tar.gz

W OCS pliki są technicznie nazywane obiektami.

Instalacja AWS CLI¶

AWS CLI jest klientem wiersza poleceń obsługującym S3 API.

Możesz używać go również z Cloud4You OCS.

Jeżeli masz już AWS CLI, przejdź od razu do sekcji Konfiguracja AWS CLI.

Windows¶

Otwórz PowerShell.

Uruchom:

irm https://awscli.amazonaws.com/v2/install.ps1 | iex

Po zakończeniu zamknij i ponownie otwórz PowerShell.

Sprawdź instalację:

aws --version

Powinieneś otrzymać informację podobną do:

aws-cli/2.x.x ...

Jeżeli polecenie aws nie jest dostępne od razu, zamknij terminal i uruchom go ponownie.

Linux – Ubuntu / Debian¶

Najpierw zainstaluj wymagane narzędzia:

sudo apt update
sudo apt install -y curl unzip

Następnie pobierz AWS CLI:

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

Rozpakuj:

unzip awscliv2.zip

Zainstaluj:

sudo ./aws/install

Sprawdź:

aws --version

Po poprawnej instalacji możesz usunąć pliki instalacyjne:

rm -rf aws awscliv2.zip

Linux – Rocky Linux / AlmaLinux / RHEL¶

Zainstaluj wymagane narzędzia:

sudo dnf install -y curl unzip

Pobierz AWS CLI:

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

Rozpakuj:

unzip awscliv2.zip

Zainstaluj:

sudo ./aws/install

Sprawdź:

aws --version

Po poprawnej instalacji:

rm -rf aws awscliv2.zip

Linux ARM64¶

Jeżeli korzystasz z systemu Linux na architekturze ARM64, np. niektórych serwerów ARM, zamiast pakietu x86_64 użyj:

curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

Następnie:

aws --version

macOS¶

Otwórz Terminal i uruchom:

curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash

Po instalacji zamknij i ponownie otwórz Terminal.

Sprawdź:

aws --version

Jeżeli chcesz zainstalować AWS CLI dla wszystkich użytkowników systemu:

curl -fsSL https://awscli.amazonaws.com/v2/install.sh | sudo bash -s -- --system

Konfiguracja AWS CLI¶

Zalecamy utworzenie osobnego profilu o nazwie:

cloud4you

Dzięki temu konfiguracja Cloud4You nie nadpisze ewentualnej istniejącej konfiguracji AWS.

Uruchom:

aws configure --profile cloud4you

Program zapyta o cztery wartości:

AWS Access Key ID [None]:
AWS Secret Access Key [None]:
Default region name [None]:
Default output format [None]:

Wpisz:

AWS Access Key ID:        TWÓJ_ACCESS_KEY
AWS Secret Access Key:    TWÓJ_SECRET_KEY
Default region name:      eu-pl-1
Default output format:    json

Przykład:

AWS Access Key ID [None]: TWÓJ_ACCESS_KEY
AWS Secret Access Key [None]: TWÓJ_SECRET_KEY
Default region name [None]: eu-pl-1
Default output format [None]: json

Nie kopiuj prawdziwego Secret Access Key do dokumentacji ani zgłoszenia technicznego.

Endpointu Cloud4You nie wpisujemy w kreatorze aws configure.

Podajemy go w poleceniach jako:

--endpoint-url https://s3.cloud4you.pl

Test połączenia¶

Po konfiguracji wykonaj:

aws s3 ls \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Jeżeli wszystko działa, zobaczysz listę dostępnych bucketów.

Przykład:

2026-08-28 10:15:00 backup-firma
2026-08-28 10:20:00 dokumenty

Jeżeli konto nie ma jeszcze żadnego bucketa, lista może być pusta.

Tworzenie bucketu przez AWS CLI¶

Przykład:

aws s3 mb s3://backup-firma-01 \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  --region eu-pl-1

Po utworzeniu sprawdź listę:

aws s3 ls \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Wyświetlanie zawartości bucketu¶

Aby zobaczyć pliki:

aws s3 ls s3://backup-firma-01/ \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Aby wyświetlić również zawartość podfolderów:

aws s3 ls s3://backup-firma-01/ \
  --recursive \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Wysłanie jednego pliku¶

Załóżmy, że masz plik:

test.txt

Aby wysłać go do bucketu:

aws s3 cp test.txt s3://backup-firma-01/ \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Sprawdź:

aws s3 ls s3://backup-firma-01/ \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Wysłanie pliku do folderu¶

Przykład:

aws s3 cp faktura.pdf s3://backup-firma-01/dokumenty/faktura.pdf \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Po wykonaniu polecenia obiekt będzie widoczny w:

dokumenty/faktura.pdf

Wysłanie całego katalogu¶

Jeżeli masz lokalny katalog:

dokumenty/

i chcesz przesłać całą jego zawartość:

aws s3 cp ./dokumenty/ s3://backup-firma-01/dokumenty/ \
  --recursive \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Synchronizacja katalogu¶

Do regularnego przesyłania danych wygodniejsze jest polecenie:

aws s3 sync ./dokumenty/ s3://backup-firma-01/dokumenty/ \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

AWS CLI porówna lokalną zawartość z zawartością bucketu i prześle potrzebne pliki.

Polecenie sync bez dodatkowych opcji nie usuwa automatycznie plików znajdujących się tylko po stronie docelowej.

Pobieranie pliku¶

Aby pobrać plik:

aws s3 cp s3://backup-firma-01/dokumenty/faktura.pdf ./faktura.pdf \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Plik zostanie zapisany w bieżącym katalogu.

Pobieranie całego katalogu¶

aws s3 cp s3://backup-firma-01/dokumenty/ ./dokumenty/ \
  --recursive \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Usuwanie pojedynczego pliku¶

Aby usunąć obiekt:

aws s3 rm s3://backup-firma-01/test.txt \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Przed wykonaniem polecenia upewnij się, że wskazujesz właściwy plik.

Usuwanie wielu plików¶

Możliwe jest usunięcie całej zawartości wskazanej ścieżki:

aws s3 rm s3://backup-firma-01/stare-dane/ \
  --recursive \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Uwaga: --recursive oznacza operację na całej zawartości wskazanej ścieżki. Sprawdź polecenie przed naciśnięciem Enter.

Usuwanie bucketa¶

Bucket musi być pusty.

Aby usunąć pusty bucket:

aws s3 rb s3://backup-firma-01 \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Jeżeli bucket nadal zawiera obiekty, operacja zakończy się błędem.

Generowanie czasowego linku do pliku¶

Możesz wygenerować czasowy link, który pozwoli pobrać konkretny plik bez przekazywania Access Key i Secret Access Key.

Przykład linku ważnego przez 1 godzinę:

aws s3 presign s3://backup-firma-01/dokumenty/faktura.pdf \
  --expires-in 3600 \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  --region eu-pl-1

Polecenie zwróci adres URL.

Możesz przekazać go odbiorcy.

Po upływie czasu ważności link przestanie działać.

Każda osoba posiadająca aktywny link może uzyskać dostęp do wskazanego obiektu do czasu wygaśnięcia linku.

Gdzie AWS CLI zapisuje klucze?¶

Po użyciu:

aws configure --profile cloud4you

AWS CLI zapisuje konfigurację lokalnie na komputerze użytkownika.

Linux i macOS:

~/.aws/credentials
~/.aws/config

Windows:

%USERPROFILE%\.aws\credentials
%USERPROFILE%\.aws\config

Przykładowy plik credentials:

[cloud4you]
aws_access_key_id = TWÓJ_ACCESS_KEY
aws_secret_access_key = TWÓJ_SECRET_KEY

Plik ten zawiera dane dostępowe.

Nie wysyłaj go innym osobom i nie umieszczaj go w publicznym repozytorium Git.

Sprawdzenie konfiguracji¶

Aby zobaczyć skonfigurowane profile:

aws configure list-profiles

Powinien pojawić się między innymi:

cloud4you

Aby sprawdzić konfigurację profilu:

aws configure list --profile cloud4you

Secret Access Key zostanie zamaskowany.

Najczęstsze błędy¶

`InvalidAccessKeyId`¶

Najczęściej oznacza niepoprawny Access Key ID.

Sprawdź konfigurację:

aws configure --profile cloud4you

`SignatureDoesNotMatch`¶

Najczęstsze przyczyny:

niepoprawny Secret Access Key,
błędny region,
nieprawidłowy czas systemowy na komputerze lub serwerze.

Dla Cloud4You OCS użyj regionu:

eu-pl-1

`AccessDenied`¶

Połączenie działa, ale użyty klucz nie ma uprawnień do wykonania danej operacji.

Przykładowo konto może mieć prawo do odczytu obiektów, ale nie do tworzenia nowych bucketów.

AWS CLI nie może połączyć się z endpointem¶

Sprawdź, czy używasz:

https://s3.cloud4you.pl

Test:

aws s3 ls \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Jeżeli nadal występuje problem, sprawdź połączenie z Internetem, DNS oraz lokalny firewall/proxy.

Bucket już istnieje¶

Wybierz inną nazwę.

Przykład:

backup-firma-01

zamiast:

backup

Krótka ściąga AWS CLI¶

Lista bucketów¶

aws s3 ls \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Utworzenie bucketu¶

aws s3 mb s3://NAZWA-BUCKETA \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  --region eu-pl-1

Lista plików¶

aws s3 ls s3://NAZWA-BUCKETA/ \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Upload¶

aws s3 cp plik.txt s3://NAZWA-BUCKETA/ \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Download¶

aws s3 cp s3://NAZWA-BUCKETA/plik.txt ./plik.txt \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Synchronizacja katalogu¶

aws s3 sync ./dane/ s3://NAZWA-BUCKETA/dane/ \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Usunięcie pliku¶

aws s3 rm s3://NAZWA-BUCKETA/plik.txt \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl

Co wybrać?¶

Jeżeli chcesz tylko ręcznie zarządzać plikami:

OCS Browser – panel WWW

https://ocs.cloud4you.pl

Jeżeli konfigurujesz serwer, skrypt lub automatyzację:

AWS CLI / S3 API

Jeżeli konfigurujesz aplikację zgodną z S3, najczęściej potrzebujesz tylko:

Endpoint:          https://s3.cloud4you.pl
Region:            eu-pl-1
Access Key ID:     TWÓJ_ACCESS_KEY
Secret Access Key: TWÓJ_SECRET_KEY

Bezpieczeństwo¶

Na koniec kilka prostych zasad:

Secret Access Key traktuj jak hasło.
Nie wysyłaj kluczy w zgłoszeniach technicznych.
Nie umieszczaj kluczy na zrzutach ekranu.
Nie zapisuj kluczy w publicznym repozytorium Git.
Przed usunięciem obiektów sprawdź nazwę bucketa i ścieżkę.
Przy poleceniach zawierających --recursive sprawdź dwa razy, czego dotyczą.
Do standardowych połączeń używaj głównego endpointu https://s3.cloud4you.pl.

Pomoc¶

Dokumentacja:

https://docs.cloud4you.pl

Portal pomocy:

https://support.cloud4you.pl

Quick Start – Cloud4You OCS¶

Co będzie potrzebne?¶

Najprościej – OCS Browser¶

Co to jest bucket?¶

Instalacja AWS CLI¶

Windows¶

Linux – Ubuntu / Debian¶

Linux – Rocky Linux / AlmaLinux / RHEL¶

Linux ARM64¶

macOS¶

Konfiguracja AWS CLI¶

Test połączenia¶

Tworzenie bucketu przez AWS CLI¶

Wyświetlanie zawartości bucketu¶

Wysłanie jednego pliku¶

Wysłanie pliku do folderu¶

Wysłanie całego katalogu¶

Synchronizacja katalogu¶

Pobieranie pliku¶

Pobieranie całego katalogu¶

Usuwanie pojedynczego pliku¶

Usuwanie wielu plików¶

Usuwanie bucketa¶

Generowanie czasowego linku do pliku¶

Gdzie AWS CLI zapisuje klucze?¶

Sprawdzenie konfiguracji¶

Najczęstsze błędy¶

InvalidAccessKeyId¶

SignatureDoesNotMatch¶

AccessDenied¶

AWS CLI nie może połączyć się z endpointem¶

Bucket już istnieje¶

Krótka ściąga AWS CLI¶

Lista bucketów¶

Utworzenie bucketu¶

Lista plików¶

Upload¶

Download¶

Synchronizacja katalogu¶

Usunięcie pliku¶

Co wybrać?¶

Bezpieczeństwo¶

Pomoc¶

`InvalidAccessKeyId`¶

`SignatureDoesNotMatch`¶

`AccessDenied`¶