wildcar's place

Webmin custom command menu parameter

Mon, 14 Apr 2025 14:59:58 +0300

Webmin предлагает удобный веб-интерфейс для управления linux сервером
Одной из возможностей является функциональность пользовательских команд
Webmin custom command
Для заведения команды вводятся ее параметры, что запустить в командной строке, под каким пользователем и с какими параметрами
В качестве параметров может использоваться поле для ввода текста, опции, бинарный выбор
Одной из возможностей является меню
В качестве параметра для меню указывается имя текстового файла, в котором указаны опции меню
В документации по webmin указано, что в файле одна опция — это одна строка в файле, при этом первая часть строки — это сам параметр, который передается в команду, потом запятая, затем текстовое описание этого параметра, которое видит пользователь, как пункт меню
В реальности (актуально для версии Webmin 2.303), парсер файла ищет связки параметр — описание в файле, разделенные пробелом
И если в параметре уже есть пробелы, то его нужно заключить в кавычки
Для строк можно использовать # в начале строки как комментарий
Вот файл, который получился для occ команд nextcloud:

"maintenance:repair --include-expensive" "Maintenance repair all"
"db:add-missing-columns" "Add missing columns"
"db:add-missing-indices" "Add missing indices"
"app:list" "List of installed applications"
"maintenance:mode --off" "Switch off maintenance mode"
"update" "Proceed with update"

Сам парсер находится в исходном файле webmin \custom\custom-lib.pl и выглядит следующим образом:

# read_opts_file(file)
# Read the file containing possible menu options for a command
sub read_opts_file
{
local @rv;
local $file = $_[0];
if ($file !~ /^\// && $file !~ /\|\s*$/) {
local @uinfo = getpwnam($remote_user);
if (@uinfo) {
$file = "$uinfo[7]/$file";
}
}
my $h;
$h = "<" if ($file =~ /^\// && $file !~ /\|\s*$/);
open(FILE, "$h".$file);
while(<FILE>) {
s/\r|\n//g;
next if (/^#/);
if (/^"([^"]*)"\s+"([^"]*)"$/) {
push(@rv, [ $1, $2 ]);
}
elsif (/^"([^"]*)"$/) {
push(@rv, [ $1, $1 ]);
}
elsif (/^(\S+)\s+(\S.*)/) {
push(@rv, [ $1, $2 ]);
}
else {
push(@rv, [ $_, $_ ]);
}
}
close(FILE);
return @rv;
}

Wireguard server on Ubuntu

Sun, 30 Mar 2025 02:09:15 +0300

https://www.wireguard.com/quickstart/
Manual
https://git.zx2c4.com/wireguard-tools/about/src/man/wg.8

sudo apt install wireguard
wg genkey | tee server-privatekey | wg pubkey > server-publickey

~/wg/wg-server.conf

[Interface]
PrivateKey = yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk=
ListenPort = 51820
[Peer]
PublicKey = xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg= #client public key
AllowedIPs = 10.192.122.3/32

wg setconf wg0 ~/wg/wg-server.conf
ip link add dev wg0 type wireguard
ip address add dev wg0 10.60.10.1/24
ip link set up dev wg0

wg genkey | tee server-privatekey | wg pubkey > server-publickey
wg setconf wg0 /etc/wireguard/wg0.conf

Проверка доступности извне порта сервера (проверяется с клиентской машины)
nc -z -v -u 91.149.254.78 51820
Проверка, что TCP пакеты доходят до сервера (проверяется на сервере)
tcpdump -n -i eth0 port 51820
https://habr.com/ru/articles/709920/
https://losst.pro/ustanovka-wireguard-v-ubuntu
https://docs.vultr.com/how-to-install-wireguard-vpn-on-ubuntu-24-04

kvas DNS routing for keenetic router

Tue, 25 Mar 2025 13:49:19 +0300

Main wiki
https://github.com/qzeleza/kvas/wiki
Tags
https://github.com/qzeleza/kvas/blob/main/opt/etc/conf/tags.list
Проверка доменов сайта

window.domains = [...new Set(performance.getEntriesByType('resource').map(r => (new URL(r.name)).hostname))]; console.log(domains);

Очистка DNS windows

ipconfig /flushdns

Очистка DNS браузера

chrome://net-internals/#dns

Используемые DNS
powershell:

Get-DnsClientServerAddress

cmd:

cmd:

Добавить локальный host в DNS: /opt/etc/hosts

192.168.1.1 localserver

Перезапустить DNS

/opt/etc/init.d/S56dnsmasq restart

или

kvas update

Веб-приложение для сводных таблиц

Tue, 18 Mar 2025 17:36:37 +0300

https://www.webdatarocks.com/

Midnight Commander и редактор micro настройка

Tue, 18 Mar 2025 17:36:10 +0300

Для работы с терминальными сессиями удобно использовать Терминал Windows
Хорошо настраивается и имеет приятный вид и интерфейс
https://apps.microsoft.com/detail/9n0dx20hk701

Для удобства работы в MC в рамках терминала можно сделать следующие настройки:

Переход на папку выше через backspace:
Глобальные настройки сочетаний клавиш здесь:

/etc/mc/mc.keymap

Меняем

CdParentSmart = backspace

Smart имеется ввиду, что команда не будет срабатывать, если в строке команд есть текст
Подключаем редактор micro
https://micro-editor.github.io/index.html
Позволяет пользоваться клавиатурными командами Ctrl-C, Ctrl-V и т. д.
Позволяет использовать буфер обмена терминала — он будет прозрачен как в терминале, так и на хосте

Устанавливаем micro

sudo apt install micro xclip

Меняем редактор по умолчанию в mc

Находим куда установился micro

whereis micro

Отключаем в MC встроенный редактор
midnight-commander-nastroyka.png
Отключаем в MC встроенный редактор

Поменять настройку какой внешний редактор будет использовать MC можно разными способами

Вызываем команду

selected_editor

и выбираем нужный редактор, если нужного редактора в списке нет,

Редактируем файл настроек selected_editor

micro ~/.selected_editor

правим строку

SELECTED_EDITOR="/usr/bin/micro"

если пакет sensible-utils (куда входит selected_editor) недоступен,

Устанавливаем переменную среды EDITOR
в файл ~.bashrc добавляем строку:

EDITOR=/usr/bin/micro

Устанавливаем настройку буфера обмена на терминал и отключаем автокопирование в буфер выделения

В micro Ctrl-E

set clipboard terminal
set useprimary false

Устанавливаем выход из micro по клавише Esc

в файл ~/.config/micro/bindings.json добавить строку (если там уже есть комбинации строку нужно дописать к ним, поставив после последней запятую:

{
"Esc": "Quit"
}

Все настройки, указанные здесь, распространяются только на текущего пользователя и при запуске MC от имени root (sudo root) нужно настроить то же самое для root

ruTorrent и rtorrent

Tue, 18 Mar 2025 12:00:15 +0300

Основные странички:
ruTorrent
rtorrent

Установка yt-dlp на Ubuntu

Tue, 04 Mar 2025 22:54:00 +0300

https://github.com/yt-dlp/yt-dlp/wiki/Installation
yt-dlp позволяет скачивать видео с различных видеохостингов
The project is a fork of youtube-dl based on the now inactive youtube-dlc.

sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/bin/yt-dlp
sudo chmod a+rx /usr/bin/yt-dlp  # Make executable

Для обновления использовать:

sudo yt-dlp -U

Подключение WinSCP с root правами

Tue, 04 Mar 2025 11:40:29 +0300

https://winscp.net/eng/docs/faq_su
Узнать, где находится sftp-server можно командой

whereis sftp-server

With SFTP protocol, you can use SFTP server option on SFTP page of Advanced Site Settings dialog to execute SFTP binary under a different user. With OpenSSH server, you can specify:

sudo /usr/lib/sftp-server

Добавить в /etc/sudoers.d файл, скажем wildcar_sftp с содержимым:

username ALL=NOPASSWD: /usr/lib/sftp-server

Тюнинг Nextcloud

Tue, 04 Mar 2025 10:43:57 +0300

Советы по тюнингу Nextcloud, когда в общих сведениях о сервере выдаются ошибки и предупреждения:

Проверка безопасности и параметров
Для обеспечения безопасности и производительности важно, чтобы всё было настроено правильно. Чтобы убедиться в этом, мы выполняем некоторые автоматические проверки. Для получения дополнительной информации обратитесь к соответствующему разделу документации.
Были обнаружены ошибки конфигурации.

https://kurazhov.ru/nextcloud-tuning/#12
APCu not available for local cache
Изменить /etc/php/8.3/cli/php.ini

apc.enable_cli=1

Разрешённое максимальное значение использования памяти PHP ниже рекомендуемого значения 512 MB

sudo apt install php-fpm
sudo a2enmod proxy_fcgi setenvif
sudo a2enconf php8.3-fpm

Изменить /etc/php/8.3/fpm/php.ini
и /etc/php/8.3/apache2/php.ini

memory_limit = 512M

и перезапустить PHP и Apache

sudo systemctl restart php8.3-fpm
sudo systemctl reload apache2

Модуль PHP OPcache настроен неправильно
Изменить /etc/php/8.3/fpm/php.ini

opcache.enable=1
opcache.enable_cli=1
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=10000
opcache.memory_consumption=256
opcache.save_comments=1
opcache.revalidate_freq=1

и перезапустить PHP и Apache

sudo systemctl restart php8.3-fpm
sudo systemctl reload apache2

Установка Portainer для Docker

Sun, 02 Mar 2025 00:44:51 +0300

Выдержка из инструкций:
https://docs.portainer.io/start/install-ce/server/docker/linux
https://timeweb.cloud/tutorials/docker/ustanovka-i-ispolzovanie-portainer

Установка Portainer через Docker

mkdir ~/portainer 
cd ~/portainer 
cat > docker-compose.yml

Вставляем в файл следующие инструкции:

services:
  portainer:
    image: portainer/portainer-ce:lts
    container_name: portainer
    ports:
      - 8000:8000
      - 9443:9443
    volumes:
      - portainer_data:/data
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always
volumes:
    portainer_data:

Нажимаем Ctrl-C
Создаем том для хранения базы данных

sudo docker volume create portainer_data

sudo docker compose up -d

Установка Docker на Ubuntu

Fri, 28 Feb 2025 17:40:14 +0300

Выдержка из документации: https://docs.docker.com/engine/install/ubuntu/
Set up Docker’s apt repository.

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Install the latest version

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Основные команды Docker:
docker images — выводит список образов, которые загружаются или создаются на хосте Docker
docker pull — загружает образы из удалённого репозитория Docker Hub
docker run — запускает образ Docker в качестве контейнера
docker ps — выводит список всех контейнеров, запущенных на хосте Docker
docker start — запускает остановленный контейнер
docker stop — останавливает работающий контейнер
docker restart — перезапускает контейнер
docker rm — удаляет один или несколько контейнеров, которые уже остановлены
docker pull — загружает образы из удалённого репозитория Docker Hub

Пример вызова PHP приложения Nextcloud для настройки

Fri, 28 Feb 2025 17:02:45 +0300

Перейти в каталог где расположен Nextcloud (зависит от конкретной инсталляции)

cd /var/www/nextcloud

Выполнить команду вывода списка приложений Nextcloud

sudo -u www-data php occ app:list

Выполнить команду деактивирования приложения groupfolders

sudo -u www-data php occ app:disable groupfolders

Конфигурация сервера расположена в файле

/var/www/nextcloud/config/config.php

Путь к данным сервера в строке:

’datadirectory’ => ’/mnt/raid/nc-data’,

Лог сервера в файле

/mnt/raid/nc-data/nextcloud.log

Помогло при обновлении с версии 27 на 28, когда после всех 12 шагов обновления не загружалась основная страница с ошибкой:

Class OCA\\GroupFolders\\Helper\\LazyFolder contains 2 abstract methods and must therefore be declared abstract or implement the remaining methods (OCP\\Files\\Folder::searchBySystemTag, OCP\\Files\\FileInfo::getMetadata) at /var/www/nextcloud/apps/groupfolders/lib/Helper/LazyFolder.php#32

причиной была несовместимая версия приложения groupfolders
Перечень приложений Nextcloud https://apps.nextcloud.com/

Настройка микросервиса Imaginary для сервера Nextcloud

Fri, 28 Feb 2025 16:48:25 +0300

Первоначальная версия Imaginary (последняя 1.2.4 от 2020-08-12) лежит здесь, автор Tomas Aparicio
Наиболее свежий форк Imaginary (1.5.1. от 2022-08-20) найден здесь, автор ItalyPaleAle
Микросервис позволяет обеспечить быструю обработку картинок для получения миниатюр изображений
Подключался для использования с приложением Photos
Выдержка из инструкций:
https://okxo.de/speed-up-nextcloud-preview-generation-with-imaginary/
https://www.puddl.net/setting-preview-generation-service-nextcloud-24
Установка Imaginary через Docker

mkdir ~/imaginary
cd ~/imaginary
cat docker-compose.yml

Вставляем в файл следующие инструкции:

services:
  imaginary:
    image: ghcr.io/italypaleale/imaginary:master
    container_name: imaginary
    restart: always
    environment:
      - PORT=9000
    ports:
      - 9000:9000
    command: -concurrency 50 -enable-url-source -log-level debug

Нажимаем Ctrl-C

sudo docker compose up -d

Добавляем использование Imaginary в Nextcloud

sudo -u www-data php /var/www/nextcloud/occ config:system:set enabledPreviewProviders 0 --value="OC\Preview\Imaginary"
sudo -u www-data php /var/www/nextcloud/occ config:system:set preview_imaginary_url --value="http://127.0.0.1:9000"
sudo /etc/init.d/apache2 restart

Проверка, что Nextcloud использует Imaginary

sudo docker logs -f imaginary-imaginary-1

Настройка xdebug для PHPStorm

Tue, 09 Oct 2018 15:48:08 +0300

В файле настроек PHP (например,/etc/php/7.2/apache2/php.ini) добавляем где-нибудь рядом со строчкой включения модуля xdebug, примерно такой:

zend_extension = /usr/lib/php/20170718/xdebug.so

xdebug.remote_enable=on
xdebug.remote_host="192.168.10.2" ;реальный IP по которому сервер может подключиться к клиенту
xdebug.idekey="PHPSTORM"
xdebug.remote_log=/tmp/xdebug.log

;xdebug.remote_autostart=on ; можно поставить этот параметр, тогда xdebug  будет стартовать сам всегда, без использования всяких browser helpers вроде xdebug helper
;xdebug.remote_port=9000 ; такой порт стоит по умолчанию
;xdebug.remote_mode=req

xdebug helper

Установка xdebug для PHP

Fri, 28 Sep 2018 12:54:09 +0300

Дата актуальности 2018-10-09
Можно использовать

sudo apt-get install php-xdebug

Но скорее всего будет установлена устаревшая версия (на данный момент Version: 2.4.0-1)
Здесь подсказки как установить последнюю версию:
https://xdebug.org/wizard.php
Предложит установить 2.6.1
Копируем весь вывод phpinfo() в предложенное поле и анализируем его.
Xdebug installed: no
Server API: Apache 2.0 Handler
Windows: no
Zend Server: no
PHP Version: 7.2.10-0
Zend API nr: 320170718
PHP API nr: 20170718
Debug Build: no
Thread Safe Build: no
Configuration File Path: /etc/php/7.2/apache2
Configuration File: /etc/php/7.2/apache2/php.ini
Extensions directory: /usr/lib/php/20170718

Выполняем пошаговые инструкции:
Download xdebug-2.6.1.tgz

wget http://xdebug.org/files/xdebug-2.6.1.tgz

Unpack the downloaded file with

tar -xvzf xdebug-2.6.1.tgz

Run:

cd xdebug-2.6.1

Run:

phpize

See the FAQ if you don’t have phpize: Debian and Ubuntu users need to install the PHP development package with

sudo apt install php5-dev

, or

sudo apt install php7.2-dev

for PHP 7
PHP Api Version: 20170718
Zend Module Api No: 20170718
Zend Extension Api No: 320170718
Run:

./configure

Run:

make

Run:

cp modules/xdebug.so /usr/lib/php/20170718

Edit /etc/php/7.2/apache2/php.ini and add the line

zend_extension = /usr/lib/php/20170718/xdebug.so

Restart the webserver
phpinfo():

This program makes use of the Zend Scripting Language Engine:
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
    with Xdebug v2.6.1, Copyright (c) 2002-2018, by Derick Rethans

APT узнать версию пакета в репозитории

Fri, 28 Sep 2018 12:18:49 +0300

Обновить список пакетов в кэше

sudo apt-get update

Найти пакет по названию

sudo apt-cache search package_name

Вывести информацию о пакете

sudo apt-cache show package_name

Вывести только версию пакета

sudo apt-cache show package_name| grep -i version

Webmin PHP configuration

Fri, 28 Sep 2018 11:54:33 +0300

По умолчанию может выдаваться:
PHP Configuration
No PHP configuration files were found. Adjust the module configuration to set the correct path to the global PHP config file.

Module Config
PHP Configuration
No PHP configuration files were found. Adjust the module configuration to set the correct path to the global PHP config file.

Конфигурация модуля предлагает задать значения в следующем формате:
Global PHP configuration files
(In filename=description format)

/etc/php5/apache2/php.ini=Configuration for mod_php
/etc/php5/cgi/php.ini=Configuration for scripts run via CGI
/etc/php5/cli/php.ini=Configuration for command-line scripts

Где и какой версии у нас PHP можно узнать через phpinfo()

PHP Version 7.0.32-0ubuntu0.16.04.1
Loaded Configuration File/etc/php/7.0/apache2/php.ini

Меняем конфигурацию модуля:

/etc/php/7.0/apache2/php.ini=Configuration for mod_php
/etc/php/7.0/cgi/php.ini=Configuration for scripts run via CGI
/etc/php/7.0/cli/php.ini=Configuration for command-line scripts

Изменить программу редактирования изображений в Windows

Fri, 27 Jul 2018 17:56:38 +0300

Идем в раздел:

HKEY_CLASSES_ROOT\SystemFileAssociations\image\shell\edit\command

По умолчанию, там:

"%systemroot%\system32\mspaint.exe" "%1"

Меняем, например, на:

"%ProgramFiles%\paint.net\PaintDotNet.exe" "%1"

Источник
Перечень системных переменных среды окружения (пример: %ProgramFiles%) можно узнать с помощью команды set, запустив ее из утилиты командной строки cmd.exe
Источник
To set Microsoft Store paint.net a default image editor

Настройка Эгеи в Ubuntu

Fri, 20 Jul 2018 00:12:02 +0300

Инструкции по установке
https://blogengine.ru/help/

Нужно подключить модули:
Список модулей PHP:

php -m

Добавить модули gd и mbstring в php:

sudo apt-get install php-gd
sudo apt-get install php-mbstring

Включить модуль mod_rewrite в Apache:

sudo a2enmod rewrite

Если при переходе на сайт выдает ошибку не найден /install/
в файле конфигурации сайта, чтобы работал .htaccess:

<Directory /www/e2>
  AllowOverride All
</Directory>

Перезапускаем Апач

sudo /etc/init.d/apache2 restart