Nextcloud¶

Այս հոդվածում

• Nextcloud. Հիմնական գործառույթները
• Տեղակայման հնարավորություններ
• Nextcloud-ի տեղադրումից հետո աշխատանքի սկիզբ որպես Managed App
• Nextcloud-ն Marketplace-ից տեղադրելուց հետո սկսել աշխատանքը՝ Կարգավորելով տեղադրման պարամետրերը Cloud-init-ի միջոցով
• Nextcloud-ի տեղադրումից հետո սկսել աշխատանքը
• Դոմեյնի անունը փոփոխելը
• Nextcloud-ի պատվիրումը API-ի միջոցով

Nextcloud. Հիմնական գործառույթները¶

Nextcloud-ն ունի բազմաթիվ գործառույթներ, որոնք այն դարձնում են արդյունավետ գործիալ տվյալների պահպանման և մշակման համար:

• Ֆայլերի պահպանում: Nextcloud-ն թույլ է տալիս պահպանել ֆայլերը սերվերում և օգտվել դրանցից վեբ-ինտերֆեյսի կամ համակարգչային և բջջային սարքերի հավելվածների միջոցով:
• Ֆայլերի սինխրոնացում: Տարբեր սարքերի միջև ֆայլերի սինխրոնացման հնարավորությունը ծառայությունը դարձնում է հարմար գործիալ տարբեր պայմաններում աշխատելու համար:
• Վերջինների վերահսկում (Version control). Nextcloud-ն թույլ է տալիս պահպանել նույն ֆայլի մի քանի տարբերակներ: Այն նաև թույլ կտա վերականգնել նախորդ տարբերակները, եթե դա անհրաժեշտ է:
• Ֆայլերի հասանելիություն վեբ-ինտերֆեյսի միջոցով. Nextcloud-ն ունի վեբ-ինտերֆեյս, որը թույլ է տալիս մուտք գործել ֆայլեր՝ բրաউզերի միջոցով, ինչը այն դարձնում է հարմար գործիալ ցանկացած սարքից աշխատելու համար:
• Օրացույցների և առաջադրանքների կառավարում. Nextcloud-ն թույլ է տալիս ստեղծել և կառավարել օրացույցներն ու առաջադրանքները՝ դարձնելով այն օգտակար գործիալ կազմակերպվածության համար:
• Կոնտակտների կառավարում. Nextcloud-ն թույլ է տալիս ստեղծել և կառավարել կոնտակտները՝ դարձնելով այն հարմար գործիալ հաղորդակցությունների կառավարման համար:
• Ֆայլերի հասանելիություն հավելվածների միջոցով. Nextcloud-ն ունի համակարգչային և բջջային սարքերի հավելվածներ, որոնք թույլ են տալիս մուտք գործել ֆայլեր:
• Ընդլայնվողություն। Nextcloud-ն ունի բազմաթիվ լրացուցիչ հավելվածներ, որոնք կարելի է տեղադրել և օգտագործել ֆունկցիոնալությունը ընդլայնելու համար: Դրանք հավելվածներ են առցանց համագործակցության, փաստաթղթերի խմբագրման, նախագծերի կառավարման և այլնի համար:

Տեղակայման հնարավորություններ¶

• Nextcloud-ն ներառված է կեռնելում, և հավելով լրացուցիչ տեղադրում պահանջվող չէ: Մենք տրամադրում ենք վեբ-ինտերֆեյս, որի միջոցով ծառայությունը տեղադրվում և կարգավորվում է:
• Կարգավորման ֆայլերը գտնվում են հետևյալ հասցեներում.
  • /opt/nextcloud - Nextcloud-ի տեղադրումը և կարգավորումը;
  • /opt/nginx - Nginx ծառայության տեղադրումը և կարգավորումը;
  • /opt/nextcloud/compose.yml - docker compose-ի գործարկում, որը մեկնարկում է մի շարք Nextcloud + Onlyoffice կոնտեյներներ:
• SSL սերտիֆիկատի գեներացումը հիմնված է jonasal/nginx-certbot հավաքածուի վրա:

• Հրամանները կարող են անհրաժեշտ լինել կոնտեյներների տարբերակները թարմացնելու և կարգավորման ֆայլը խմբագրելու համար.

  • Կոնտեյներները կանգնեցնելու համար գործարկեք հետևյալ հրամանը.

  cd /opt/nextcloud/
  

  Հետո՝

  docker compose down
  

  • Կոնտեյներները միացնելու համար գործարկեք հետևյալ հրամանը.

  cd /opt/nextcloud/
  

  Հետո՝

  docker compose up -d
  

• Docker compose up -d գործարկում է compose.yml ֆայլը, որը ներբեռնում և մեկնարկում է հետևյլ կոնտեյներները:

  • db - կոնտեյներ, որտեղ ներբեռնվում է PostgreSQL-ը և կատարվում են հետևյալ կարգավորումներ.
    • Ստեղծվում է Nextcloud տվյալների բազան (կամ հիմքը);
    • Գեներացվում է Nextcloud օգտատերն;
    • SSH գաղտնաբառը (այն ուղարկվում է ձեր էլեկտրոնային հասցեին, երբ սերվերը պատրաստ է աշխատանքի տեղադրումից հետո);
    • Ստանդարտ պորտը՝ 5432:
  • redis - կոնտեյներ, որը հիշողության մեջ պահում է Nextcloud-ին ուղարկված հարցումները և միայն դրանից հետո գրանցում է PostgreSQL տվյալների բազայում:
  • app - կոնտեյներ, Nextcloud ծառայությունը ունի հետևյալ պարամետրերը.
    • Հավելվածին մուտքն իրականացվում է վեբ բրաউզերից կամ բջջային հավելվածից՝ օգտագործելով https://nextcloud(server_id).hostkey.in հղումը (օրինակ՝ https://nextcloud16094.hostkey.in);
    • մուտքանուն (login): admin;
    • գաղտնաբառ (password): SSH-ի միջոցով ստացված:
  • onlyoffice-document-server - կոնտեյներ, OnlyOffice ծառայությունը գործում է 80 պորտի վրա:

  Զգուշացում

  Այս կոնտեյները մեկնարկվում են 6 րոպe ընթացքում: Այդ ժամանակ դուք կարող եք գնալ Nextcloud-ի վեբ-ինտերֆեյս, վերբեռնել և ներբեռնել ֆայլեր, սակայն փաստաթղթերի խմբագրման հնարավորությունը կհայտնվի միայն docker compose up -d գործարկելուց 6 րոպե անց (որոշ բաղադրիչների մեկնարկը ժամանակ է պահանջում):

  • nginx - կոնտեյներ, Nginx ծառայություն, որը ընդունում է հարցումները 80 և 443 պորտերով և վերահասցեավորում է դրանք Nextcloud կոնտեյներին:

Nextcloud-ի տեղադրումից հետո աշխատանքի սկիզբ որպես Managed App¶

Տեղադրելով Nextcloud-ն որպես Managed App, դուք կարող եք գտնել հետևյալը սերվերի կառավարման վահանակի My Apps պատուհանում.

• հավելվածի հղումը;
• մուտքանունն (login) և գաղտնաբառը (password);
• տեղեկատվություն ծառայության օգտագործման և կառավարման վերաբերյալ:

Managed App-ների հետ աշխատանքի մասին հավելյալ մանրամասների համար տեսեք հրահանգները:

Nextcloud-ն Marketplace-ից տեղադրելուց հետո սկսել աշխատանքը՝ Կարգավորելով տեղադրման պարամետրերը Cloud-init-ի միջոցով¶

Server պատվիրելիս Nextcloud-ով, դուք կարող եք նախնական կարգավորել հիմնական տեղադրման պարամետրերը օգտագործելով cloud-init կոնֆիգուրացիան՝ պատվերի գործընթացում Automatization փուլում: Սա թույլ է տալիս ավտոմատ կերպով սահմանել administrator credentials, էլեկտրոնային հասցե և տվյալների պահպանման ուղի.

Կարգավորման պարամետրեր¶

Nextcloud-ն cloud-init-ի միջոցով կարգավորելու համար օգտագործեք հետևյալ ձևաչափը.

write_files:
  - path: "/opt/main.yml"
    permissions: "0644"
    content: |
      nextcloud_admin_name: "root"
      nextcloud_admin_pwd: "YOUR_PASSWORD"
      nextcloud_admin_email: "admin@localhost"
      nextcloud_data_path: "/opt/nextcloud-data"

Պարամետրերի նկարագրություն

• nextcloud_admin_name - administrator հաշվի անունը (default: admin);
• nextcloud_admin_pwd - administrator գաղտնաբառը (նշեք ձեր ուժեղ գաղտնաբառը);
• nextcloud_admin_email - administrator-ի էլեկտրոնային հասցեն ծանուցումների համար;
• nextcloud_data_path - Nextcloud տվյալների պահպանման ուղին (default: /opt/nextcloud-data).

Nextcloud-ի տեղադրումից հետո սկսել աշխատանքը¶

Պատվերը վճարելուց հետո գրանցման ժամանակ նշված էլեկտրոնային հասցեին կուղարկվի ծանուցում, որ սերվերը պատրաստ է աշխատանքի: Այն պարունակում է VPS-ի IP հասցեն, ինչպեսզիք login-ը և password-ը միացման համար: Մեր ընկերության հաճախորդները կառավարում են սերվերի սարքավորումները և API կառավարման վահանակը՝ Invapi-ի միջոցով:

Դուք կարող եք գտնել նույնիսկ ավտոռիզացիայի տվյալները սերվերի կառավարման վահանակի Configuration >> Tags պատուհանում կամ ուղարկված էլեկտրոնային նամակում:

• Հղում Nextcloud dashboard-ին (վեբ-ինտերֆեյսով): webpanel թեգի մեջ;
• Login: admin;
• Password: Ուղարկվում է ձեր էլեկտրոնային հասցեին, երբ սերվերը պատրաստ է օգտագործման համար՝ ծրագրակազմի տեղադրումից հետո:

Մուտք գործելով Nextcloud կառավարման վահանակ, դուք պետք է մուտքագրեք ձեր login-ը և password-ը.

Հաջող մուտքից հետո կարող եք սկսել օգտագործել ծառայությունը:

Դոմեյնի անունը փոփոխելը¶

Մինչև դոմեյնի անվան փոփոխության վերաբերյալ աշխատանքը սկսելը, խորհուրது է տրվում ստեղծել հրահանգներում նշված բոլոր ֆայլերի պահուստային պատճիռ (backup): Հիմնական ֆայլերի պահուստավորման համար գործարկեք հետևյալ հրամանները.

1. Ստեղծել թղթապանակ պահուստների համար.

   mkdir -p /root/nextcloud_backup
   

2. Պճենել Nginx-ի կոնֆիգուրացիայի ֆայլը.

   cp /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf /root/nextcloud_backup/
   

3. Պճենել Docker Compose ֆայլը.

   cp /opt/nextcloud/compose.yml /root/nextcloud_backup/
   

4. Պճենել կոնֆիգուրացիայի սկրիպտը.

   cp /opt/nextcloud/set_configuration.sh /root/nextcloud_backup/
   

5. Պճենել Nextcloud-ի կոնֆիգուրացիայի ֆայլը.

   cp /var/lib/docker/volumes/app_data/_data/config/config.php /root/nextcloud_backup/
   

Այս հրամանները կստեղծեն բոլոր առանցքային ֆայլերի պահուստները, որոնք կփոփոխվեն դոմեյնի անվան փոփոխության ընթացքում: Խնդիրների դեպքում դուք կարող եք վերականգնել սկզբնական կարգավորումները այս պահուստներից:

Վերականգնում պահուստներից և ջնջում հաջող միգրացիայից հետո¶

Եթե դոմեյնի անվան փոփոխության գործընթացը ձախողվի և ձեզ պետք լինի վերականգնել սկզբնական կարգավորումները, գործարկեք հետևյալ հրամանները.

1. Վերականգնել Nginx-ի կոնֆիգուրացիայի ֆայլը.

   cp /root/nextcloud_backup/nextcloud<server ID>.hostkey.in.conf /opt/nginx/user_conf.d/
   

2. Վերականգնել Docker Compose ֆայլը.

   cp /root/nextcloud_backup/compose.yml /opt/nextcloud/
   

3. Վերականգնել կոնֆիգուրացիայի սկրիպտը.

   cp /root/nextcloud_backup/set_configuration.sh /opt/nextcloud/
   

4. Վերականգնել Nextcloud-ի կոնֆիգուրացիայի ֆայլը.

   cp /root/nextcloud_backup/config.php /var/lib/docker/volumes/app_data/_data/config/
   

5. Վերստắtել կոնտեյներները.

   cd /opt/nextcloud
   docker compose down
   docker compose up -d
   

6. Վերստ tắtել nginx-ը.

   docker restart nginx-certbot
   

Այս հրամանները կվերականգնեն բոլոր կարգավորման ֆայլերը իրենց սկզբնական վիճակին և կմեկնարկեն անհրաժեշտ ծառայությունները:

Երբ համոզվեք, որ դոմեյնի անվան փոփոխությունը հաջող է և ամեն ինչ ճիշտ է աշխատում (խորհուրது է տրվում սպասել առնվազն 24-48 ժամ լիարժեք թեստավորման համար), կարող եք անվտանգ ջնջել պահուստները.

1. Ստուգել պահուստային թղթապանակի պաշտոնական բովանդակությունը.

   ls -la /root/nextcloud_backup/
   

2. Ջնջել ամբողջ պահուստային թղթապանակը.

   rm -rf /root/nextcloud_backup/
   

Մինչև ջնջելը, խորհուրդ է տրվում ստուգել թղթապանակի բովանդակությունը՝ համոզվելու համար, որ դուք ջնջում եք միայն անհրաժեշտ ֆայլերը:

Ֆայլերի կարգավորում¶

1. Մուտք գործեք սերվեր, SSH-ի միջոցով.

   ssh root@IP_ADDRESS
   

2. Փոխեք hostname-ը (ընտրովի).

   hostnamectl set-hostname nextcloud_server
   

3. Խմբագրեք /etc/hosts ֆայլը.

   nano /etc/hosts
   

   Ավելացրեք տող, որը կապում է նոր դոմեյնը սերվերի IP հասցեի հետ.

   IP_ADDRESS YOUR_DOMAIN_NAME
   

   (փոխարինեք IP հասցեն և դոմեյնի անունը ձեր արժեքներով)

Nginx-ի կարգավորում¶

1. Գտեք և խմբագրեք Nginx-ի կոնֆիգուրացիայի ֆայլը.

   nano /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf
   

   Փոփոխեք հին դոմեյնի անվան բոլոր դրսերով (nextcloud<server ID>.hostkey.in) նորը (YOUR_DOMAIN_NAME).

   • 4-րդ տող: server_name nextcloud<server ID>.hostkey.in; > server_name YOUR_DOMAIN_NAME;
   • 15-րդ տող: server_name nextcloud<server ID>.hostkey.in; > server_name YOUR_DOMAIN_NAME;
   • 17-րդ տող: ssl_certificate /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/fullchain.pem; > ssl_certificate /etc/letsencrypt/live/YOUR_DOMAIN_NAME/fullchain.pem;
   • 18-րդ տող: ssl_certificate_key /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/privkey.pem; > ssl_certificate_key /etc/letsencrypt/live/YOUR_DOMAIN_NAME/privkey.pem;
   • 19-րդ տող: ssl_trusted_certificate /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/chain.pem; > ssl_trusted_certificate /etc/letsencrypt/live/YOUR_DOMAIN_NAME/chain.pem;

2. Վերանվանեք կոնֆիգուրացիայի ֆայլը.

   mv /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf /opt/nginx/user_conf.d/YOUR_DOMAIN_NAME.conf
   

3. Վերստắtեք Nginx կոնտեյները.

   docker restart nginx-certbot
   

Nextcloud-ի կարգավորում¶

1. Խմբագրեք Docker Compose ֆայլը.

   nano /opt/nextcloud/compose.yml
   

   Փոփոխեք հին դոմեյնի անվան բոլոր դրսերը նորով (YOUR_DOMAIN_NAME): Ուշադիր եղեք հետևյալ տողերին.

   • 40-րդ տող: - OVERWRITECLIURL=https://nextcloud<server ID>.hostkey.in/
   • 41-րդ տող: - OVERWRITEHOST=nextcloud<server ID>.hostkey.in

2. Խմբագրեք Nextcloud-ի կարգավորման սկրիպտը.

   nano /opt/nextcloud/set_configuration.sh
   

   Փոփոխեք հին դոմեյնի անվան բոլոր դրսերը նորով: Հատուկ ուշադրություն դարձրեք հետևյալ տողերին.

   • 11-րդ տող: if ! grep -q "nextcloud<server ID>.hostkey.in" trusted_domain.tmp; then
   • 13-րդ տող: docker exec -u www-data app-server php occ --no-warnings config:system:set trusted_domains $TRUSTED_INDEX --value="nextcloud<server ID>.hostkey.in"
   • 23-րդ տող: docker exec -u www-data app-server php occ --no-warnings config:system:set onlyoffice StorageUrl --value="https://nextcloud<server ID>.hostkey.in/

Փոփոխությունների կիրարկում¶

1. Անցեք Nextcloud թղթապանակ:

   cd /opt/nextcloud
   

2. Կանգնեցրեք և ջնջեք գոյություն ունեցող կոնտեյներները.

   docker compose down
   

   Այս հրամանը կկանգնեցնի և կջնջի compose.yml ֆայլում սահմանված բոլոր կոնտեյներները, բայց կպահպանի բոլոր տվյալները volumes-ների մեջ:

3. Մեկնարկեք Nextcloud կոնտեյներները.

   docker compose up -d
   

4. Գործարկեք կարգավորման սկրիպտը.

   bash /opt/nextcloud/set_configuration.sh
   

   Եթե սկրիպտը հայտնում է, որ "maintenance:install" հրամանը սահմանված չէ, դա նորմալ է՝ Nextcloud-ն արդեն տեղադրված է:

Ստուգում և վերհայտում (Debugging)¶

1. Հաստատեք, որ Nextcloud-ն հասանելի է նոր դոմեյնի միջոցով.

   Բրաউզերում բացեք https://YOUR_DOMAIN_NAME

   

2. Եթե խնդիրներ կան, ստուգեք լոգերը (logs).

   docker logs nginx-certbot
   docker logs app-server
   

3. Անհրաժեշտության դեպքում ձեռքով կարգավորեք trusted_domains.

   docker exec -u www-data app-server php occ --no-warnings config:system:set trusted_domains 1 --value="YOUR_DOMAIN_NAME"
   docker exec -u www-data app-server php occ --no-warnings config:system:set overwrite.cli.url --value="https://YOUR_DOMAIN_NAME/"
   

4. Եթե օգտագործվում է OnlyOffice, ստուգեք դրա կարգավորումները.

   docker exec -u www-data app-server php occ --no-warnings config:system:set onlyoffice StorageUrl --value="https://YOUR_DOMAIN_NAME/"
   

Կարևոր նշումներ¶

• Փոփոխություններ կատարելուց հետո անհրաժեշտ է մաքրել բրաউզերի քեշը (cache);
• Օգտատերերի բոլոր տվյալները (credentials) մնում են նույնը, ինչ նախկինում էր:
• Եթե ձեր DNS պրովայդերը ժամանակ է պահանջում գրառումների թարմացման համար, կարող է որոշակի ուժեղացում (delay) լինել նոր դոմեյնի աշխատանքը սկսելուց առաջ:
• Համոզվեք, որ DNS-ի A-գրառումը հղված է ձեր սերվերի ճիշտ IP հասցեին:
• PTR գրառումը (reverse DNS) կրիտիկական չէ Nextcloud-ի աշխատանքի համար, բայց կարող է թարմացվել կառավարման վահանակի միջոցով՝ լիարժեք համապատասխանության համար:

Nextcloud-ի պատվիրումը API-ի միջոցով¶

Այս ծրագրային ապահովումը տեղադրելու համար API-ի միջոցով հետևեք այս հրահանգներին։