Nextcloud¶

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

• Nextcloud. Հիմնական հնարավորություններ
• Տեղակայման հնարավորություններ
• Ինչպես սկսել Nextcloud-ն որպես Managed App տեղակայելուց հետո
• Ինչպես սկսել Nextcloud-ն Marketplace-ից տեղակայելուց հետո. Կարգավորման պարամետրերի կարգավորում Cloud-init-ի միջոցով
• Ինչպես սկսել Nextcloud-ն տեղակայելուց հետո
• Դոմեյն անունը փոփոխելը
• Nextcloud-ի պատվիրումը API-ի միջոցով

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

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

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

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

• Nextcloud-ն ներառված է kernel-ում, և լրացուցիչ տեղակայում պահանջվող չէ: Մենք տրամադրում ենք վեբ-ինտերֆեյս, որի միջոցով ծառայությունը տեղակայվում և կարգավորվում է:
• Կարգավորման ֆայլերը գտնվում են հետևյալ հասցեներում.
  • /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-ի օգտվողը (user);
    • 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 րոպե ընթացքում: Այդ ընթացքում դուք կարող եք մտնել Nextcloud վեբ-ինտերֆեյս, վերբեռնել և ներբեռնել ֆայլեր, սակայն փաստաթղթերի խմբագրման հնարավորությունը կհայտնվի միայն docker compose up -d գործարկելուց 6 րոպե անց (որոշ բաղադրիչների մեկնարկը ժամանակ է պահանջում):

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

Ինչպես սկսել Nextcloud-ն որպես Managed App տեղակայելուց հետո¶

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

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

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

Ինչպես սկսել Nextcloud-ն Marketplace-ից տեղակայելուց հետո. Կարգավորման պարամետրերի կարգավորում Cloud-init-ի միջոցով¶

Server պատվիրելիս 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 հասցեն, ինչպեսզիք 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. Վերցրեք կոնտեյներները վերստին.

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

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

   docker compose up -d
   

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

   bash /opt/nextcloud/set_configuration.sh
   

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

Ստուգում և սխալների ուղղում¶

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, ստուգեք դրա կարգավորումները.

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

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

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

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

Այս ծրագրի տեղակայման համար օգտագործեք API. Հետևեք այս հրահանգներին: