Shortcloud — instalare și linkuri scurte în Nextcloud

Instalare

  1. Autentifică-te în contul MediaLab Works, deschide Licențe și descarcă arhiva aplicației shortcloud-x.y.z.tar.gz (disponibilă pe abonament activ, licență lifetime în fereastra de actualizări sau în perioada de probă de 30 de zile).
  2. Dezarhiveaz-o în folderul apps/ (sau custom_apps/) al Nextcloud, ca să obții apps/shortcloud/, cu proprietar 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
  3. Activeaz-o: sudo -u www-data php occ app:enable shortcloud, sau din pagina Aplicații.
  4. Deschide Setări de administrare → Shortcloud → Licență, 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 Activă.

Licență

Licența se verifică o dată pe zi. Fără internet aplicația funcționează 7 zile de la ultima verificare reușită; după aceea se oprește până poate verifica din nou.

Fără licență validă aplicația este oprită: sarcinile de fundal (sincronizarea albumelor, verificarea regulii) nu rulează, paginile, adresele scurte și API-ul ei răspund cu motivul, iar doar secțiunea Licență funcționează (de acolo pornești perioada de probă, introduci cheia sau reînnoiești). Nimic nu se șterge: toate linkurile scurte se păstrează și funcționează din nou imediat ce licența e validă.

Configurare

Regula de rescriere. Nextcloud nu permite unei aplicații terțe să răspundă singură la /go/…, așa că o regulă de rescriere trimite aceste cereri către aplicație. Pe Apache, cu .htaccess care poate fi scris, aplicația o scrie la prima cerere după activare. Deschide Setări de administrare → Shortcloud: pagina testează adresa scurtă prin HTTP și spune dacă regula funcționează, oferă Instalează regula de rescriere și arată fragmentul pentru nginx sau pentru un virtual host. Blocul scris:

# BEGIN Shortcloud
<IfModule mod_rewrite.c>
  RewriteEngine on
  RewriteRule ^go/(.*)$ apps/shortcloud/go.php?slug=$1 [END,QSA]
</IfModule>
# END Shortcloud

Blocul rezistă la occ upgrade și occ maintenance:update:htaccess; dacă o actualizare Nextcloud înlocuiește .htaccess, aplicația îl pune la loc. Din terminal: occ shortcloud:setup (--check, --remove).

Setări în aceeași pagină:

Setare Ce face
Pauză Nu se mai creează linkuri scurte; cele existente funcționează.
Linkuri scurte automate Câte unul pentru fiecare partajare publică nouă.
Prefix Implicit /go/; dacă îl schimbi, regula se rescrie.
Lungimea terminațiilor aleatoare Implicit 7, fără caractere care se confundă.
Cine poate crea Toată lumea sau doar anumite grupuri. Administratorii pot oricând.
Ținte Doar acest Nextcloud (implicit), o listă de domenii sau orice adresă. Linkurile de partajare sunt mereu permise.
Terminații rezervate Nume care nu se dau niciodată.
Domenii scurte personalizate Domenii suplimentare, cu prefix opțional.
URL-uri curate Ascunde /index.php din toate adresele (adresele vechi funcționează în continuare).

Un domeniu scurt suplimentar: îndreaptă-i DNS-ul spre server, obține un certificat, adaugă-l la Domenii scurte personalizate, apoi adaugă virtual host-ul arătat în pagină. Nu trebuie să fie domeniu de încredere în Nextcloud: acolo răspunde doar redirecționarea.

Folosire zilnică

  • Partajează un fișier sau un dosar prin link, ca de obicei, apoi folosește Copiază linkul scurt din meniul … al partajării. Link scurt… îți permite să schimbi terminația și arată codul QR.
  • Pagina Shortcloud (meniul de sus) îți listează linkurile cu numărul de vizite și ultima vizită și îți permite să scurtezi orice adresă permisă, să pui pe pauză sau să ștergi un link.
  • Partajările făcute înainte de instalare: sudo -u www-data php occ shortcloud:backfill [--dry-run] [--user uid].
  • Alte comenzi: occ shortcloud:add <url> --user uid [--slug nume], occ shortcloud:list, occ shortcloud:delete <id|slug>.
  • Dezactivarea aplicației păstrează toate linkurile; la reactivare revin neschimbate.

Probleme frecvente

  • Linkurile scurte dau „404 Not Found”: regula de rescriere nu este activă. Pagina de setări și Setări de administrare → Prezentare generală semnalează asta. Pe Apache verifică mod_rewrite și AllowOverride All; pe nginx adaugă fragmentul din pagina de setări.
  • Regula a dispărut după o actualizare Nextcloud: se reface la următoarea actualizare a aplicației, la prima cerere după schimbarea versiunii sau la verificarea zilnică; occ shortcloud:setup o reface imediat.
  • Un link scurt răspunde „gone”: partajarea lui a fost ștearsă sau a expirat.
  • „Linkurile scurte către acest site nu sunt permise” la scurtarea unei adrese: țintele externe sunt refuzate implicit; permite domeniul (sau orice adresă) la Ținte.
  • „Linkurile scurte către această adresă sunt blocate” pentru un domeniu permis: adresa e pe lista anti-abuz. Aplicația nu are o listă încorporată; serverul de licențe poate livra o listă semnată de domenii și fragmente de adresă folosite pentru phishing sau malware, care se aplică peste politica ta. Lista e goală implicit — scurtătoarele precum bit.ly nu sunt blocate, pentru că multe echipe le folosesc legitim — și se completează doar cu ținte abuzate efectiv. Dacă o adresă de care ai nevoie e refuzată, scrie-ne.