Pentru a monta un bucket compatibil cu S3 în Nextcloud, activați aplicația încorporată de asistență pentru stocarea externă, adăugați o intrare de stocare Amazon S3 în setările de stocare externă ale administratorului și furnizați acreditările bucketului, plus detaliile punctului final al furnizorului. Nextcloud utilizează backend-ul Amazon S3 pentru servicii compatibile; nu este nevoie să instalați o aplicație separată pentru fiecare furnizor S3. Numele exact de gazdă, regiunea și setările stilului căii depind de furnizorul de stocare a obiectelor.
Acest ghid respectă documentația actuală de administrare Nextcloud pentru backend-urile S3 și de stocare externă, verificată la 6 octombrie 2026. Etichetele pot diferi ușor între versiunile de server și teme. O montare poate fi accesibilă, dar se comportă diferit față de un folder Nextcloud local, în special atunci când fișierele sunt modificate direct în bucket.
Ce ar trebui să verificați înainte de a adăuga găleata?
Confirmați aceste detalii cu furnizorul dvs. S3 înainte de a deschide setările Nextcloud:
- Numele bucket-ului și acreditările pentru o cheie de acces.
- Numele de gazdă generic al punctului final S3 al furnizorului, cum ar fi
s3.example.net. Folosiți punctul final în sine, nu o adresă URL specifică bucket-ului care conține deja numele bucket-ului. - Regiunea sau regiunea de semnare, dacă furnizorul solicită una.
- Dacă cererile ar trebui să utilizeze stilul găzduit virtual (
https://bucket.endpoint/) sau stilul căii ( https://endpoint/bucket). - Portul HTTPS, în mod normal 443, și dacă serverul dvs. poate ajunge la acel punct final prin firewall-ul și DNS-ul său.
Creați o cheie de acces dedicată pentru această montare și limitați permisiunile acesteia la bucket-ul și acțiunile de care are nevoie. Nu lipiți secrete într-un tichet, o captură de ecran sau un istoric shell. Configurarea S3 a Nextcloud necesită un ID de cheie de acces și o cheie de acces secretă; aceasta nu validează fiecare politică de permisiuni specifică furnizorului pentru dvs.
Este același lucru cu a face din S3 Nextcloud spațiul de stocare principal?
Nu. O montare de stocare externă expune un bucket existent ca folder în Nextcloud. Este utilă atunci când doriți să răsfoiți sau să gestionați fișiere dintr-un bucket, menținând în același timp bucket-ul accesibil altor instrumente S3. Stocarea principală de obiecte este o arhitectură diferită la nivel de server, cu ipoteze operaționale diferite. Dacă trebuie să alegeți între ele, consultați documentația de stocare principală de obiecte Nextcloud înainte de a modifica un design de date de producție.
Cum adaugi montura compatibilă cu S3 în interfața web?
1. Activați suportul pentru stocarea externă
Conectați-vă ca administrator Nextcloud, deschideți Aplicații și activați aplicația de asistență pentru stocarea externă inclusă în pachet . Aceasta este inclusă în Nextcloud, dar poate fi dezactivată în mod implicit. Dacă este deja activată, continuați cu setările de stocare.
2. Deschideți pagina Stocare externă a administratorului
Deschide meniul profilului tău, alege Setări , apoi găsește Stocare externă în secțiunea Administrare. Această pagină este pentru monturile configurate de administrator. Un spațiu de stocare pe care un utilizator individual îl configurează în setările personale este disponibil numai pentru acel utilizator; un montaj de administrator poate fi disponibil pentru utilizatorii și grupurile selectate.
3. Creați o montare și alegeți backend-ul S3
În noul rând, introduceți un nume simplu de folder , de exemplu Archive. Acesta devine numele vizibil al folderului în Nextcloud și trebuie să fie un nume, nu o cale; nu adăugați bare oblice. În selectorul de tip de stocare, alegeți Amazon S3 . Sub Autentificare, alegeți Cheie de acces .
4. Introduceți bucket-ul și acreditările
Introduceți numele exact al bucket-ului, ID-ul cheii de acces și cheia secretă de acces de la furnizorul dvs. Tratați secretul ca o parolă. Documentația Nextcloud menționează că numele bucket-urilor pentru acest backend trebuie să îndeplinească cerințele de denumire AWS S3, chiar și atunci când serviciul este găzduit în altă parte; sublinierile nu sunt acceptate. Dacă numele bucket-ului furnizorului include un subliniere, verificați dacă furnizorul oferă un nume de bucket compatibil înainte de a depana acreditările.
5. Setați punctul final, regiunea și stilul cererii
Pentru S3 găzduit de Amazon, specificați regiunea corectă. Pentru un serviciu non-Amazon, setați numele de gazdă generic al furnizorului. Utilizați valorile punctului final și ale regiunii publicate de furnizor; nu există o valoare universală a regiunii pentru fiecare produs compatibil cu S3.
| Setare | Ce să introduceți |
|---|
| Nume gazdă | Punctul final generic, de exemplu s3.example.net, fără subdomeniul sau calea bucket-ului. |
| Port | Portul TLS al furnizorului; de obicei 443. |
| Activează SSL | Lăsați activat când endpoint-ul acceptă HTTPS. Folosiți un certificat de încredere. |
| Regiune | Regiunea de semnare a furnizorului, atunci când este necesar; păstrați valoarea recomandată de furnizor pentru serviciile compatibile. |
| Activează stilul căii | Activați numai dacă endpoint-ul necesită solicitări sub formă de formular endpoint/bucketîn loc de bucket.endpoint. |
| Autentificare moștenită (v2) | Omiteți opțiunea, cu excepția cazului în care furnizorul dvs. solicită în mod specific versiunea mai veche a semnăturii. Implicit este v4. |
Ghidul S3 actual al Nextcloud recomandă în mod specific utilizarea numelui generic de gazdă al endpoint-ului pentru stocarea non-Amazon. De asemenea, descrie adresarea în stil de cale ca fiind dependentă de furnizor. Nu comutați stilul de cale ca o presupunere dacă puteți obține modul de adresare așteptat din documentația S3 a furnizorului.
6. Restricționați cine poate folosi montura
Folosește „Disponibil pentru” pentru a atribui doar utilizatorii sau grupurile Nextcloud vizate. O montare configurată de administrator ar putea fi disponibilă pe scară largă. De asemenea, verifică opțiunile de montare după salvare: modul doar citire și controalele de partajare pot fi potrivite pentru arhive sau bucket-uri partajate. Comportamentul de partajare poate afecta cine poate expune fișiere prin Nextcloud, așa că setează-l în mod deliberat.
7. Confirmați că Nextcloud se poate conecta
Când câmpurile obligatorii sunt valide, rândul de stocare este salvat automat. Un indicator de stare verde înseamnă că Nextcloud poate utiliza stocarea configurată; roșu sau galben indică faptul că conexiunea sau configurația necesită atenție. Pagina de administrare poate marca temporar o stocare defectă ca indisponibilă timp de zece minute. Faceți clic pe pictograma sa de stare sau reîncărcați pagina pentru a declanșa o altă verificare după corectarea unei valori.
8. Testează cu un fișier inofensiv
Deschideți Fișiere ca utilizator care are acces la montare. Confirmați că folderul apare, creați sau încărcați un mic fișier de test, descărcați-l din nou și ștergeți-l dacă bucket-ul este destinat să fie scris. Dacă montarea este destinată să fie doar citire, testați dacă utilizatorii pot citi fișiere și verificați dacă scrierile sunt blocate. Un indicator verde în sine nu confirmă că fiecare permisiune a utilizatorului sau comportamentul de citire/scriere intenționat este corect.
Cum poți verifica montarea din linia de comandă?
Pentru instalările în care administrați serverul, Nextcloud oferă și occcomenzi pentru stocarea externă. Rulați comenzi din directorul de instalare Nextcloud și utilizați contul de server web corespunzător sistemului dvs. Pe multe instalări Linux este www-data, dar instalările de pachete și containere pot diferi.
sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>
Înlocuiți <mount_id>cu ID-ul afișat de comanda list. O verificare reușită confirmă faptul că Nextcloud poate stabili conexiunea configurată în acel moment. Pentru Nextcloud AIO sau o altă implementare de container, utilizați metoda documentată a implementării respective de a se executa occîn interiorul containerului aplicației, în loc să copiați comanda gazdă neschimbată.
De ce ar putea montarea să eșueze chiar și atunci când valorile par corecte?
| Simptom | Primele verificări |
|---|
| Stare roșie sau galbenă | Verificați ortografia bucket-ului, cheia și secretul, numele gazdei endpoint-ului, portul TLS, DNS-ul, ieșirea din firewall și încrederea în certificat. |
| Eroare de semnătură sau de autorizare | Confirmați regiunea de semnare și permisiunile cheii cu furnizorul. Verificați dacă furnizorul necesită adresare în stil de cale. |
| Expirare conexiune | Verificați dacă gazda Nextcloud poate ajunge la endpoint-ul S3 pe portul configurat; accesul prin browser de pe laptop nu dovedește conectivitatea la server. |
| Lipsesc unele foldere sau obiecte | Verificați dacă există bare oblice repetate neacceptate în prefixele obiectelor și luați în considerare rularea unei scanări a spațiului de stocare extern. |
| Funcționează pentru un administrator, dar nu pentru un utilizator. | Verificați opțiunile „Disponibil pentru atribuiri”, apartenența la grup și dacă utilizatorul deschide montarea corectă. |
Când un serviciu utilizează un certificat autosemnat, serverul trebuie să aibă încredere în acel certificat; dezactivarea verificării certificatului nu este un substitut sigur. Manualul actual al Nextcloud avertizează, de asemenea, că delimitatorii repetați, cum ar fi , Photos//cat.pngnu sunt acceptați și că prefixele afectate pot fi ignorate.
Ce se întâmplă când fișierele se modifică direct în bucket?
Nextcloud menține o memorie cache internă pentru fișiere pentru stocarea externă. Dacă un alt instrument adaugă, editează sau șterge obiecte direct în S3, Nextcloud poate să nu vadă imediat modificarea. Ghidul actual pentru Stocarea Externă recomandă rescanări periodice pentru tipurile de stocare fără notificări push. Puteți găsi ID-ul de montare cu files_external:listși rula:
sudo -E -u www-data php occ files_external:scan <mount_id>
Programați o scanare în funcție de actualitatea de care aveți nevoie și de sarcina pe care serverul dvs. o poate gestiona. O scanare nu este același lucru cu notificările instantanee de modificare. Nextcloud documentează, de asemenea, un risc legat de metadate: o rescanare poate interpreta o redenumire externă ca un obiect vechi șters plus un obiect nou, eliminând partajările, etichetele, comentariile și istoricul activităților de pe Nextcloud asociate cu intrarea veche. Din acest motiv, efectuați redenumirile prin Nextcloud atunci când păstrați metadatele respective.
De unde știi că configurarea este completă?
- Montarea S3 afișează o stare verde în pagina Stocare externă a administratorului.
- Utilizatorii din grupul vizat pot vedea montarea, în timp ce utilizatorii neatribuiți nu pot.
- O încărcare, o descărcare și o ștergere de test se comportă conform așteptărilor, altfel scrierile sunt blocate pentru o montare doar în citire.
- Serverul poate descoperi modificările făcute în afara Nextcloud după intervalul de scanare configurat.
- Acreditările sunt stocate doar în configurația Nextcloud și în contul furnizorului, iar accesul este limitat la bucket-ul necesar.
Pentru detalii specifice versiunii, consultați ghidul oficial de stocare externă Nextcloud S3 , ghidul de administrare a stocării externe și referința oficială a comenzii occ . Furnizorii variază în ceea ce privește endpoint-ul, regiunea, permisiunile și cerințele de adresare, așadar documentația lor de configurare S3 rămâne autoritară pentru aceste valori.