Ինչպես է այն աշխատում
Խնդիրների լուծում
Չորս հաճախ հանդիպող խափանումների սցենարներ՝ վահանակը չի գործարկվում, կայքը պատասխանում է 502 կամ 404, վկայագիրը չի թողարկվում, գործակալը անհասանելի է։
Ստորև յուրաքանչյուր սցենար ունի երեք մաս՝ ախտանիշներ (ինչ եք տեսնում), ստուգումներ (որոնք
օգնում են գտնել պատճառը) և ուղղումներ։ Բոլոր հրամանները կատարեք հենց սերվերի վրա՝ root-ով։ Երկու
գործիք պետք է գալիս է բոլոր չորս դեպքերում։ maran status-ը ցույց է տալիս, թե որ ծառայություններն են
աշխատում, նույնիսկ երբ վահանակը չի պատասխանում։ maran collect-diagnostics-ը հավաքում է
գաղտնիքներից մաքրված արխիվ՝ նրան ուղարկելու համար, ով օգնում է ձեզ (երկուսն էլ նկարագրված են
Վերականգնում և ախտորոշում էջում)։
sudo /usr/local/sbin/maran status
Ծառայությունների անուններն են maran-api (վահանակը), maran-agent (root-ով աշխատող դեմոնը, որը կատարում է
արտոնյալ գործողությունները), postgresql և nginx։ Ֆայլերի փոխանցումը միացնելուց հետո ցուցակում հայտնվում է
նաև maran-ftps-ը։ Նրանց մատյանները systemd-ի journal-ում են։
Վահանակը չի գործարկվում
Ախտանիշներ։ Բրաուզերը չի բացում վահանակը 8443 պորտով, կամ բացում է, բայց ամեն հարցում
վերադարձնում է 502։ maran status-ում maran-api.service-ը failed կամ activating վիճակում է, կամ
Panel բաժինը հայտնում է, որ վահանակի սեփական հաշվետվությունն անհասանելի է։
Ստուգումներ։
sudo systemctl status maran-api.service --no-pager
sudo journalctl -u maran-api.service -n 50 --no-pager
ls -l /run/maran-api/api.sock
- Եթե վահանակը չի գործարկվում, պատճառը գրված է journal-ում։ Սովորաբար
/etc/maran/panel.env-ում գաղտնագրման կամ ստորագրման բանալին բացակայում է, համընկնում է մշակման համար հրապարակված բանալու հետ կամ սխալ ձևաչափ ունի, կամ նշված չէReverseProxy__PeerUid-ը (վեբ սերվերի օգտվողի նույնացուցիչը, որը գրում է տեղադրիչը)։ - Վահանակը PostgreSQL-ին միանում է տեղական socket-ով, ուստի
maran status-ում նայեք նաևpostgresql.service-ին։ - Առողջ վահանակն ունի
/run/maran-api/api.socksocket՝ 660 իրավունքներով։ Եթե այն չկա, վահանակը այն երբեք չի ստեղծել։ Եթե իրավունքները կամ խումբը այլ են, nginx-ը չի կարող այն բացել, և ամեն հարցում վերադարձնում է 502։ - Վաթսուն վայրկյանում հինգ անգամ գործարկվելուց հետո systemd-ը դադարում է փորձել։ Եթե journal-ում դա եք տեսնում, իրական պատճառը ավելի վերևում է, ոչ թե վերջին տողում։
Ուղղումներ։
- Ուղղեք այն, ինչ նշված է journal-ում, օրինակ՝ տողը
/etc/maran/panel.env-ում։ Գաղտնագրման բանալին ձեռքով մի փոխեք, եթե վահանակի հաղորդագրությունը դա չի պահանջում․ փոխելուց հետո պահված գաղտնիքները այլևս չեն կարդացվի։ - Եթե PostgreSQL-ը կանգնած էր, նախ գործարկեք այն՝
sudo systemctl start postgresql.service։ - Զրոյացրեք գործարկումների հաշվիչը և նորից գործարկեք վահանակը․bash
sudo systemctl reset-failed maran-api.service sudo systemctl restart maran-api.service - Եթե ֆայլերն են վնասված, նորից գործարկեք տեղադրիչը։ Դա անվտանգ է (տես Տեղադրում)։ Եթե խնդիրը միայն վահանակ մուտք գործելն է, տես Վերականգնում և ախտորոշում։
Կայքը պատասխանում է 502 կամ 404
Ախտանիշներ։ Տեղակայված կայքը վերադարձնում է 502 Bad Gateway կամ 404 Not Found, իսկ
վահանակն ինքը աշխատում է։
Ստուգումներ։
sudo nginx -t
sudo systemctl status nginx.service --no-pager
ls /etc/maran/nginx/sites/
ls -l /run/maran-php/
sudo tail -n 50 /var/log/maran/sites/<account>/*.log
nginx -t-ը պետք է անցնի։ Յուրաքանչյուր կայք ունի իր կազմաձևման ֆայլը/etc/maran/nginx/sites/-ում, որը միացվում է/etc/nginx/conf.d/maran-sites.conf-ով։ Եթե այնտեղ ֆայլ չկա, nginx-ը կայքին չի ճանաչում, և նրա անունին պատասխանում է մեկ այլ կայք կամ լռելյայն կայքը։- PHP կայքում 502 նշանակում է, որ nginx-ը չի կարողացել հասնել կայքի PHP pool-ին․ նրա socket-ը
/run/maran-php-ում է։ Reverse-proxy կայքում 502 նշանակում է, որ ծառայությունը, որին այն ուղղված է, չի աշխատում կամ չի լսում։ - 404 նշանակում է, որ nginx-ը պատասխանել է, բայց ոչինչ չի գտել։ Պատճառը կարող է լինել մեկը հետևյալներից․ դոմենը կայքի դոմենների ու այլանունների մեջ չէ, կայքը կասեցված կամ անջատված է, DNS անունը ցույց է տալիս մեկ այլ սերվեր, կամ արմատային պանակում index ֆայլ չկա։ Տես Կայքեր և PHP։
- Կայքի հասանելիության և սխալների մատյանները
/var/log/maran/sites/<account>/-ում են՝ հաճախորդի տնային պանակից դուրս։ Վահանակը դրանք ցույց է տալիս նաև կայքի էջում՝ իրական ժամանակում։ Վահանակի վեբ սերվերի մատյանները/var/log/maran/nginx-access.logև/var/log/maran/nginx-error.logֆայլերում են։
Ուղղումներ։
- Ուղղեք դոմենը, այլանունները կամ արմատային պանակը վահանակում, կամ նորից միացրեք կայքը և ստուգեք DNS գրառումը։
- Reverse-proxy կայքի համար գործարկեք ծառայությունը, որին այն ուղղված է։
- Եթե PHP socket-ը բացակայում է կամ կայքը ստեղծվել է ավելի հին թողարկմամբ, վերագործարկեք վահանակը՝
sudo systemctl restart maran-api.service։ Գործարկվելիս այն գործակալին խնդրում է կարգի բերել յուրաքանչյուր PHP կայքի pool-ը և վեբ սերվերի կազմաձևումը։ - Կազմաձևումը գրելիս ստուգվում է վեբ սերվերի սեփական վալիդատորով և սխալի դեպքում հետ է
գլորվում, ուստի մեկ կայքի խնդիրը սովորաբար մյուսներին չի վնասում։ Եթե
nginx -t-ը ձախողվում է Maran-ին չպատկանող ֆայլի պատճառով, նախ ուղղեք այն․ դրա պատճառով կազմաձևման վերաբեռնումը չի անցնում բոլոր կայքերի համար։
Վկայագիրը չի թողարկվում
Ախտանիշներ։ Կայքի վկայագրի կամ վահանակի վստահելի վկայագրի պատվերը ձախողվում է։ Սխալը
հետևյալներից մեկն է՝ AcmeValidationFailed, AcmeValidationTimedOut, AcmeAuthorityUnreachable,
AcmeChallengeWriteFailed, PanelHostNameNotConfigured, PanelChallengeWriteFailed կամ
AgentBelowFreeSpaceFloor (բոլորը թվարկված են API-ի սխալների կոդեր էջում)։
Ստուգումներ։
- Վկայագրերը թողարկվում են ACME HTTP-01 ստուգմամբ, ուստի վկայագրող մարմինը պետք է կարողանա հասնել ձեր
սերվերին սովորական HTTP-ով 80 պորտով։ Դոմենը պետք է ցույց տա այս սերվերը, և 80 պորտը չպետք է արգելափակված
լինի ո՛չ սերվերից դուրս դրված firewall-ով, ո՛չ սերվերի սեփական կանոններով․bash
sudo nft list ruleset curl -I http://example.com/.well-known/acme-challenge/test
Երկրորդ հրամանի 404 պատասխանը նորմալ է․ դա ցույց է տալիս, որ 80 պորտը պատասխանում է այդ անվանը։ - Կայքի ստուգման ֆայլը տրվում է կայքի սեփական արմատային պանակից, ուստի կայքը պետք է գոյություն
ունենա, միացված լինի և պատասխանի պատվիրվող անվանը։ Վահանակի վերապահած անունները (IP հասցե,
localhost,.localև նմանները կամ վահանակի սեփական անունը) մերժվում են՝ նախքան որևէ հարցում ուղարկելը։ - Վահանակի վկայագրի համար
/etc/maran/panel.env-ումPanel__HostName-ը պետք է իրական անուն լինի, որը ցույց է տալիս այս սերվերը։ Ստուգման ֆայլը տրվում է/var/lib/maran-acme-ից՝ վահանակի վեբ սերվերի կազմաձևման 80 պորտի բլոկով։ Եթե սերվերը տեղադրվել է այդ բլոկի հայտնվելուց առաջ, տեղադրիչը պետք է նորից գործարկել։ Տես Վահանակի վկայագիր։ - Ազատ տարածքը ստուգեք
df -h-ով։ Եթե այն շեմից ցածր է (1 ԳիԲ, եթե շեմը չեք փոխել), գրառումները մերժվում են։
Ուղղումներ։
- Ուղղեք DNS գրառումը, որ ցույց տա այս սերվերը, բացեք 80 պորտը և նորից պատվիրեք։ Ձախողված պատվերը ոչինչ չի փոխարինում․ արդեն օգտագործվող վկայագիրը մնում է տեղում։
- Եթե
Panel__HostName-ը բացակայում է, սահմանեք այն, վերագործարկեք վահանակը և նորից պատվիրեք։ Եթե 80 պորտի բլոկը բացակայում է, նորից գործարկեք տեղադրիչը։ - Եթե սխալը
AgentBelowFreeSpaceFloorէ, ազատեք սկավառակի տարածք։ - Wildcard անունները և DNS-01-ը չեն աջակցվում, ուստի
*.example.comտիպի անունով վկայագիր պատվիրել հնարավոր չէ։ Պատվերի և նորացման մասին կարդացեք SSL վկայագրեր էջում։
Գործակալը անհասանելի է
Ախտանիշներ։ Սերվերը փոխող գործողությունները (հաշվի կամ կայքի ստեղծում, վկայագրի պատվեր, պահուստային
պատճեն) ձախողվում են գործակալի սխալով, օրինակ՝ AgentIncompatible, իսկ վահանակի տվյալները միայն
կարդացող էջերը բացվում են։ Վահանակի առողջության հաշվետվության մեջ գործակալն անհասանելի է,
իսկ maran status-ը ցույց է տալիս, որ maran-agent.service-ը active վիճակում չէ։
Ստուգումներ։
sudo systemctl status maran-agent.service --no-pager
sudo journalctl -u maran-agent.service -n 50 --no-pager
ls -l /run/maran/agent.sock
cat /etc/maran/agent.env
- Գործակալը լսում է unix socket
/run/maran/agent.sock-ը՝ 660 իրավունքներով, սեփականատեր root, վահանակի խումբ։ Ուրիշ ոչ ոք չի կարող միանալ, և գործակալն ինքն ընդունում է միայն/etc/maran/agent.env-ումMARAN_AGENT_ALLOW_UID-ով նշված օգտվողի նույնացուցիչը։ - Նույն ֆայլում
MARAN_AGENT_FREE_SPACE_FLOOR_MIB-ը պետք է լինի 1 կամ ավելի մեծ ամբողջ թիվ, հակառակ դեպքում գործակալը չի գործարկվի (ազատ տարածքի շեմի մասին կարդացեք Վերականգնում և ախտորոշում էջում)։ AgentIncompatibleնշանակում է, որ վահանակը և գործակալը տարբեր տարբերակների են, օրինակ՝ թարմացման ընթացքում։ Դրանք պետք է թարմացնել միասին։- Վահանակը գործակալի բացակայության դեպքում էլ գործարկվում է և միայն զգուշացում է գրում, ուստի այն, որ վահանակն աշխատում է, ոչինչ չի ասում գործակալի մասին։
Ուղղումներ։
- Վերագործարկեք գործակալին, ապա վահանակը՝ հենց այս հերթականությամբ․bash
sudo systemctl restart maran-agent.service sudo systemctl restart maran-api.service - Եթե ծառայությունը շարունակում է ձախողվել, ուղղեք այն, ինչ նշված է նրա journal-ում (օրինակ՝ շեմի
արժեքը), և վերագործարկելուց առաջ կատարեք
sudo systemctl reset-failed maran-agent.service։ - Եթե տարբերակները տարբեր են, նորից գործարկեք տեղադրիչը, որպեսզի երկու մասն էլ նույն թողարկումից լինեն։
- Եթե դա էլ չօգնեց, կատարեք
sudo /usr/local/sbin/maran collect-diagnostics, նայեք արխիվը և ուղարկեք նրան, ով օգնում է ձեզ։