Linkurile lungi de partajare din Nextcloud nu inspiră încredere. Un URL precum https://cloud.example.com/index.php/s/aBcDeFg12345678 arată ca ceva trimis de un phisher, e greu de dictat la telefon și se rupe urât pe o foaie tipărită. Dacă îți administrezi singur serverul, poți rezolva asta fără să dai linkurile unui serviciu de scurtare terț: Shortcloud este un plugin pentru Nextcloud care oferă fiecărei partajări publice o adresă scurtă pe domeniul tău și o redirecționează către partajarea reală. Acest tutorial parcurge instalarea, configurarea regulii de rewrite și utilizarea funcțiilor de zi cu zi: linkuri scurte automate pentru partajările noi și vechi, terminații personalizate, domenii scurte suplimentare, coduri QR, partajări expirate care răspund cu 410 Gone și ascunderea /index.php din adrese.
Tot ce urmează provine din documentația produsului. Pentru referința completă, vezi ghidul de utilizare și pagina produsului.
Ce problemă rezolvă
Un link scurt precum cloud.example.com/go/abc1234 e ușor de tastat, ușor de tipărit și pare că aparține organizației tale. Shortcloud creează automat unul pentru fiecare partajare publică nouă prin link — fie că partajarea a fost făcută din interfața web, din clientul desktop sau dintr-un client mobil. Domeniul rămâne al tău, iar redirectorul este propriul tău server, nu un serviciu public de scurtare.
Cerințe preliminare
- Nextcloud 32 până la 34 cu PHP 8.1 sau mai nou.
- O regulă de rewrite în serverul tău web. Pe Apache cu
mod_rewriteșiAllowOverride All, aplicația o scrie singură în.htaccess-ul Nextcloud și o păstrează acolo și după upgrade-uri. Pe nginx sau pe un virtual host, pagina de setări afișează fragmentul pe care trebuie să îl adaugi. - Pentru un domeniu scurt suplimentar: DNS care indică spre server, un certificat TLS și un virtual host (pagina de setări îl arată).
- O cheie de licență din contul tău MediaLab Works — poți începe perioada de probă gratuită de 30 de zile din aplicație.
Pasul 1 — Instalează și activează aplicația
Descarcă arhiva shortcloud-x.y.z.tar.gz din Licenses în contul tău, apoi extrage-o în folderul de aplicații, astfel încât să obții apps/shortcloud/, cu proprietarul utilizatorul serverului web:
cd /var/www/nextcloud/apps
sudo tar -xzf ~/shortcloud-x.y.z.tar.gz
sudo chown -R www-data:www-data shortcloud
Activeaz-o:
sudo -u www-data php occ app:enable shortcloud
O poți activa și din pagina Apps.
Pasul 2 — Activează licența
Deschide Administration settings → Shortcloud → License, lipește cheia de licență și salvează. Aplicația contactează serverul de licențe, leagă cheia de această instanță Nextcloud și afișează licența ca Active.
De știut: licența este verificată o dată pe zi. Fără internet, aplicația funcționează încă 7 zile după ultima verificare reușită; după aceea se oprește până când poate verifica din nou. Fără o licență validă nu se șterge nimic — fiecare link scurt este păstrat și funcționează din nou imediat ce licența este validă, iar între timp rămâne utilizabilă doar secțiunea License.
Pasul 3 — Verifică dacă regula de rewrite funcționează
Nextcloud nu permite unei aplicații terțe să răspundă singură la /go/…, așa că o regulă de rewrite trimite acele cereri către aplicație. Pe Apache cu un .htaccess care poate fi scris, aplicația o adaugă la prima cerere după activare. Deschide Administration settings → Shortcloud: pagina testează adresa scurtă prin HTTP și îți spune dacă regula funcționează, oferă Install rewrite rule și afișează fragmentul pentru nginx sau pentru un virtual host.
Blocul pe care îl scrie arată astfel:
# BEGIN Shortcloud
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteRule ^go/(.*)$ apps/shortcloud/go.php?slug=$1 [END,QSA]
</IfModule>
# END Shortcloud
Blocul supraviețuiește la occ upgrade și occ maintenance:update:htaccess; dacă un update de nucleu înlocuiește .htaccess, aplicația îl pune la loc. Din terminal poți folosi și occ shortcloud:setup (cu --check și --remove).
Pasul 4 — Reglează setările
Aceeași pagină de setări controlează comportamentul scurtării:
| Setare | Semnificație |
|---|---|
| Pause | Nu se creează linkuri scurte noi; cele existente continuă să funcționeze. |
| Automatic short links | Un link pentru fiecare partajare publică nouă prin link. |
| Path prefix | /go/ implicit; schimbarea lui rescrie regula. |
| Length of random endings | 7 implicit, fără caractere ușor de confundat. |
| Who may create | Toată lumea sau doar grupurile alese. Administratorii pot întotdeauna. |
| Targets | Doar acest Nextcloud (implicit), o listă de hosturi sau orice adresă. Linkurile de partajare sunt mereu permise. |
| Reserved endings | Nume care nu sunt niciodată atribuite. |
| Custom short domains | Hosturi suplimentare, cu un prefix opțional. |
| Pretty URLs | Ascunde /index.php din fiecare adresă (adresele vechi continuă să funcționeze). |
Un punct de plecare rezonabil pentru majoritatea celor care își găzduiesc singuri serverul: lasă Targets pe Only this Nextcloud (astfel domeniul tău nu devine niciodată un redirector deschis), păstrează prefixul implicit și activează Pretty URLs.
Pasul 5 — Partajează fișiere și copiază linkul scurt
Partajează un fișier sau un folder prin link ca de obicei, apoi deschide meniul … al partajării prin link din bara laterală de partajare și alege Copy short link. Short link… îți permite să schimbi terminația și afișează codul QR — util pentru materiale tipărite, slide-uri sau un afiș la un eveniment comunitar.
Și albumele contează: linkurile publice de album din aplicațiile Photos și Memories primesc la fel linkuri scurte.
Pasul 6 — Oferă linkuri scurte partajărilor vechi
Partajările create înainte de instalarea aplicației nu au încă un link scurt. Completează-le:
sudo -u www-data php occ shortcloud:backfill --dry-run
sudo -u www-data php occ shortcloud:backfill
Poți limita rularea la un singur utilizator cu --user uid și încearcă întotdeauna mai întâi --dry-run.
Pasul 7 — Terminații personalizate, domenii suplimentare și linkuri manuale
- Terminații personalizate: domeniul este fix, restul este al tău — de exemplu
/go/annual-report. - Domenii scurte suplimentare: de exemplu
https://cc.link/abc1234, servit de același server. Îndreaptă DNS-ul lui spre server, obține un certificat, adaugă-l la Custom short domains, apoi adaugă virtual hostul pe care îl arată pagina. Nu trebuie să fie un domeniu de încredere Nextcloud: acolo răspunde doar redirectorul. - Orice adresă poate fi scurtată din pagina Shortcloud (meniul de sus), în limitele politicii pe care o stabilești. Pagina îți listează linkurile cu vizite și ultima vizită și îți permite să pui pe pauză sau să ștergi un link.
- Din terminal:
occ shortcloud:add <url> --user uid [--slug name],occ shortcloud:list,occ shortcloud:delete <id|slug>. Există și un API OCS pentru scripturi.
Sfaturi și depanare
- Linkurile scurte dau „404 Not Found”. Regula de rewrite nu este activă. Pagina de setări și Administration settings → Overview spun asta. Pe Apache verifică
mod_rewriteșiAllowOverride All; pe nginx adaugă fragmentul din pagina de setări. - Regula a dispărut după un update Nextcloud. Este restaurată la următorul update al aplicației, la prima cerere după schimbarea versiunii sau de verificarea zilnică;
occ shortcloud:setupo restaurează imediat. - Un link scurt răspunde „gone”. Partajarea lui a fost ștearsă sau a expirat — aplicația răspunde cu 410 Gone în loc să redirecționeze către ceva ce nu mai există. Acesta este comportamentul dorit, nu un bug.
- „Short links to this site are not allowed” la scurtarea unei adrese: țintele externe sunt refuzate implicit. Permite hostul (sau orice adresă) la Targets.
- „Short links to this address are blocked” pentru un host permis: adresa se află pe lista anti-abuz. Aplicația nu are o listă proprie; serverul de licențe poate livra o listă semnată de hosturi și fragmente de URL cunoscute ca folosite pentru phishing sau malware, care se aplică peste politica ta. Este goală implicit — scurtătoare precum bit.ly nu sunt blocate, pentru că multe echipe le partajează legitim — și se completează doar pentru ținte care au fost chiar abuzate. Dacă o adresă de care ai nevoie este refuzată, scrie-ne prin pagina de contact.
- Confidențialitate: pentru fiecare link, aplicația stochează proprietarul, domeniul, terminația, ținta, partajarea din care face parte, o etichetă (numele fișierului), starea, numărul de vizite și momentul ultimei vizite. Nu se stochează date despre vizitatori, așa că poți lăsa contorul de vizite activat fără griji.
- Pauza: punerea pe pauză a unui singur link sau oprirea creării pentru toată lumea nu strică niciodată linkurile existente. Dezactivarea aplicației păstrează toate linkurile stocate; reactivarea le readuce neschimbate.
- Limitări pe grupuri: dacă doar unele echipe ar trebui să creeze linkuri, restricționează crearea la grupurile alese — administratorii pot întotdeauna.
Concluzie
Un link scurt pe domeniul tău este o schimbare mică cu un câștig real: URL-uri de partajare în care oamenii au încredere suficientă ca să le dea click, să le tipărească și să le scrie de mână. Shortcloud ține redirectorul pe serverul tău, creează automat linkuri scurte pentru partajările noi, le completează pe cele vechi și rămâne corect când o partajare nu mai există. Instalează-l, confirmă regula de rewrite pe pagina de setări, iar următorul link pe care îl partajezi va fi mult mai ușor de transmis. Mai multe informații găsești în Bază de cunoștințe și în FAQ; changelog arată ce s-a schimbat în fiecare versiune.