man

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 8)

📟 The global manual

man Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Man

📟 Привет. Меня зовут [NikolasMelui][nikolasmelui], я занимаюсь разработкой. В последнее время стал замечать, что с регулярностью примерно раз в 2-3 недели гуглю то, что делаю редко, но делаю. Чтобы перестать искать то, что уже находил, решил сделал свой мануал, в котором, со временем, будет всё. Пока на русском, но скоро будет перевод.

## VPS

### Первичное обновление системы и установка пакетов

```bash
sudo apt update && sudo apt upgrade && sudo apt autoclean && sudo apt autoremove
```

```bash
sudo apt install vim git tig curl inxi wget xclip thefuck tmux ranger build-essential checkinstall libssl-dev
```

### LOCALE

- Проверяем установленные локали

```bash
sudo locale -a
```

- Для корректного отображения русского и английского языков в системе нужно поставить недостающие локали (решается обычным реконфигом)

```bash
sudo dpkg-reconfigure locales
```

- Добавляем локаль в конфигурационный файл ***/etc/default/locale*** нужные локали:

```bash
sudo vim /etc/default/local
```

```bash
LANGUAGE=en_US.UTF-8
LC_ALL=en_US.UTF-8
LANG=en_US.UTF-8
LC_TYPE=en_US.UTF-8
```

### SSH_LOCAL

- На локальной машине заходим в

```bash
cd ~/.ssh
```

- Создаем новый ssh ключ для нашего сервера

```bash
ssh-keygen -t rsa -b 4096 -C "put-here-your-email"
```

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

```bash
vim ~/.ssh/config
```

### SSH_REMOTE

- Заходим на сервер по ssh от root юзера через ввод пароля

```bash
ssh root@yourserveradress.com
```

- Генерируем SSH ключ (для доступа в GitLab)

```bash
ssh-keygen -t rsa -b 4096
```

- Добавляем нового юзера (например с именем ```manager```) (чтобы не работать из под рута)

```bash
adduser manager
```

> Если что-то пошло не так, удаляем юзера manager и пересоздаем его

```bash
deluser manager
adduser manager
```

> В случае необходимости меняем пароль

```bash
passwd manager
```

- Добавляем юзера manager в группу админов

```bash
usermod -aG sudo manager
```

- Проверяем id юзера

```bash
id manager
```

- Логинимся юзером manager через sudo

```bash
sudo su - manager
```

- Создаем юзеру папку ssh

```bash
sudo mkdir ~/.ssh
```

- Определяем права доступа

```bash
chmod 700 ~/.ssh
```

- Создаем файл для авторизованных ключей

```~/.bash
ssh/authorized_keys
```

- Копируем с локальной машины публичный SSH ключ через утилиту ***ssh-copy-id***

```bash
ssh-copy-id -i ~/.ssh/projectname_manager_rsa.pub manager@yourserveradress.com
```

- Меняем права доступа на файл для авторизованных ключей

```bash
chmod 600 ~/.ssh/authorized_keys
```

- Перезагружаем ssh службу

```bash
sudo service ssh restart
```

- Выходим из сессии юзера и сессии рута, отключаемся от сервера и заходим по ssh с использованием ключа
- Заходим в конфиг файл и закрываем доступ для рута (и возможность заходить на сервер через введение пароля)

```bash
sudo nano /etc/ssh/sshd_config
```

> PermitRootLogin no
> PasswordAuthentication no

- Перезагружаем наш sshd процесс

```bash
sudo systemctl reload sshd
```

### FIREWALL

- Добавляем правило для нашего ssh соединения (нужно указать ваш порт)

```bash
sudo ufw allow 22
```

- Активируем firewall

```bash
sudo ufw enable
```

- Закрываем небезопасные порты (указываем нужные порты)

```bash
sudo ufw deny 3003
```

- Открываем безопасные порты (указываем нужные порты)

```bash
sudo ufw allow 80
```

### GIT

- Генерируем новый ssh ключ с почтой нашего проекта

```bash
ssh-keygen -t rsa -b 4096 “curproject@gmail.com”
```

- Запустим агента

```bash
eval $(ssh-agent -s)
```

- Добавим наш новый ключ в ssh agent

```bash
ssh-add ~/.ssh/curproject_rsa
```

- Внесём необходимые изменения в ssh config файл, чтобы не было проблем с доступом до социальной сети git (Github, Gitlab)

```bash
vim ~/.ssh/config
```

Host gitlab.com
  Preferredauthentications publickey
  IdentityFile ~/.ssh/curproject_rsa

- Копируем сгенерированный ssh ключ curproject_rsa.pub, после чего добавляем его в раздел Deploy Keys нужной нам социальной сети git

(Settings->Repository->Deploy Keys)

- Клонируем проект git в папку проектов

```bash
cd ~ && mkdir projects && cd projects && git clone git@gitlab.com:company/curproject.git
```

### FAIL2BAN

- Устанавливаем fail2ban и конфигурируем "локальную тюрьму"

```bash
sudo apt install fail2ban
```

- Конфигурируем fail2ban

```bash
sudo vim /etc/fail2ban/jail.local
```

[DEFAULT]
  maxretry = 5
  bantime = 86400
  action = firewallcmd-ipset
  [ssh]
  enable = true
  port = ssh
  filter = sshd
  action = iptables[name=ssh, port=ssh, protocol=tcp]
  logpath = /var/log/auth.log
  maxretry = 5
  findtime = 600

- Перезагружаем fail2ban службу

```bash
sudo systemctl reload fail2ban
```

> Посмотреть список забаненных адресов

```bash
sudo iptables -S
```

### ZSH

- Устанавливаем ZSH

```bash
sudo apt install zsh
```

- Устанавливаем ohmyzsh

```bash
curl -L http://install.ohmyz.sh | sh
```

- Определяем zsh как темринал по умолчанию

```bash
chsh -s /bin/zsh
```

- Скачиваем и устанавливаем тему spaceship (можно и другую, но зачем?)

```bash
git clone https://github.com/denysdovhan/spaceship-prompt.git $ZSH_CUSTOM/themes/spaceship-prompt
```

```bash
ln -s $ZSH_CUSTOM/themes/spaceship-prompt/spaceship.zsh-theme $ZSH_CUSTOM/themes/spaceship.zsh-theme
```

- Вносим необходимые изменения в ~/.zshrc файл

```bash
vim ~/.zshrc
```

```bash
  # Theme
  ZSH_THEME="spaceship"

# Configs Spaceship
  SPACESHIP_HOST_SHOW=true
  SPACESHIP_HOST_SUFFIX=' ssh '
  SPACESHIP_USER_SHOW=always
  SPACESHIP_USER_PREFIX=
  SPACESHIP_DIR_TRUNC_REPO=false
  SPACESHIP_DIR_TRUNC=0
  SPACESHIP_GIT_PREFIX=
  SPACESHIP_EXIT_CODE_SHOW=true
  SPACESHIP_PROMPT_ORDER=(
    host          # Hostname section
    user          # Username section
    dir           # Current directory section
    line_sep      # Line break
    git           # Git section (git_branch + git_status)
    package       # Package version
    node          # Node.js section
    php           # PHP section
    conda         # conda virtualenv section
    pyenv         # Pyenv section
    venv          # virtualenv section
    golang        # Go section
    docker        # Docker section
    kubecontext   # Kubectl context section
    exec_time     # Execution time
    line_sep      # Line break
    vi_mode       # Vi-mode indicator
    jobs          # Background jobs indicator
    exit_code     # Exit code section
    char          # Prompt character
  )

# Plugins
  plugins=(
    #ansible
    #ant
    autojump
    #aws
    #bower
    brew
    #cake
    #cargo
    catimg
    chucknorris
    colorize
    colored-man-pages
    command-not-found
    #composer
    #docker-compose
    #docker
    #dotenv
    #dotnet
    encode64
    extract
    git
    gitignore
    golang
    #gulp
    #helm
    #heroku
    history
    httpie
    jsontools
    #kubectl
    #laravel
  )
```

- Скачиваем файлы плагинов, которые не входят в базовую установку

```bash
bash < <(curl -s -S -L https://raw.githubusercontent.com/guiferpa/aterminal/master/installer.sh)
```

```bash
sudo apt (brew) install autojump
```

```bash
sudo apt (brew) install thefuck
```

```bash
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
```

```bash
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
```

```bash
git clone https://github.com/zsh-users/zsh-completions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-completions
```

### NODEJS (ubuntu)

- Проверяем, нет ли у нас старых версий nodejs

```bash
dpkg --get-selections | grep node
```

- Если есть - удалим их

```bash
sudo apt purge nodejs
```

- Скачиваем и установливаем nvm

```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash
```

- Добавляем путь до zsh shell файла в ~/.zshrc файл

```bash
 source $ZSH/oh-my-zsh.sh
 ```

- Делаем экспорт nvm настроек в ~/.zshrc файл

```bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
```

- Устанавливаем нужную нам версию nodejs

``` bash
nvm install --lts
```

### NGINX

- Устанавим nginx

```shell
sudo apt install nginx
```

- Проверяем его работоспособность

```shell
systemctl status nginx
```

- Создадим первый виртуальный хост (скопируем и изменим дефолтный конфиг файл)

```shell
sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/curproject.com
```

- Подготовим директорию для лог- и error- файлов и создадим эти файлы

```shell
sudo mkdir /var/log/nginx/curproject
```

```shell
sudo touch /var/log/nginx/curproject/access.log
```

```shell
sudo touch /var/log/nginx/curproject/error.log
```

- Настроим виртуальный хост

```shell

# SSL

server {
    listen 80;
    listen [::]:80;
    server_name curproject.com www.curproject.com;
    return 301 https://curproject.com$request_uri;
  }

server {
    listen 443 ssl http2;
    ssl_certificate /etc/letsencrypt/live/curproject.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/curproject.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
    server_name www.curproject.com.ru;
    return 301 https://curproject.com$request_uri;
  }

server {
    listen 443 ssl http2;
    ssl on;
    ssl_certificate /etc/letsencrypt/live/curproject.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/curproject.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
    server_name curproject.com;
    access_log /var/log/nginx/curproject/access.log;
    error_log /var/log/nginx/curproject/error.log;

location / {
      root /local/projects/curproject.com;
      index index.html;
      try_files $uri $uri/ =404;
    }
    
    location /nodejs/ {
      proxy_pass http://0.0.0.0:0000;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_connect_timeout 120;
      proxy_send_timeout 120;
      proxy_read_timeout 180;
    }

location /secure/ {
      proxy_pass http://0.0.0.0:0000/secure/;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_connect_timeout 120;
      proxy_send_timeout 120;
      proxy_read_timeout 180;
      auth_basic "Unauthorized";
      auth_basic_user_file /etc/nginx/.htpasswd/curproject.com;
    }
  }
```

```shell

# Without SSL

server {
    server_name www.curproject.com;
    return 301 http://curproject.com$request_uri;
  }

server {
    listen 80;
    server_name curproject.com;
    access_log /var/log/nginx/curproject/access.log;
    error_log /var/log/nginx/curproject/error.log;

location / {
      root /local/projects/curproject.com;
      index index.html;
      try_files $uri $uri/ =404;
    }

location /nodejs/ {
      proxy_pass http://0.0.0.0:0000;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_connect_timeout 120;
      proxy_send_timeout 120;
      proxy_read_timeout 180;
    }

- Проксируем по регулярному выражению
```
  # ~* - содержит без учета регистра
  location ~* /api/v(\d+)/ {
    # example.com/api/v2/endpoint -> http://0.0.0.0:0000/api/v2/enpoint
    proxy_pass http://0.0.0.0:0000$uri;
  }
```

- Добавим симлинк созданного виртуального хоста (активиурем виртуальный хост)

```shell
sudo ln -s /etc/nginx/sites-available/curproject.com /etc/nginx/sites-enabled/
```

- Удалим симлинк на дефолтный конфиг (деактивируем дефолтный виртуальный хост)

```shell
sudo rm /etc/nginx/sites-enabled/default
```

- Добавим некоторые важные настройки nignx в ***/etc/nginx/nginx.conf***

```shell
server_names_hash_bucket_size: 64;
```

- Добавим наше доменное имя в файл ***/etc/hosts*** (если это необходимо)

```shell
127.0.0.1 curproject.com
```

- Если нам необходимы SSL сертификаты - установим certbot (ставим через snap, при этом удаляем старого через apt, если он был)

```shell
sudo snap install core
sudo snap refresh core
sudo apt remove certbot
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
```

- Создадим сертификаты для выбранных доменных имен ***(доменное имя с www и без него)***

```shell
sudo certbot --nginx -d curproject.com -d www.curproject.com
```

- Зададим certbot джобу на автопродление сертификатов и проверим, что она работает

```shell
sudo systemctl status snap.certbot.renew.service
sudo certbot renew --dry-run
```

### PM2

- Устанавливаем PM2

```bash
npm i -g pm2
```

- Запускаем проект

```bash
pm2 start ecosystem.config.js
```

***https://pm2.keymetrics.io/***

### MONGO

- Устанавливаем mongo

```bash
sudo apt install mongodb
```

- Проверяем статус

```bash
sudo systemctl status mongodb
```

- Создаём нового root юзера

```bash
mongo
```

```bash
use admin
```

```bash
db.createUser({user:"root", pwd:”rootpassword”, roles:[{role:”root”, db:"admin”}]})
```

- По умолчанию монга открыта для всех, добавим обязательный флаг —auth

```bash
sudo vim /lib/systemd/system/mongodb.service
```

ExecStart=/usr/bin/mongod --auth --unixSocketPrefix=${SOCKETPATH} --config ${CONF} $DAEMON_OPTS

- Перезапустим службы и проверим их статус

```bash
systemctl daemon-reload
```

```bash
sudo systemctl restart mongodb
```

```bash
sudo systemctl status mongodb
```

- Зайдем в mongo от имени созданного root

```bash
mongo -u "root" -p --authenticationDatabase "admin”
```

- Создадим и перейдем в нужную нам базу

```bash
use curproject_db
```

- Создадим нового юзера-админа для только что созданной базы

```bash
db.createUser( { user: “curproject_manager", pwd: “curpassword”, roles: [ { role: "readWrite", db: “curproject_db" } ] } )
```

- Создадим папку для резервных копий

```bash
mkdir /home/curuser/backups/curproject
```

- Сделаем копию и проверим её содержимое

```bash
mongodump -u curproject_manager -p curprojectpassword --db curproject_db --out /home/curuser/backups/curproject`date +"%m-%d-%y"`
```

- Создадим задачу в cron для автоматических бэкапов каждую ночь

```bash
sudo crontab -e
```

```bash
3 3 * * * mongodump -u curproject_manager -p curprojectpassword --db curproject_db --out  /home/curproject_manager/backups/curproject/curproject`date +"%m-%d-%y"`
```

- И добавим задачу, которая будет чистить диск от старых бэкапов

```bash
3 1 * * * find /home/curproject_manager/backups/curproject/ -mtime +7 -exec rm -rf {} \;
```

### POSTGRESQL

- Устанавливаем postgres

```bash
sudo apt install postgresql
```

- Проверяем статус

```bash
sudo systemctl status postgresql
```

- Проверяем прослушиваемые порты postgres

```bash
netstat -nlt
```

- Входим в psql от имени postgres

```bash
sudo -U postgres psql
```
- Создаем новую базу

```bash
CREATE DATABASE db_name;
```

- Создаем нового юзера с паролем

```bash
CREATE USER user_name WITH ENCRYPTED PASSWORD 'password';
```

- Присваиваем юзера к базе и даём ему все права

```bash
GRANT ALL PRIVILEGES ON DATABASE db_name TO user_name;
```

- При необходимости удаляем базу

```bash
DROP DATABASE db_name;
```

- Создаем дамп базы

```bash
sudo -U postgres pg_dump db_name > db_name_dump.bak
```

- Создаем дамп базы в бинарном формате

```bash
pg_dump -U USER_NAME -Fc -f /PATH/TO/FILE/DUMP.tar.gz DATABASE_NAME
```

- Восстанавливаем базу из дампа

```bash
sudo -U postgres psql -d db_name -f db_name_dump.bak
```

- Восстанавливаем базу из бинарного дампа игнорируя параметры привилегий

```bash
pg_restore -U USER_NAME -Fc --no-acl -d DATABASE_NAME /PATH/TO/FILE/DUMP.tar.gz
```

- Если необходимо, открываем доступы для всех коннекшенов в конфиг файле **/var/lib/pgsql/<version>/data/postgresql.conf**

```bash
listen_addresses = '*'
```

- Также, если необходимо, добавляем наш айпи с конфигами в разрешенные хосты в конфиг файле **/var/lib/pgsql/<version>/main/pg_hba.conf**

```bash
host    all             my_login         10.0.0.1/32            md5
```

### Новое разрешение экрана в Ubuntu

```bash
xrandr --newmode "2560x1080"  230.37  2560 2728 3000 3440  1080 1081 1084 1118  -HSync +Vsync
```

```bash
xrandr --addmode HDMI-2 2560x1080
```

```bash
xrandr --output HDMI-2 --mode 2560x1080
```

#### Bluetooth Ubuntu:

- Заупскаем bluetoothctl

```bash
sudo bluetoothctl
```

- Включаем устройство (нужно убедиться, что оно установлено)

```bluetoothctl
power on
```

- Регистрируем агента

```bluetoothctl
agent agent_name
```

- Делаем агента агентом по-умолчанию

```bluetoothctl
default-agent
```

- Даём устройству возможность создавать пару

```bluetoothctl
pairable on
```

- Включаем сканирование (ищем устройства, с которыми можно сделать пары)

```bluetoothctl
scan on
```

- Добавляем найденное сканированием устройство в "доверенные" (для обращения к устройству нужно использовать его MAC-адрес)

```bluetoothctl
trust 28:C6:3F:96:CE:12
```

- Создаем с устройством пару

```bluetoothctl
pair 28:C6:3F:96:CE:12
```

#### License

MIT License

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.

**From developers 2 developers.**
[NikolasMelui][nikolasmelui]

[//]: # "These are reference links used in the body of this note and get stripped out when the markdown processor does its job. There is no need to format nicely because it shouldn't be seen. Thanks SO - http://stackoverflow.com/questions/4823468/store-comments-in-markdown-syntax"
[nikolasmelui]: https://github.com/NikolasMelui

man

man Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

man

man Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README