Nextcloud¶

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

• Nextcloud. Հիմնական հնարավորություններ
• Տեղակայման հնարավորություններ
• Տեղադրման պարամետրերի կոնֆիգուրացիա Cloud-init-ի միջոցով
• Սկսել աշխատել Nextcloud-ի տեղադրումից հետո
• Դոմենի անվանումը փոխելը
• Nextcloud-ի պատվեր API-ի միջոցով

Nextcloud. Հիմնական հնարավորություններ¶

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

• Ֆայլերի պահպանում: Nextcloud-ը թույլ է տալիս պահպանել ֆայլերը սերվերի վրա և մուտք գործել դրանց՝ օգտագործելով վեբ ինտերֆեյս կամ սեղանի համակարգիչների և բջջային սարքերի հավելվածներ:
• Ֆայլերի սինխրոնացում: Տարբեր սարքերի միջև ֆայլերի սինխրոնացման հնարավորությունը ծառայությունը դարձնում է հարմարավետ գործիք տարբեր պայմաններում աշխատելու համար:
• Վարկածների կառավարում: 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 տվյալների բազայում: PostgreSQL
  • app - կոնտեյներ, Nextcloud ծառայությունն ունի հետևյալ պարամետրերը.
    • Հավելվածին մուտքը կատարվում է վեբ բրաուզերից կամ բջջային հավելվածից՝ օգտագործելով https://nextcloud(server_id).hostkey.in հղումը (օրինակ՝ https://nextcloud16094.hostkey.in);
    • մուտքի անուն. admin;
    • գաղտնաբառ. ssh-ից;
  • onlyoffice-document-server - կոնտեյներ, OnlyOffice ծառայությունը գործարկվում է 80-րդ պորտում:

  Ուշադրություն

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

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

Տեղադրման պարամետրերի կոնֆիգուրացիա Cloud-init-ի միջոցով¶

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

Կոնֆիգուրացիայի պարամետրեր¶

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 - վարչի հաշվի անուն (լռելյայն՝ admin);
• nextcloud_admin_pwd - վարչի գաղտնաբառ (նշեք ձեր ուժեղ գաղտնաբառը);
• nextcloud_admin_email - վարչի էլ. փոստը ծանուցումների համար;
• nextcloud_data_path - Nextcloud տվյալների պահպանման ուղի (լռելյայն՝ /opt/nextcloud-data):

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

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

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

• Հղում Nextcloud վահանակին մուտքի համար վեբ ինտերֆեյսով. webpanel թեգում;
• Մուտքի անուն. admin;
• Գաղտնաբառ. Ուղարկվում է ձեր էլ. փոստի հասցեին սերվերի պատրաստ լինելուց հետո՝ ծրագրային ապահովման տեղադրումից հետո:

Nextcloud կառավարման վահանակ անցնելուց հետո պետք է մուտքագրեք ձեր մուտքի անունը և գաղտնաբառը.

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

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

Դոմենի անվանումը փոխելու աշխատանքները սկսելուց առաջ խորհուրդ է տրվում ստեղծել հրահանգներում նշված բոլոր ֆայլերի պահպանող օրինակ: Հիմնական ֆայլերի պահպանող օրինակներ ստեղծելու համար կատարեք հետևյալ հրամանները.

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. Կրկին մեկնարկեք կոնտեյներները

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

6. Կրկին մեկնարկեք 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. Կրկին մեկնարկեք 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 ֆայլում սահմանված բոլոր կոնտեյներները, սակայն կպահպանի բոլոր տվյալները ծավալներում:

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

   docker compose up -d
   

4. Գործարկեք կոնֆիգուրացիայի սկրիպտը.

   bash /opt/nextcloud/set_configuration.sh
   

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

Ստուգում և խնդիրների լուծում¶

1. Համոզվեք, որ Nextcloud-ը հասանելի է նոր դոմենի անվանմամբ.

   Բացեք ձեր բրաուզերը https://YOUR_DOMAIN_NAME հասցեով

   

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

   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/"
   

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

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

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