269 lines
16 KiB
HTML
269 lines
16 KiB
HTML
<!DOCTYPE html>
|
||
<html>
|
||
<head>
|
||
<title>CAI CP: Help</title>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<link rel="stylesheet" href="../../css/help.css" type="text/css" />
|
||
</head>
|
||
<body>
|
||
<nav class="hidden">
|
||
<ul id="menu_toc">
|
||
<li id="mnu_start"><div class="div_toc mnu_selected">Советы по использованию</div><hr></li>
|
||
<li id="mnu_sys_req"><div class="div_toc">Системные требования</div><hr></li>
|
||
<li id="mnu_setup"><div class="div_toc">Настройка</div><hr>
|
||
<ul>
|
||
<li id="mnu_security"><div class="div_toc">Безопасность</div><hr></li>
|
||
</ul>
|
||
</li>
|
||
<li id="mnu_about"><div class="div_toc">О панели управления</div></li>
|
||
</ul>
|
||
</nav>
|
||
<article id="art_start" class="hidden">
|
||
<h1>Советы по использованию</h1>
|
||
<ul>
|
||
<li>Табличные виджеты можно распахнуть на весь экран двойным
|
||
щелчком по заголовку.</li>
|
||
<li>Для переключения по информационным блокам используйте
|
||
следующие комбинации клавиш:
|
||
<ul>
|
||
<li><i>Ctrl + 1</i>: Система</li>
|
||
<li><i>Ctrl + 2</i>: Пульс системы</li>
|
||
<li><i>Ctrl + 3</i>: Файловое хранилище</li>
|
||
<li><i>Ctrl + 4</i>: Сеть</li>
|
||
<li><i>Ctrl + 5</i>: SMB</li>
|
||
<li><i>Ctrl + Влево</i>: Предыдущий блок</li>
|
||
<li><i>Ctrl + Вправо</i>: Следующий блок</li>
|
||
</ul>
|
||
Также вы можете переключаться между блоками, проведя влево
|
||
или вправо по заголовку на устройствах с сенсорным экраном.
|
||
<hr>
|
||
<ul>
|
||
<li><i>Ctrl + F1</i>: Справка</li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</article>
|
||
<article id="art_sys_req" class="hidden">
|
||
<h1>Системные требования</h1>
|
||
<p>Ядро системы использует следующие команды и утилиты:</p>
|
||
<ul>
|
||
<li>gawk (GNU awk)</li>
|
||
<li>grep</li>
|
||
<li>hddtemp</li>
|
||
<li>lsb-release</li>
|
||
<li>sed</li>
|
||
<li>smartmontools (smartctl)</li>
|
||
<li>sysstat (iostat)</li>
|
||
<li>php7</li>
|
||
</ul>
|
||
<p>
|
||
Различные приложения могут требовать наличие других программ и утилит.
|
||
</p>
|
||
</article>
|
||
<article id="art_setup" class="hidden">
|
||
<h1>Настройка</h1>
|
||
<p>Для мониторинга S.M.A.R.T. и температуры дисков требуется
|
||
разрешить выполнение smartctl и hddtemp веб-сервером. Для этого
|
||
запустите редактор sudo командой visudo и добавьте в раздел User
|
||
privilege specification следующие строки:
|
||
<pre>
|
||
wwwrun ALL=NOPASSWD: /usr/sbin/smartctl
|
||
wwwrun ALL=NOPASSWD: /usr/sbin/hddtemp
|
||
</pre>
|
||
</p>
|
||
<p>Для мониторинга ресурсов SMB требуется разрешить выполнение
|
||
smbstatus веб-сервером. Для этого запустите редактор sudo
|
||
командой visudo и добавьте в раздел User privilege specification
|
||
следующие строки:
|
||
<pre>
|
||
wwwrun ALL=NOPASSWD: /usr/bin/smbstatus
|
||
</pre>
|
||
</p>
|
||
<p>
|
||
Конфигурация панели управления задаётся в файле /system/json/settings.json.<br>
|
||
Параметры:
|
||
<table class="tbl_wide">
|
||
<tr class="tbl_header">
|
||
<td>Параметр</td>
|
||
<td>Возможные значения</td>
|
||
<td>Описание</td>
|
||
</tr>
|
||
<tr>
|
||
<td>lang</td>
|
||
<td>ru<br>en<br>...</td>
|
||
<td>Язык по умолчанию. Может быть указан один из
|
||
доступных языков.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td>langs</td>
|
||
<td>"en" : "English"<br>
|
||
"ru" : "Русский"<br>
|
||
...
|
||
</td>
|
||
<td>Доступные языки.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>dim_on_create</td>
|
||
<td>true<br>false</td>
|
||
<td>Виджеты отображаются полупрозрачными пока не
|
||
загрузятся данные.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>check_files_rights</td>
|
||
<td>true<br>false</td>
|
||
<td>При запуске проводится проверка правильности
|
||
установленных прав на файлы и каталоги.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>check_hdd_temp_interval</td>
|
||
<td>0 .. 86400</td>
|
||
<td>Интервал (в секундах) проверки температуры жёстких
|
||
дисков.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>check_smart_interval</td>
|
||
<td>0 .. 86400</td>
|
||
<td>Интервал (в секундах) проверки состояния S.M.A.R.T.
|
||
жёстких дисков.</td>
|
||
</tr>
|
||
</table>
|
||
</p>
|
||
<p>
|
||
Список загружаемых приложений находится в файле /system/apps/apps.json.
|
||
Панель управления проверяет зависимости приложений и отключает
|
||
те, что не могут быть запущены на данном сервере. Если вы хотите
|
||
принудительно отключить какое-либо приложение, удалите строку
|
||
с его названием из данного файла.
|
||
</p>
|
||
</article>
|
||
<article id="art_security" class="hidden">
|
||
<h1>Безопасность</h1>
|
||
<ol>
|
||
<li><p>Назначьте владельцем файлов и каталогов wwwrun:www, всем
|
||
каталогам и файлам .sh назначьте права по маске 550,
|
||
остальным файлам - 440.</p>
|
||
<p>Если хотите иметь возможность управлять некоторыми
|
||
параметрами из веб-интерфейса, установите маску 640 файлу
|
||
/system/json/settings.json.</p>
|
||
<p>Для этого выполните следующие команды:<br>
|
||
<code>
|
||
$ chown -R wwwrun:www /path/to/base/dir<br>
|
||
$ chmod 440 $(find /path/to/base/dir -type f)<br>
|
||
$ chmod 550 $(find /path/to/base/dir -type d)<br>
|
||
$ chmod 550 $(find /path/to/base/dir -type f | grep .sh$)<br>
|
||
$ chmod 640 /path/to/base/dir/system/json/settings.json<br>
|
||
$ chmod 640 /path/to/base/dir/system/apps/apps.json
|
||
</code>
|
||
</p>
|
||
</li>
|
||
<li>Запретите доступ через веб к файлам с расширением .sh, для
|
||
этого в конфигурационный файл Apache в блок
|
||
<pre><span><</span>Directory><span><</span>/Directory></pre>
|
||
добавьте следующие строки:
|
||
<pre>
|
||
<span><</span>FilesMatch "\.(sh)$">
|
||
Require all denied
|
||
<span><</span>/FilesMatch>
|
||
</pre>
|
||
</li>
|
||
<li>Установите пароль на доступ к панели управления. Пример для
|
||
настройки базовой аутентификации: с помощью утилиты htpasswd
|
||
(входит в комплект сервера Apache) создайте содержащий пароль
|
||
файл .htpasswd. В конфигурационный файл Apache добавьте в блок
|
||
<pre><span><</span>Directory><span><</span>/Directory></pre> следующие строки:
|
||
<pre>
|
||
AuthName "Restricted zone"
|
||
AuthType Basic
|
||
AuthUserFile [Путь к файлу .htpasswd]
|
||
Require valid-user
|
||
</pre>
|
||
<p>После этого перезагрузите сервер Apache.</p>
|
||
<p>
|
||
Обратите внимание, что в рассмотренном случае используется
|
||
базовая аутентификация, при её использовании пароль
|
||
передаётся в открытом виде, для защиты передаваемой
|
||
информации настройте доступ по протоколу HTTPS.
|
||
</p>
|
||
</li>
|
||
<li><p>Если хотите включить возможность перезагрузки и отключения
|
||
сервера, следует добавить пользователя wwwrun в sudoers.
|
||
Будьте осторожны с данной возможностью!</p>
|
||
<p>Запустите <code># visudo</code> и добавьте следующую
|
||
строку в блок "User privilege specification":
|
||
<code>wwwrun ALL=NOPASSWD: /sbin/shutdown</code>
|
||
</p>
|
||
</li>
|
||
</ol>
|
||
</article>
|
||
<article id="art_about" class="hidden">
|
||
<h1>О панели управления</h1>
|
||
<div class="help_title">CAI CP</div>
|
||
<div class="help_ver">Версия <span class="span_ver">_._</span> от <span class="span_ver_date">__.__.____</span></div>
|
||
<div>Автор: <span class="span_author_ru">Александр Чебыкин</span></div>
|
||
<div>Лицензия: MIT
|
||
<div id="div_license" class="scrollable">
|
||
<pre>
|
||
Лицензия MIT
|
||
------------
|
||
|
||
Copyright (c) 2016-2017, Александр Чебыкин
|
||
|
||
Данная лицензия разрешает лицам, получившим копию данного программного
|
||
обеспечения и сопутствующей документации (в дальнейшем именуемыми
|
||
«Программное Обеспечение»), безвозмездно использовать Программное Обеспечение
|
||
без ограничений, включая неограниченное право на использование, копирование,
|
||
изменение, слияние, публикацию, распространение, сублицензирование и/или
|
||
продажу копий Программного Обеспечения, а также лицам, которым предоставляется
|
||
данное Программное Обеспечение, при соблюдении следующих условий:
|
||
|
||
Указанное выше уведомление об авторском праве и данные условия должны быть
|
||
включены во все копии или значимые части данного Программного Обеспечения.
|
||
|
||
ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО
|
||
ГАРАНТИЙ, ЯВНО ВЫРАЖЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ ГАРАНТИИ ТОВАРНОЙ
|
||
ПРИГОДНОСТИ, СООТВЕТСТВИЯ ПО ЕГО КОНКРЕТНОМУ НАЗНАЧЕНИЮ И ОТСУТСТВИЯ НАРУШЕНИЙ,
|
||
НО НЕ ОГРАНИЧИВАЯСЬ ИМИ. НИ В КАКОМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ
|
||
ОТВЕТСТВЕННОСТИ ПО КАКИМ-ЛИБО ИСКАМ, ЗА УЩЕРБ ИЛИ ПО ИНЫМ ТРЕБОВАНИЯМ, В ТОМ
|
||
ЧИСЛЕ, ПРИ ДЕЙСТВИИ КОНТРАКТА, ДЕЛИКТЕ ИЛИ ИНОЙ СИТУАЦИИ, ВОЗНИКШИМ ИЗ-ЗА
|
||
ИСПОЛЬЗОВАНИЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ ИЛИ ИНЫХ ДЕЙСТВИЙ С ПРОГРАММНЫМ
|
||
ОБЕСПЕЧЕНИЕМ.
|
||
|
||
-------------------------------------------------------------------------------
|
||
|
||
MIT License
|
||
-----------
|
||
|
||
Copyright (c) 2016-2017, Alexander I. Chebykin
|
||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
of this software and associated documentation files (the "Software"), to deal
|
||
in the Software without restriction, including without limitation the rights
|
||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
copies of the Software, and to permit persons to whom the Software is
|
||
furnished to do so, subject to the following conditions:
|
||
|
||
The above copyright notice and this permission notice shall be included in
|
||
all copies or substantial portions of the Software.
|
||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||
THE SOFTWARE.
|
||
</pre>
|
||
</div>
|
||
</div>
|
||
<p>Данный продукт частично основан на
|
||
<a href="https://github.com/afaqurk/linux-dash" target="_blank">
|
||
Linux Dash
|
||
</a>.
|
||
</p>
|
||
</article>
|
||
<script src="../../js/help.js"></script>
|
||
</body>
|
||
</html>
|