Перейти до вмісту

Документація

Webmin і Virtualmin

Webmin — це інтеграція з панеллю керування для серверів, на яких працює Virtualmin. Вона створює й веде облікові записи вебхостингу на машині, яка вже запущена. Немає операційної системи, яку треба встановити, і немає машини, яку треба завантажити: запис створюється, отримує план, а згодом його призупиняють, переносять на інший план або видаляють.

Webmin — це панель, хостингом займається Virtualmin

Продукт відомий як Webmin, і саме так називається ця сторінка. Насправді Provibr керує Virtualmin, модулем, який знає про домени, плани та квоти. Сам по собі Webmin керує машиною з Linux і поняття облікового запису хостингу не має взагалі.

На сервері без цього модуля віддаленого API просто немає: він відповідає точно так само, як модуль, якого не існує. Тож Provibr не може перейти на сам лише Webmin і не вдає, що може: підключення відхиляється із зазначеною причиною, а не створюється наполовину.

Що потрібно

Віддалений API Webmin говорить HTTP Basic, тож таємниця тут — це пароль, а не токен. Це властивість Webmin, а не наш вибір, і саме тому два правила нижче суворіші, ніж в інших панелей керування.

  • Хост: адреса панелі. Вона має бути https, а порт 10000 додається, якщо його пропустити.
  • Користувач Webmin: root працює, але краще користувач, який має лише модуль Virtualmin.
  • Пароль: пароль цього користувача. Обмежувати тут нічого, тож обирайте користувача уважно.
  • Відбиток TLS: обовʼязковий, бо інсталятор Webmin лишає по собі самопідписаний сертифікат.
Призначте модуль Virtualmin користувачеві Webmin, створеному саме для цього. Він може все, що може Virtualmin, а це чимало, але не все, що може Webmin.

https і відбиток обидва обовʼязкові

Інші інтеграції з панелями керування приймають незашифровану http-адресу й попереджають, чого це вартує. Ця — ні, і різниця саме в таємниці: ключ доступу DirectAdmin можна обмежити кількома командами, пароль Webmin не можна обмежити взагалі.

Надсилати цей пароль незашифрованим або до сертифіката, якого ніхто не перевіряв, ми не вважаємо прийнятним компромісом. Тому http відхиляється, а поле відбитка не може лишатися порожнім.

Відбиток зчитують із будь-якої машини, що дістає панель, і вставляють як є, із двокрапками чи без них, а префікс, який друкує ваш інструмент, може лишитися.

shell
openssl s_client -connect <host>:10000 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Команди та вивід термінала всюди англійською і в панелі, і на цих сторінках. Один текст, одна правда: те, що ви читаєте тут, ваш хост виведе дослівно так само.

Віддалений API

Provibr не користується вебінтерфейсом Webmin. Він звертається до віддаленого API модуля Virtualmin, який повертає машиночитні відповіді, а не сторінки. На деяких інсталяціях цей шлях вимкнено; вмикають його назад у Webmin, Webmin Configuration, Advanced Options.

Коли панель відповідає сторінкою входу замість API, агент каже про це прямо. Зазвичай це означає, що адреса вказує на сторінку, а не на панель, або що віддалений API вимкнено.

Налаштування

Їх немає. Сервер Webmin сам вирішує, де живе обліковий запис і яку адресу він отримує, тож вибирати вам нічого. Вкладка налаштувань усе одно є, бо саме звідти ще й повторно надсилають облікові дані.

Плани

План Virtualmin — це власний опис облікового запису з боку панелі: дискова квота, місячний трафік, скільки доменів і поштових скриньок, які функції ввімкнено. Це не тариф Provibr і не операційна система: це назва, на яку ми посилаємося, а її вміст може змінитися на вашому сервері непомітно для нас.

Сторінка інтеграції може зчитати перелік планів разом із їхнім вмістом, щоб ви бачили, що обираєте, а не набирали назву з памʼяті.

Вебтариф закріплює один план Virtualmin на одній інтеграції та дає йому вашу власну назву. Замовлення за тарифом має перевагу над окремим вибором, і той окремий вибір лишається для випадків, які тариф не покриває.

Який вигляд обліковий запис має в Provibr

Обліковий запис хостингу — це звичайний рядок сервера типу вебсервер. Його ідентифікатором є внутрішній номер, який Virtualmin дає домену, а домен, користувач, план і функції надходять при кожному опитуванні.

  • Для створення запису потрібні домен, адреса електронної пошти, план і пароль.
  • Користувач unix виводиться з домену, тож дефіси тут звична річ, на відміну від DirectAdmin, який має власне правило іменування.
  • Пароль ніде не записується. Лишається тільки те, що ви його передали; саме значення подорожує окремо.
  • Далі можна призупиняти, поновлювати, змінювати план і видаляти. Консолі немає, бо в облікового запису хостингу її не буває.
Ідентифікатором є номер, а не назва, бо Virtualmin уміє перейменовувати домен. Ключ за назвою відірвався б від свого рядка першого ж разу, коли хтось це зробить.

Квоти та споживання

Дискова квота й трафік їдуть разом зі звичайним опитуванням, тож обліковий запис отримує графік споживання без жодних додаткових вмикань, за умови, що сервер уміє їх виміряти.

Virtualmin повідомляє квоту й споживання лише тоді, коли ввімкнено квоти файлової системи, а на свіжій інсталяції вони вимкнені. Доки їх ніхто не ввімкне, цих полів просто немає. Provibr тоді не показує нічого замість нуля: відсутність вимірювання й відсутність споживання — це не одне й те саме.

Перейняття наявних облікових записів

Вкладка імпорту показує записи в панелі й дає перейняти в Provibr ті, які ви оберете. Уже відомі записи видно, але вибрати їх удруге не можна, щоб ви бачили повну картину, а не відфільтровану.

Імпортовані записи входять у вашу потужність так само, як замовлені. Якщо імпортуєте більше, ніж маєте місця, відкриється перевищення зі звичайним пільговим періодом.